***************************************
*                                     * 
*   OnQueue(TM)                       *
*                                     *
*   The Dedicated Network Task Server *
*                                     *
*   Installation and Users Guide      *
*                                     *
***************************************

NOTE:
THIS IS AN ASCII, TEXT-ONLY VERSION OF
THE ORIGINAL ONQUEUE MANUAL.  NO FIGURES
ARE INCLUDED, ALTHOUGH ALL REFERENCES TO
FIGURES AND PAGE NUMBERS IN THE ORIGINAL
MANUAL ARE RETAINED.

Notice
 NetPlus Software, Inc. 1991-1994. 
All rights reserved.
NetPlus Software, Inc.
47 Wake Robin Road
Sudbury, MA 01776-1771
Tel:    (508) 443-6043
Fax:    (508) 443-0638
NetPlus Software, Inc. reserves the 
right to make improvements to this
manual and the product it describes at 
any time and without further notice.
This manual is copyrighted, and all 
rights are reserved.  No part of this 
manual or the products it describes 
may be reproduced by any means or 
in any form, without prior written 
consent from NetPlus Software, Inc.
Printed in the U.S.A.
OnQueue is a trademark of NetPlus 
Software, Inc.
IBM is a registered trademark of 
International Business Machines, Inc.
Novell and NetWare are registered 
trademarks of Novell, Inc.
Portions of this program 
Copyright (C) 1983-1992 Novell, Inc.  
All Rights Reserved.
REV OQ5-9409


**********************************
Table of Contents
**********************************

OPERATION OVERVIEW & TERMINOLOGY       			 1
INTRODUCTION   						 1
What Is Covered In This Guide? 				 1
What Is Required?      					 1
WHY DO I NEED ONQUEUE?					 2
HOW DOES ONQUEUE WORK?  				 2
HOW DO I SUBMIT A TASK TO THE ONQUEUE TASK SERVER?	 3
DESIGNATING A WORKSTATION AS A DEDICATED TASK
SERVER                                         		 5
EXECUTION OF TASKS BY ONQUEUE   			 5
UTILIZING MULTIPLE ONQUEUE TASK SERVERS 		 5
CONCEPTS AND TERMINOLOGY          			 6
OnQueue - The Dedicated Task Server   		 	 6
OnQueue-M - with Multiple File Server Support  		 6
OnQueue System 						 7
Task   							 7
Task Queue    						 7
Task Queue Operator    					 8
Task Queue User						 8
TASKCON							 8
INSTALLING THE ONQUEUE SOFTWARE				 10
MAKING BACKUP COPIES OF THE ONQUEUE MASTER 
DISKETTE                                       		 10
Instructions for a Single Floppy Drive System  		 10
Instructions for a Dual Floppy Drive System    		 11
INSTALLATION  						 12
Default Installation   					 13
Custom Installation    					 14
Additional Server Installation 				 16
Update Installation    					 18
OnQueue-M Additional Installation Instructions 		 19
BOOTING AN ONQUEUE TASK SERVER 				 21
USING TASKCON - THE ONQUEUE TASK CONSOLE 
PROGRAM		       					 24
MENU OPERATION 						 24
TASKCON KEY ASSIGNMENTS					 25
TASKCON DOS COMMAND LINE OPERATION    			 27
Examples       						 28
QUEUE MANAGEMENT       					 30
QUEUE MANAGEMENT RIGHTS					 30
QUEUE CREATING AND DELETING    				 31
Selecting a Queue      					 31
THE QUEUE INFORMATION MENU     				 33
Current Queue Entries  					 33
Submitting a Task to a Queue   				 33
Deleting a Task in a Queue     				 34
Viewing Information about a Task       			 34
Current Queue Status   					 36
Currently Attached Task Servers				 37
Assigning Queue Operators      				 37
Assigning Queue Users  					 37
Removing Queue Operators       				 37
Removing Queue Users   					 38
Restricting Task Execution by a Queue  			 39
TASK SERVER MANAGEMENT 					 42
TASK SERVER MANAGEMENT RIGHTS  				 42
TASK SERVER CREATING AND DELETING      			 42
Selecting a Task Server					 45
THE TASK SERVER INFORMATION MENU       			 45
Assigning Queues to a Task Server      			 46
Deleting Queues from a Task Server     			 47
Viewing the Status of a Task Server    			 47
Restricting Task Execution by a Task Server    		 49
Assigning File Server to be Serviced by a Task Server    49
Deleting File Server from the File Servers to be Serviced      
							 51
Assigning a Security Equivalence to a Task Server        51
Deleting a Security Equivalence from a Task Server       52
THE TASK SERVER ENVIRONMENT    				 55
HOW A TASK IS EXECUTED 					 55
DOS ENVIRONMENT VARIABLES      				 55
DOS ENVIRONMENT VARIABLES IN BATCH FILES       		 58
LOCAL DRIVES   						 58
NETWORK PRINTING       					 58
TASK SERVER PERIPHERALS					 59
SUBMITTING TASKS WITH COMMAND.COM      			 60
EXAMPLE ENVIRONMENT SETUPS     				 60
Example 1 - Compiler Located on the Task Server		 61
Example 2 - Compiler Located on Network File Server      62
PROBLEMS?      						 64
FINAL CHECKLIST						 64
TROUBLESHOOTING TIPS   					 64
Troubleshooting the Task Server				 64
Troubleshooting the Software   				 64
Installing a Task Server when Accounting is ON 		 66
Troubleshooting Printing Problems      			 66
APPENDICES     						 68
APPENDIX A - SPECIFICATIONS    				 68
APPENDIX B - ENVIRONMENT VARIABLES     			 68
OnQueue Task Server Environment Variables      		 68
User Workstation Environment Variables 			 69
APPENDIX C - ONQUEUE INSTALLATION ALTERNATIVES	         71
Installing OnQueue on a Floppy Based Workstation         71
Installing OnQueue on a Diskless Workstation   		 72
APPENDIX D - ONQUEUE SOFTWARE REMOVAL  			 74
APPENDIX E - ERROR CODES       				 74
OnQueue Task Server Error Codes				 76
INDEX 							 88
FIGURES 
FIGURE 1        3
FIGURE 2        18
FIGURE 3        18
FIGURE 4        26
FIGURE 5        27
FIGURE 6        29
FIGURE 7        32
FIGURE 8        33
FIGURE 9        35
FIGURE 10       36
FIGURE 11       37
FIGURE 12       39



**********************************
Operation Overview & Terminology
**********************************

Introduction
What Is Covered In This Guide?
This guide makes it possible to install and run the OnQueue*
system components and presents the following:
*       Required hardware and software
*       Operation overview and terminology
*       Default and custom software installations
*       Installing multiple Task Servers
*       Booting an OnQueue Task Server
*       TASKCON menu operation
*       Queuing tasks via menu or command
*       Queue and Task Server management
*       Task Server environment
*       Final checklist and troubleshooting
*       Technical appendices


**********************************
What Is Required?
**********************************

Make sure that you have the following hardware 
and software components before starting the installation:
       Novell NetWare (Release 2.2, 3.X, 4.X))
       IBM PC compatible Novell Workstation and 
       hard drive, c: & 1.44MB -3 1/2 " floppy drive

See the Appendix, OnQueue Installation Alternatives to 
install on a floppy based, or diskless workstation.

       Blank diskette for making backup of master diskette
       DOS (3.1 or higher) and DOS DISKCOPY
       OnQueue Master Program Diskette (provided)


**********************************
Why do I Need OnQueue?
**********************************

Personal computer users normally can 
execute only a single program at a time.  
While some facilities exist to suspend one 
program and work in another, one program 
cannot be actively running while a user runs 
another.  OnQueue solves this problem for 
NetWare users.  OnQueue allows a NetWare 
user to send a program to another workstation 
on the network for execution.  This workstation, 
the OnQueue Task Server,  is dedicated by the 
OnQueue program to executing "tasks" sent to it 
by NetWare users.  In fact, all programs that do not 
require interaction with the NetWare user during 
execution can be carried out and expedited by an 
OnQueue installation.  Programs that do require active 
user input can be submitted by using any popular 
keyboard stuffer.  Similar to mainframe-style batch 
processing, jobs can be scheduled to run while you 
do other work.  Jobs can be scheduled to be executed 
once, daily, weekly, monthly, or by specified intervals.


************************************
How does OnQueue Work?
************************************

Users can submit programs for execution without 
waiting for OnQueues dedicated Task Server to be 
available.  Each user can submit multiple tasks for 
immediate or delayed execution.  The first task in a 
queue is the first one executed.  When a task is completed, 
OnQueue sends a message (optional) to the user that 
their task is done.  The Task Server supports 25 queues.  
Queues can be assigned different priorities if favored 
execution is needed in a network.  Tasks submitted by 
users assigned to a high priority queue are executed 
before tasks in low priority queues.


****************************************
How do I Submit a Task to the OnQueue Task Server?
****************************************

Figure 1 shows how an OnQueue user submits a task to an 
OnQueue queue for execution.  The queue is serviced by an 
OnQueue Task Server (a dedicated Novell workstation).  In 
order to submit a task, the user runs the OnQueue 
workstation task program, TASKCON, by a menu system or, 
directly by TASKCON command line arguments.  Task 
examples include data transfers, job scheduling, database 
searches, compilations, resource sharing, and mainframe 
style batch processing.
 
Figure 1


*****************************************
Designating a Workstation as a Dedicated Task Server
*****************************************

Any PC compatible Novell workstation on your network 
can be used as an OnQueue Task Server, but faster 
machines are best.  They allow very high speed task 
processing by the OnQueue Task Server.  The workstation 
becomes a dedicated Task Server once the OnQueue 
software is installed onto the workstation and run.


************************************
Execution of Tasks by OnQueue
************************************

OnQueue periodically checks all assigned queues 
for submitted tasks to run.  High priority queues are 
checked first.  When OnQueue finds a task to run, it 
gets the task information from the queue and executes 
the task.  OnQueue executes the task with the same 
environment and NetWare rights and security that the user 
had at the time they submitted the task.  This ensures that 
the task is executed properly.  When a task is submitted by 
a user, in addition to storing the user's capture settings, the 
Printer Setup Buffer & Printer Reset Buffer strings, if 
specified, are also stored.  During task execution, these 
are restored so that any printing will use the appropriate 
strings.


************************************
Utilizing Multiple OnQueue Task Servers
************************************

Several copies of OnQueue may be purchased in 
order to install multiple Task Servers on the same 
network.  This provides the most flexibility for 
processing tasks on large networks.  Additional copies 
of OnQueue may b*e added as your network grows.
Each OnQueue Task Server can be assigned to one or more 
queues and only processes tasks in its assigned queues.  
Queues are created, configured and prioritized by the 
network Supervisor using the Taskcon program.  In 
general, there are two basic queue configurations, 
depending on the needs of your network.
o       One configuration sets up a single 
	queue that is serviced by all OnQueue 
	Task Servers.  Queued tasks are executed in order, 
	by the next available server.
o       The other configuration sets up several queues.  
	Each queue has a set of users assigned to it.  
	OnQueue Task Servers service their assigned 
	queues in order of queue priority.


************************************
Concepts and Terminology
************************************

************************************
OnQueue - The Dedicated Task Server
************************************
A dedicated Task Server is any IBM PC compatible 
Novell workstation devoted to executing tasks sent 
by OnQueue users.  The Task Server examines its 
assigned queues, executes the next available task, 
and notifies the user who submitted the task when it 
is complete.
************************************
OnQueue-M - with Multiple File Server Support
************************************
OnQueue-M can be installed to support multiple 
NetWare File Servers.  Two modes of operation are 
possible.  In the first, OnQueue-M services queues 
on several File Servers, while executing tasks and data 
from the same File Server.  In the second, OnQueue-M 
can execute tasks and data across different File Servers.  
The advantage that this offers is the ability to run a task 
that uses, for example, data stored on one NetWare File 
Server with an application installed on a different NetWare 
File Server.  If you need multiple NetWare File Server 
support you should purchase OnQueue-M, or upgrade 
from your current OnQueue to OnQueue-M.
************************************
OnQueue System
************************************
When installed properly on a Novell Network, the 
OnQueue system consists of several components 
including:  dedicated OnQueue Task Server(s); 
Task Queue(s) located on the NetWare Server; and 
the OnQueue Task Console Program, TASKCON, 
installed on the NetWare Server and accessible to 
all users on the network.  Install OnQueue-M when 
you need to access more than one NetWare File Server.
************************************
Task
************************************
A task is any program that can be executed on an IBM PC 
compatible.  A task can be submitted for execution to the 
OnQueue System.  Execution of programs that normally 
require active user input is facilitated by using any popular 
keyboard stuffer.  Examples of tasks include data transfers, 
job scheduling, database searches, compilations, resource 
sharing, and mainframe style batch processing.
************************************
Task Queue
************************************
A queue on a Novell File Server that holds the tasks 
waiting to be executed by a dedicated OnQueue 
Task Server.  The network Supervisor creates and 
manages the queues.
************************************
Task Queue Operator
************************************
A task queue operator is a user that manages 
queue(s) and can delete tasks in a queue.  The 
network Supervisor is the default queue operator 
and uses the TASKCON program to designate users 
as queue operators. 
************************************
Task Queue User
************************************
A task queue user is a NetWare user that can submit 
tasks to the OnQueue System.  The group, EVERYONE, 
is the default task queue user and enables all its members 
to use the queue.  Default user assignments can be 
changed by the TASKCON utility.  Since all NetWare 
users are normally assigned to the group EVERYONE, 
they all have the ability to send tasks to a queue.  The 
network Supervisor can assign or remove users or 
groups as task queue users. 
************************************
TASKCON
************************************
TASKCON is OnQueues task console program 
that allows the network Supervisor to create and 
manage task queues and Task Servers.  By menus 
or DOS command line input, it also allows queue 
users to submit tasks for execution by the Task Servers.




The next section tells you how to backup the software, 
install the software, and boot a Task Server.


************************************
Installing the OnQueue Software
************************************

This section first describes backing up the OnQueue Master 
Diskette, then the OnQueue installation process.
******************************************
Making Backup Copies of the OnQueue Master Diskette
******************************************
This section provides directions for making backup copies of 
your OnQueue master program diskettes.  Steps are provided 
for systems with either single or dual high density floppy 
drives.  Before going any further, write protect the master 
diskette.  Then follow the steps that are appropriate for the 
number of drives in your system.  You must run DISKCOPY 
from your own DOS utilities.  These steps assume you are 
running DISKCOPY from the C: drive.  Before proceeding, 
prepare a label for the backup copy of your OnQueue master 
program diskette.  It is essential to record the serial number 
of the OnQueue master diskette on the label of your backup 
diskette.
************************************
Instructions for a Single Floppy Drive System
************************************
	1.  Have ready one blank diskette for making a 
	     backup copy of the OnQueue master program 
	     diskette that is compatible with your system drive.

	2.  Insert the OnQueue master program diskette 
	     (SOURCE) in drive a: .

	3.  At the C:> prompt, type:
	     diskcopy a: a: <Enter>
	     The following prompts appear:
	     Insert SOURCE diskette in Drive A: 
	     Press any key when ready....

	4.  When you are prompted for the target diskette, 
	     remove the master program diskette and insert a 
	     blank diskette in drive A:. Press <Enter>.  This 
	     process repeats until the blank diskette is formatted 
	     and the entire contents of the master program 
	     diskette (SOURCE) are copied to the blank diskette 
	     (TARGET).

Make sure you write protect the OnQueue master program diskettes 
and store it in a safe place when you are done.  If the backup 
diskette ever becomes damaged,  make a new copy from the 
master diskette.

************************************
Instructions for a Dual Floppy Drive System
************************************
	1.   Have ready one blank diskette for making 
	     a backup copy of the OnQueue master program diskette 
	     that is compatible with your system drive.

	2.  Insert the OnQueue master program diskette (SOURCE) in
	     drive a: .

	3.  At the C:> prompt, type:
	     diskcopy a: b: <Enter>
	     The following prompts appear:
	     Insert SOURCE diskette in Drive A: 
	     Insert TARGET diskette in Drive B: 
	     Press any key when ready....

	4.  Place the master program diskette in drive A: and the target
	     diskette in drive B:.  The target diskette is formatted and the
	     entire contents of the master program diskette (SOURCE) 
	     are copied to the blank diskette (TARGET).  
	     Make sure you write protect the OnQueue master program
	     diskettes and store it in a safe place when you are done.
	     If the backup diskette ever becomes damaged,  make a new
	     copy from the master diskette.


************************************
Installation
************************************

If this is the first time you are installing or reinstalling the OnQueue
software, pay close attention to the following instructions.  If you are
dedicating an additional workstation as an OnQueue Task Server, 
follow the procedures in the section entitled, Additional Server 
Installation.  If you are upgrading the OnQueue software, follow the 
procedures in the section entitled, Upgrade Installation. 
If you want to remove OnQueue, see the Appendix, 
OnQueue Software Removal.
You are given the choice to use a default or custom installation.  
The advantage of the default installation is that it allows simple yet 
immediate usage of the software directly following installation.  The
custom installation, however, allows you to assign your own Task 
Server name, queue name, and  location for the local software 
(path).
If you want to install OnQueue on a floppy based 
workstation, or on a diskless workstation, see the 
Appendix, OnQueue Installation Alternatives.

To install OnQueue on a monochrome system, type 
\install /m <Enter> instead of  \install <Enter> when you 
follow the steps below.  The modifier, /m, instructs the 
software to install and run on a monochrome system.

The installation process requires that you login as 
Supervisor to create queues and assign queue users.


************************************
Default Installation
************************************

Follow these steps if you are installing OnQueue for the first time
and have no customizations to make.  If you are not sure whether
this would apply to you, see the following section, CUSTOM 
INSTALLATION, which details custom options.
	1.  The workstation that you are dedicating as an 
	     OnQueue Task Server should have a hard drive, C: 
	     & high density floppy drive.

	2.  Login from this workstation as Supervisor.

	3.  Write down the serial number from the OnQueue Master 
	     Program Diskette for later reference.

	4.  Insert the diskette into drive A:.

	5.  If the file, readme.txt exists, type README.TXT <Enter>.
	     Read the file and check for modifications to installation 
	     instructions and any other recent changes.  If any 
	     information is pertinent to the installation, modify these 
	     instructions accordingly.

	6.  At the A:> prompt type \install <Enter>.

	7.  At the Installation Options menu, select Change Current
	     File Server to select the File Server you wish to install
	     on.  Then select Default Installation and press <Enter>.

	8.  At the Installation Parameters menu, enter the serial 
	     number of the OnQueue Master Program Diskette at 
	     the "Task Server S/N: prompt" and press <Enter> 
	     then <Esc>.

	9.  Select "Yes" at the "Continue Installation?" prompt to 
	     complete the installation.
	     The installation takes a few minutes to complete.  
	     During this time, the workstation is configured as a 
	     dedicated OnQueue Task Server.  The queue is created
	     and the OnQueue Task Console program, 
	     TASKCON, is copied to the Novell File Server.
	     The following defaults are assigned:
	o  Task Server Name:  TASK_SERVER_1.
	o  Location of OnQueue Task Server files is C:\ONQUEUE.
	o  The Task Server, TASK_SERVER_1, is assigned to use the
	     queue, TASKQ_1.  This queue has the group EVERYONE
	     assigned as users; the user, SUPERVISOR, is assigned as a
	     queue operator.  All members of the group EVERYONE 
	     can enter tasks into the queue once the default installation
	     is complete.
	o  TASKCON is copied to the SYS:\PUBLIC directory.  
	     All users with access to this directory (normally 
	     EVERYONE) can now run TASKCON.
	o  Additional queues can be created as needed, see the 
	     section, Queue Management, for more information.
	10.  To start the Task Server type:
	     \OnQueue\OnQueue <Enter>.
	     If you have more than one File Server you must enter the 
	     File Server name before the Task Server name as shown 
	     here:  \OnQueue\OnQueue  File_Server  Task_Server_1.
	     Your autoexec.bat file is automatically modified to include
	     the following:  SET ONQUEUE_PATH=C:\ONQUEUE


************************************
Custom Installation
************************************

Follow these steps if you are installing OnQueue for the first time 
and wish to customize settings.
	1.  The workstation that you are dedicating as an OnQueue 
	     Task Server should have a hard drive, C: & high density 
	     floppy drive.

	2.  Login from this workstation as Supervisor.

	3.  Write down the serial number from the OnQueue Master 
	     Program Diskette for later reference.

	4.  Insert the diskette into drive A:.

	5.  If the file, readme.txt exists, type README.TXT <Enter>.
	     Read the file and check for modifications to installation 
	     instructions and any other recent changes.  If any 
	     information is pertinent to the installation, modify 
	     these instructions accordingly.

	6.  At the A:> prompt type \install <Enter>.

	7.  At the Installation Options menu, select  to select the File 
	     Server you wish to install on.  Then select Custom 
	     Installation and press <Enter>.

	8.  At the Installation Parameters screen, you are required to
	     either edit or use the default names provided:
	     o  Task Server S/N.  Enter the serial number of the 
		OnQueue Master Program Diskette
	     o  Task Server Name.  Assign a name to the Task 
		Server, e.g., my_name.
	     o  Local Directory Path.  Enter the assigned path to
		find the OnQueue Task Server files, e.g., my_path.
	     o  Queue Name.  Assign a name to the queue, e.g.,
		my_queue.
	When you have entered all fields, and have no changes, 
	press <Esc>.

	9.  Select "Yes" at the "Continue Installation?" prompt to 
	     complete the installation.

The installation takes a few minutes to complete.  During this time, 
the workstation is configured as a dedicated OnQueue Task Server.  
The queue is created and the OnQueue Task Console program, 
TASKCON, is copied to the Novell File Server.
The following customizations are assigned from the Installation 
Parameters screen information:
	o  Task Server Name:  my_name.
	o  Location of OnQueue Task Server files is my_path.
	o  The Task Server, my_name, has been assigned to use the 
	     queue, my_queue.  This queue has the group EVERYONE 
	     assigned as users; the user, SUPERVISOR, is assigned as a
	     queue operator.  All members of the group, EVERYONE, 
	     can enter tasks into the queue once the custom installation 
	     is complete.
	o  TASKCON is copied to the SYS:\PUBLIC directory.  All 
	     users with access to this directory (normally 
	     EVERYONE) can now run TASKCON.
	o  Additional queues can be created as needed, see the section,
	     Queue Management, for more information.

	10.  To start the Task Server type:
	     \OnQueue\OnQueue  my_name  <Enter>.
	     If you have more than one File Server you must enter the 
	     File Server name before the Task Server name as shown 
	     here:  \OnQueue\OnQueue  File_Server   my_name.

Your autoexec.bat file is automatically modified to include the 
following:  SET ONQUEUE_PATH=my_path


************************************
Additional Server Installation
************************************

Follow this procedure to dedicate an additional workstation as an 
OnQueue Task Server.
	1.  The workstation that you are dedicating as an OnQueue 
	     Task Server should have a hard drive, C: & high density 
	     floppy drive.

	2.  Login from this workstation as Supervisor.

	3.  Write down the serial number from the OnQueue Master 
	     Program Diskette for later reference.

	4.  Insert the diskette into drive A:.

	5.  If the file, readme.txt exists, type README.TXT <Enter>.  
	     Read the file and check for modifications to installation 
	     instructions and any other recent changes.  If any 
	     information is pertinent to the installation, modify 
	     these instructions accordingly.

	6.  At the A:> prompt type \install <Enter>.

	7.  At the Installation Options menu, select Change Current 
	     File Server to select the File Server you wish to install 
	     on.  Then select Server Installation Only and press 
	     <Enter>.

	8.  At the Installation Parameters screen, you are required to 
	     either edit or use the default names provided:
	     o  Task Server S/N.  Enter the serial number of the 
		  OnQueue Master Program Diskette
	     o  Task Server Name.  Assign a name to the Task Server, 
		 e.g., my_name.
	     o  Local Directory Path.  Enter the assigned path to find 
		  the OnQueue Task Server files, e.g., my_path.
	     When you have entered all fields, and have no changes, 
	     press <Esc>.

	9.  Select "Yes" at the "Continue Installation?" prompt to 
	     complete the installation.

The installation takes a few minutes to complete.  During this time, 
the workstation is being configured as a dedicated OnQueue Task 
Server.  You must use TASKCON to assign the Task Server to an 
existing queue, or create a queue to assign it to.  Additional queues 
can be created as needed, see the section, Queue Management, for 
more information.
If you have changed the default names, the following customizations 
are assigned from the Installation Parameters screen information:
o  Task Server Name:  my_name.
o  Location of OnQueue Task Server files is my_path.

	10.  To start the Task Server type:
	     \OnQueue\OnQueue  my_name  <Enter>.

If you have more than one File Server you must enter the File 
Server name before the Task Server name as shown here:  
\OnQueue\OnQueue a File_Server  my_name.
Your autoexec.bat file is automatically modified to include the 
following:  SET ONQUEUE_PATH  my_path


************************************
Update Installation
************************************

Follow this procedure to update your OnQueue Task Server 
software.
	1.  The workstation that you are dedicating as an OnQueue 
	     Task Server should have a hard drive, C: & high density 
	     floppy drive.

	2.  Login from this workstation as Supervisor.

	3.  Write down the serial number from the OnQueue Master 
	     Program Diskette for later reference.

	4.  Insert the diskette into drive A:.

	5.  If the file, readme.txt exists, type README.TXT <Enter>.
	     Read the file and check for modifications to installation 
	     instructions and any other recent changes.  If any 
	     information is pertinent to the installation, modify 
	     these instructions accordingly.

	6.  At the A:> prompt type \install <Enter>.

	7.  At the Installation Options menu, select Change Current 
	     File Server to select the File Server you wish to install 
	     on.  Then select Update Installation and press <Enter>.

	8.  At the Installation Parameters menu, enter the serial 
	     number of the OnQueue Master Program Diskette at
	     the "Task Server S/N: prompt" and press <Enter> then 
	     <Esc>.

	9.  Select "Yes" at the "Continue Installation?" prompt to 
	     complete the installation.

The installation takes a few minutes to complete.  During this time, 
the new versions of software are copied to the Novell File Server 
and the workstation is configured as a dedicated OnQueue Task 
Server.  If you changed any of the information in the Installation 
Parameters screen when you last installed OnQueue, you will need 
to enter this information again.  Otherwise program defaults will be 
used and the program files will be copied to the SYS:\PUBLIC 
directory.

	10.  To start the Task Server type:
	     \OnQueue\OnQueue  Task_Server  <Enter>.

If you have more than one File Server you must enter the File 
Server name before the Task Server name as shown here:  
\OnQueue\OnQueue  File_Server  Task_Server.
Your autoexec.bat file is automatically modified to include the 
following:  SET ONQUEUE_PATH=C:\ONQUEUE
OnQueue-M Additional Installation Instructions
If you are installing OnQueue-M, once the basic installation is 
complete, the OnQueue-M Task Server must be configured for 
each File Server it will support.  For more information, see the 
section, Task Server Management later in this manual. 


************************************
Booting an OnQueue Task Server
************************************

After completing the installation of the OnQueue software, you are 
ready to boot the OnQueue Task Server.  The OnQueue Task 
Server requires the same network shell software as a Novell 
workstation.  The appropriate Novell workstation shells should 
already be loaded since you were logged into the network during the 
installation process.  For more information on these consult your 
NetWare documentation.
If you want the dedicated workstation to come up as a Task Server 
when it is rebooted, you must modify the end of the autoexec.bat file 
with these five lines:
	o  LSL
	o  LAN driver, e.g., 3C5X9
	o  IPXODI
	o  NETX
	o  \OnQueue\OnQueue  File_Server  Task_Server
The OnQueue Task Server also supports a log file, which captures 
all OnQueue Task Server message output.  This feature allows the 
network manager to monitor and review executed tasks.  The syntax 
for turning on this feature is:
SET ONQUEUE_LOG_FILE=
File_Server\Volume_name:Net_Dir\Sub_Dir\Filename.ext
The File Server that is specified must be the same one used when 
OnQueue is booted.  The directory specified should be one where 
the group, EVERYONE, has access rights.

See Environment Variables Appendix for more options.


The next section describes using TASKCON.

Figure 2

Figure 3


*******************************************
Using TASKCON - the OnQueue Task Console Program
********************************************

TASKCON is a menu oriented program that provides function 
selection and data input for task submission to OnQueue.  This 
section describes how to submit tasks for execution by an OnQueue 
Task Server.  Tasks are submitted either by using the OnQueue 
Task Console program menus, or directly by TASKCON DOS 
commands.  Special key assignments are also presented.


*******************************************
Menu Operation
*******************************************
	1.  At the DOS prompt, from any Novell workstation, type 
	     TASKCON then <Enter>.
	2.  When the main menu appears, select Queue Information.
	3.  Highlight the appropriate queue and press <Enter>.
	4.  Select Current Queue Entries from the Queue  
	     Information Menu.
	5.  Press <Ins> to display the task submittal screen shown in 
	     Figure 2.
	6.  Enter the command line needed to invoke a task.  Be sure to 
	     to redirect the output of the task to a file so you may view
	     it after the task is complete.  For example, use the 
	     following format:  task_name > filename.  Press <Enter>.
	7.  Enter the working directory to be used and press <Enter>.
	8.  If you do not want the Task Server to notify your 
	     workstation when the task is completed, press <N> 
	     for NO.  Press <Enter>.  Otherwise just Press <Enter>
	      to accept YES (the default if you have not changed 
	     defaults) to have the Task Server notify you.
	9.  Press <Enter> to submit the task without Command.Com
	     for task execution.
For more information on this option see the section, Submitting Tasks
without Command.Com, under The Task Server Environment.
	10.  At the Repeat option, press <Enter>.  Figure 3 shows the
	     options available: none; daily; every; weekly; and monthly.
	     Choose an option and specify the other information 
	     related to time of day, time interval, or day(s) of week 
	     or month, as appropriate for your selection.  Press 
	     <Esc> when done.
	11.  At the DOS Environment option, press <Enter>.  Select 
	     an option, then press <Enter> .
	12.  Press <Enter> to NOT defer the task you are about to 
	     submit.  If you wish to defer execution, press <Y> 
	     instead.  In this case, your next <Enter> moves you to the 
	     Target Time: field.  Enter the date and time you want the 
	     Task Server to execute this task .
	13.  At the Task Server option, press <Enter>.  Select a Task 
	     Server to execute your task, then press <Enter>.
	14.  Press <Esc> to submit the task.


*******************************************
TASKCON Key Assignments
*******************************************
This section describes special keys and their function.

	    KEY         DESCRIPTION OF FUNCTION
	 Left & Right           For data input, moves
	    Arrows              between fields, or from
			character to character,
			within fields
	 Up & Down      Highlights a selection
	  Arrows                from a pop-up menu, or
			moves between data input
			fields.
	   <Del>        Removes an item from a list.
	  <Enter>               Selects the highlighted menu
			option.  Advances to the next
			data input field on screens
			with multiple fields.
	   <Esc>        Returns you to the previous
			menu, or exits the program
			from the main menu, with a
			confirmation.  It also aborts
			a process and allows the
			program to continue.
	    <F1>        Can be pressed anytime to
			obtain help that is specific
			to the current operation.
			Pressing it twice gives the
			function key assignments.
	    <Ins>       Adds an item to a list.

*******************************************
TASKCON DOS Command Line Operation
*******************************************
Tasks can be submitted from DOS using the following format:
TASKCON  my_path \ task_name   options  <Enter>
	   WHERE:       SPECIFIES:
	   my_path      optional directory path including drive
	   task_name    name of the task (program) to execute
	   options      any of several task processing options


	   Option:      SPECIFIES:

	      /C                        use command.com

	     /EU[P][T]          execute with user DOS 
				environment and user 
				Path.  [options:: P=preference, 
				T=Task ServerPath]

	     /ET[P][T]          execute with Task Server DOS 
				environment and user 
				Path.   [options: P=preference, 
				T=Task Server Path]

	     /F:file_server_name        specify a task queues File Server

	      /H                        display this text and exit
	      /M                        send a message on completion
	      /NC                       do not use command.com
	      /NM                       do not send a message on 
				completion
	      /NR                       execute only once
	/Q:queue_name           specify a queue to place a task in
	      /RD                       repeat execution of task daily
	  /RE:DD:HH:MM  repeat execution every days:hours:
				minutes
    /S:task_server_name         specify a Task Server to execute 
				the task
     /T:MM-DD-YY-HH:MM  execution date/time in form shown

     /W:my_dir                  specifies the working directory, 
				e.g., my_dir
	
An option must be separated by a space character and is preceded 
by either the "/" character or the "-" character.  It may be specified in 
upper or lower case.  If the task invokes a program with its own 
options, use double quotations to separate TASKCON options from 
the actual task and its parameters.  Double quotations allow the task 
and associated arguments to be treated as a single entity.
Examples
The following example redirects the output of the DOS directory 
command to a file called Smith in directory, F:\user and uses the 
DOS output option, wide.  In this example, no message is sent to 
the user on completion of the task:     
TASKCON "DIR *.* /W >F:\USER\SMITH" /NM
The next example submits a task that repeats every day at 4PM:
TASKCON MYTASK  /RD /T:16:00
The next example submits a task that repeats every 10 days, at 
2AM, starting on July 5, 1994:  
TASKCON MYTASK /RE:10:00:00 /T:07-05-94-02:00
The next example submits a task for execution on Task Server, 
TS_2.  It is submitted to queue, Taskq_1, on File Server, Sales:
TASKCON MYTASK /S:TS _2 /F:SALES /Q:TASKQ_1
The next example submits a task to copy a file, that includes 
command line parameters and sends no message to the user:       
TASKCON "COPY TEST.TXT TEXT2.TXT" /NM
The next example shows the correct way to submit a task that 
includes a slash command line parameter within the actual task.  
Here, a file is copied to another directory (see note below):   
TASKCON "COPY TEST.TXT H:\  " /NM
Note:  A space is required after the H:\ and before the quote that 
signifies the end of the command line input that makes up the task.  
If you forget the space, DOS will not understand the command.
If command options are not specified when a task is submitted, 
OnQueue uses the following defaults:  a task is submitted to the first 
queue assigned to the user; command.com is used; the working 
directory is set to the drive or directory the user is in when 
submitting the task; the user submitted DOS environment is used; 
any Task Server is used; a message is sent to the user when done.
If you want to change the OnQueue Task Console program defaults, 
you can SET the environment variable, TASKCON_DEFAULTS, to 
the options of choice.  For example, if you want to set the default 
queue to TASKQ_1 and you don't want completion messages sent 
to your workstation, you need to change 2 default values.  These 
must be specified together in one SET statement:
SET TASKCON_DEFAULTS=/Q:TASKQ_1 /NM

*
The next section describes queue management.


*******************************************
Queue Management
*******************************************

This section describes queue management rights and presents all 
aspects of queue management from the perspective of the network 
Supervisor.
*******************************************
Queue Management Rights
*******************************************
There are four levels of queue management rights that can be 
assigned.  Presented in order of increasing privileges, they include: 
none, user, operator, and Supervisor.  Each level allows different 
queue management functionality, and is presented in detail in the 
following table.

LEVEL                   QUEUE MANAGEMENT RIGHTS

None                    NetWare user, not assigned as a task queue 
			user, who has no rights and may only view 
			the list of queues and see which users 
			are assigned to them.

User                    NetWare user, assigned as a task queue user, 
			who may: view the list of queues and see 
			which users are assigned to them; submit
			tasks to a queue; delete their own tasks; 
			determine which servers are currently 
			attached to a queue; and check the queues
			status.

Operator                NetWare user, assigned as a task queue 
			operator, who has all the rights of a task 
			queue user, as well as the privilege to delete 
			or move any tasks in a queue.

Supervisor              NetWare user who has all the rights of a task 
			queue operator, as well as the privilege to 
			create and delete task queues.

Remember, the supervisor has the most rights, an unassigned user 
has the least:  Supervisor  >  operator  >  user  >  none

Since the network Supervisor has the privilege to do everything the 
OnQueue System offers, queue management is presented from the 
Supervisors perspective.

*******************************************
Queue Creating and Deleting
*******************************************
At the Available Options menu (main menu), highlight the first 
selection, Queue Information and press <Enter>.  The current 
queue list appears.
The Supervisor can CREATE or DELETE a queue by pressing 
<Ins> or <Del>, respectively.
With the queue list displayed, press <Ins>.  The "Queue Name:" 
prompt appears.
Type in the name of the queue you want to add, then press <Enter> 
followed by <Esc>   A queue must exist before it can be assigned to 
a Task Server; if it does not exist it must be created.  Queue 
priorities are specified when queues are assigned to a particular 
Task Server.  See the section, Assigning Queues to a Task Server, 
for more information.
If you pressed <Del> to delete a queue, you are asked to confirm 
the operation.  At the "Delete Queue" confirmation, highlight "Yes" 
and press <Enter>. 
Selecting a Queue
Highlight one of the queues and press <Enter>.  Once a queue is 
selected, the Queue Information menu options appear.  These 
menu options are described next.
*******************************************
The Queue Information Menu
*******************************************
There are six menu options associated with queue management on 
the Queue Information menu:
	o       Current Queue Entries
	o       Current Queue Status
	o       Currently Attached Task Servers
	o       Queue Operators
	o       Queue Users
	o       Time Restrictions
Creating and deleting queues was discussed earlier in this section.  
The other queue management aspects follow.
*******************************************
Current Queue Entries
*******************************************
The Current Queue Entries menu option allows queued task 
names to be displayed, tasks to be submitted or deleted, and details 
of queued tasks to be viewed.
Select a queue from the Queue Information menu, then select 
Current Queue Entries.
Press <Enter> to view the names of tasks queued for servicing by 
the Task Server(s).  The sequence number indicates the current 
task servicing order.  Press <Esc> when done.
*******************************************
Submitting a Task to a Queue
*******************************************
Select a queue from the Queue Information menu, then select 
Current Queue Entries.
Press <Enter> then <Ins>.  The task submittal form appears.
Enter the command line needed to invoke this task and press 
<Enter> to advance to the next field.
Enter the working directory that should be used and press 
<Enter>.
The fields that are not blank when the screen first appears can 
be edited, or the defaults that appear can be used.  By default, 
the task is queued for immediate execution on any Task Server 
with command.com and the user submitted DOS environment.  A 
message is sent to the user who submitted the task when the 
task is completed.  
Press <Esc> to submit the task.
*******************************************
Deleting a Task in a Queue
*******************************************
Select a queue from the Queue Information menu, then select 
Current Queue Entries.
Press <Enter> to view the names of tasks queued for servicing by 
the Task Server(s).
Highlight the name of the task you wish to delete and press <Del>.
At the Delete Task confirmation, highlight "Yes" and press <Enter>.
Viewing Information about a Task
Select a queue from the Queue Information menu, then select 
Current Queue Entries.
Press <Enter> to view the names of tasks queued for servicing by 
the Task Server(s).
Highlight the name of the task you wish to view and press <Enter>. 
The next Figure presents a sample screen.
 
Figure 4
The user who submitted the task, or an operator of this queue can 
change the following fields:  User Hold; Send Message; Repeat 
Daily; Defer Execution; Target Time; Task Server.  Only an operator 
can change Operator Hold  and Service Sequence.
Press <Esc> when you are done viewing the information.
*******************************************
Current Queue Status
*******************************************
Select a queue from the Queue Information menu, then select 
Current Queue Status.
Press <Enter> to view the number of entries in the queue and the 
number of Task Servers currently logged in and attached to the 
queue as well as other configuration parameters related to queue 
management.  OnQueue-M installations can also choose to not 
allow multiple file server jobs by entering No to Allow Multiple File 
Server Jobs.  Press <Esc> when done.  The next figure presents a 
sample screen.
When you choose to not allow multiple file server jobs for an 
OnQueue-M installation, you are restricting OnQueue_M to execute 
tasks on only one File Server.  In this restriction example, if a 
network has 3 File Servers, A, B, and C, and a task is submitted to 
File Server B, it can only see the drives and resources associated 
with File Server B at the time of execution.  If, on the other hand, 
multiple file server jobs are allowed, and the Task Server has been 
installed to support File Servers A, B, and C, all resources 
associated with all 3 File Servers are available when tasks are 
executed.

 
Figure 5

*******************************************
Currently Attached Task Servers 
*******************************************
Select a queue from the Queue Information menu, then select 
Currently Attached Task Servers.
Press <Enter> to view the names of the Task Servers currently 
servicing the queue.  Press <Esc> when done.
*******************************************
Assigning Queue Operators
*******************************************
The network Supervisor is automatically assigned as a queue 
operator for every task queue created.  Select Queue Operators 
from the Queue Information Menu.
Press <Enter> to assign another queue operator to the queue.
Press <Ins> to display the Queue Operator Candidates list and 
highlight the user or group you wish to assign as a queue operator.  
Press <Enter> to add the selection as a queue operator.
Press <Ins> to add another queue operator and repeat.
*******************************************
Assigning Queue Users
*******************************************
The group EVERYONE is automatically assigned as a queue user 
for every task queue created.  Select Queue Users from the Queue 
Information Menu.
Press <Enter> to assign another queue user to the queue.
Press <Ins> to display the Queue User Candidates list and 
highlight the user or group you wish to assign as a queue user.  
Press <Enter> to add the selection as a queue user.
Press  <Ins> to add another queue user and repeat.
*******************************************
Removing Queue Operators
*******************************************
Select the queue operator you want to delete from the queue 
operator list and press <Del>.
At the "Delete Queue Operator" confirmation, highlight "Yes" and 
press <Enter>.
*******************************************
Removing Queue Users
*******************************************
Select the queue user you want to delete from the queue user list 
and press <Del>.
At the "Delete Queue User" confirmation, highlight "Yes" and press 
<Enter>. 
*******************************************
Restricting Task Execution by a Queue
*******************************************
You can control when a queue is allowed to execute tasks by 
selecting the Time Restrictions menu option from the Queue 
Information menu.  Restrictions can be made by anyone with 
supervisor rights and are available by the half-hour for 24-hour 
periods, every day of the week.  
The next figure shows a sample time restriction menu.  TASKQ_1 is 
restricted from executing tasks every morning between the hours of 
2 and 5:00 AM.  Use the cursor keys to select the half-hour period 
you wish to restrict.  Use <Delete> or <spacebar> to set the time to 
restrict.  Use <Insert> or asterisk to set the time to allowed.  The 
<Enter> key will toggle a setting and advance to the next time slot.  
If you have a mouse installed, clicking on a time slot will toggle the 
setting.  Click-and-hold will change an entire area.



 
Figure 6

The next section describes Task Server management.  All aspects 
of queue and Task Server management are available from the 
Available Options menu.  There are two selections on this menu, 
Queue Information and Task Server Information.


*******************************************
Task Server Management
*******************************************

This section describes Task Server management rights and 
presents all aspects of Task Server management from the 
perspective of the network Supervisor.
*******************************************
Task Server Management Rights
*******************************************
There are two levels of Task Server management rights.  Each level 
allows different Task Server management functionality, and is 
presented in detail in the following table.
LEVEL           TASK SERVER MANAGEMENT RIGHTS

NetWare User    NetWare users who may only view the list of 
		Task Servers, see what queues are assigned to 
		them, and check their status.

Supervisor      NetWare users with network Supervisor 
		privileges who have the right to create and 
		delete Task Servers, assign and remove queues 
		from Task Servers, and check their status.

Since the network Supervisor has the privilege to do everything the 
OnQueue System offers, Task Server management is presented 
from the Supervisors perspective.
*******************************************
Task Server Creating and Deleting
*******************************************
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.  The 
current Task Server list appears.
The Supervisor can CREATE or DELETE a Task Server by pressing 
<Ins> or <Del>, respectively.
With the Task Server list displayed, press <Ins>.
A pop-up window appears, as shown in Figure 7.
 
Figure 7
At the Task Server Name: prompt, type in the name of the Task 
Server you want to add and press <Enter>.
At the next prompt, Server S/N:, enter the serial number found on 
your OnQueue master diskette.  Failure to enter the proper serial 
number will result in your dedicated Task Server not being able to 
service queues.  When you have entered the correct serial number, 
press <Enter>.
Figure 8 shows the options available for Server Type.  Select the 
configuration that applies to your installed Task Server(s).  If you are 
installing OnQueue-M, you must select Multiple File Server in order 
to get multiple file server support.  When you are done, press 
<ENTER> followed by  <Esc>.

Multiple copies of Task Servers running on the same 
network must have unique serial numbers.  The Task 
Server you create must have the same name as a Task 
Server installed on a dedicated workstation.  See the 
section earlier in this guide, Installing the OnQueue 
Software, for more information.  You must also assign a 
queue to a Task Server before task servicing can take 
place.  This is discussed in more detail later.


Figure 8
If you pressed <Del> to delete a Task Server, you are asked to 
confirm the operation.
At the "Delete Task Server" confirmation, highlight "Yes" and press 
<Enter>. 
*******************************************
Selecting a Task Server
*******************************************
Highlight one of the Task Servers and press <Enter>.  Once a Task 
Server is selected, the Task Server Information menu options 
appear.  These menu options are described next.
*******************************************
The Task Server Information Menu
*******************************************
There are three menu options associated with standard Task Server 
management on the Task Server Information menu:
	o       Current Queues
	o       Current Server Status
	o       Time Restrictions
There are two additional menu options associated with OnQueue-M 
Task Server management on the Task Server Information menu:
	o       File Servers to be Serviced
	o       Security Equivalence
If accounting is installed on the File Server after the task 
server is installed, an additional menu item appears which 
allows you to add accounting support for the Task Server.
Creating and deleting Task Servers was discussed earlier in this 
section.  The other Task Server management aspects follow.
Once a Task Server is selected, the first selection on the Task 
Server Information menu allows you to add and remove queues 
from the group of queues assigned to be serviced by the selected 
Task Server.  These functions are described next.
*******************************************
Assigning Queues to a Task Server
*******************************************
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to add queues to and press 
<Enter>.
The Task Server Information menu appears.
Highlight the first menu option, Current Queues and press <Enter>.
Press <Ins> to display the Queue Candidates list.
Highlight the queue you wish to assign to the Task Server and press 
<Enter>.
A Task Server must be rebooted after a queue is assigned 
to it before it can service the queue.
Assign a servicing priority to the queue and press <Enter>.
Press <Esc> when done.
Press <Ins> to assign another queue to this Task Server.
*******************************************
Deleting Queues from a Task Server
*******************************************
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to delete queues from and press 
<Enter>.
The Task Server Information menu appears.
Highlight the first menu option, Current Queues, and press 
<Enter>.
Highlight the queue you no longer wish to be serviced by the 
selected Task Server and press <Del>.
At the Remove Queue From Task Server confirmation, highlight 
"Yes" and press <Enter>.
*******************************************
Viewing the Status of a Task Server
*******************************************
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to view and press <Enter>.
The Task Server Information menu appears.
Highlight the second menu option, Current Server Status, and 
press <Enter> to display the name, number of assigned queues, 
serial number of the selected Task Server, and the option, for 
OnQueue-M installations, to allow multiple file server jobs, as shown 
in Figure 9
Press <Esc> when done.
 
Figure 9

*******************************************
Restricting Task Execution by a Task Server
*******************************************
You can control when a Task Server is allowed to execute tasks by 
selecting Time Restrictions menu option on the Task Server 
Information menu.  Restrictions can be made by anyone with 
supervisor rights and are available by the half-hour for 24-hour 
periods, every day of the week.  
The next figure shows a sample time restriction menu.  
TASK_SERVER_1 is restricted from executing tasks on Sunday 
mornings between the hours of 2 and 6:30 AM.  Use the cursor keys 
to select the half-hour period you wish to restrict.  Use <Delete> or 
<spacebar> to set the time to restrict.  Use <Insert> or asterisk to 
set the time to allowed.  The <Enter> key will toggle a setting and 
advance to the next time slot.  If you have a mouse installed, 
clicking on a time slot will toggle the setting.  Click-and-hold will 
change an entire area.

 
Figure 10
*******************************************
Assigning File Server to be Serviced by a Task 
Server (OnQueue-M installations only)
*******************************************
This selection should be made on the primary file server that the 
task server logs into.  The primary file server is always serviced and 
does not appear in the list of file servers to be serviced, or in the 
Available file servers list.  After assigning a file server to be 
serviced, you must create an entry for the task server on that file 
server.  To perform this task return to the main menu, change to the 
file server that was assigned and follow the section on creating a 
task server.  If you wish you may also create queues on that file 
server and assign them to the task server.  Remember, the task 
server name on each assigned file server must match the primary 
file servers.
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to add a file server to and press 
<Enter>.
The Task Server Information menu appears.
Highlight the menu option, File Servers to be Serviced and press 
<Enter>.
 
Figure 11
Press <Ins> to display the Available File Servers list.
Highlight the file server you wish to assign to the Task Server and 
press <Enter>.

A Task Server must be rebooted after a file server is 
assigned to it before it can service the file server.
Press <Ins> to assign another file server to this Task Server.
*******************************************
Deleting File Server from the File Servers to be 
Serviced (OnQueue-M installations only)
*******************************************
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to delete an assigned file server 
from and press <Enter>.
The Task Server Information menu appears.
Highlight the menu option, File Servers to be Serviced, and press 
<Enter>.
Highlight the file server you no longer wish to be serviced by the 
selected Task Server and press <Del>.
At the Delete Assigned File Server confirmation, highlight "Yes" 
and press <Enter>.
*******************************************
Assigning a Security Equivalence to a Task Server 
(OnQueue-M installations only)
*******************************************
By default the security equivalence of the group, Everyone is 
assigned to a task server during task server creation.  To specify a 
different security equivalence follow the instructions below.  The 
security equivalence only applies to multi-file server tasks.  When a 
multi-file server job is run, the file server which contains the queue 
in which the task submitted will have a security equivalence to the 
user whom submitted the job.  All other file server security 
equivalences will be set to that defined here
At the Available Options menu (main menu), highlight the second 
selection, Task Server Information and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to add a file server to and press 
<Enter>.
The Task Server Information menu appears.
Highlight the menu option, Security Equivalence and press 
<Enter>.
 
Figure 12
Press <Ins> to display the Other Users And Groups list.
Highlight the User or Groups security equivalence you wish to 
assign to the Task Server and press <Enter>.
Press <Ins> to assign another security equivalence to this Task 
Server.
*******************************************
Deleting a Security Equivalence from a Task Server
*******************************************
For OnQueue-M installations, at the Available Options menu (main 
menu), highlight the second selection, Task Server Information 
and press <Enter>.
The current Task Server list appears.
Highlight the Task Server you wish to delete an assigned security 
equivalence from and press <Enter>.
The Task Server Information menu appears.
Highlight the menu option, Security Equivalence, and press 
<Enter>.
Highlight the security equivalence no longer wish to be assigned by 
the selected Task Server and press <Del>.
At the Delete a Security Equivalence confirmation, highlight "Yes" 
and press <Enter>.


The next section presents information on the Task Server 
environment.


*******************************************
The Task Server Environment
*******************************************

*******************************************
How a Task is Executed
*******************************************
The OnQueue Task Server examines its assigned queues in order 
of their priority.  It selects the first available task and proceeds to set 
its environment and network rights to the same that the user had at 
the time the task was submitted.  The Task Server attempts to 
match the following parameters:  
	o       path
	o       directory assignments (mapped roots are also supported)
	o       user working directory
	o       printing capture settings
	o       DOS environment (not including the path)
Finally, OnQueue executes the command line submitted at the time 
of task submission.
After the task is completed, OnQueue sends a message to the user 
that the task has been completed unless the user specified no 
message to be sent.  OnQueue is now ready to service the next 
task.
*******************************************
DOS Environment Variables
*******************************************
Many programs require the use of environment variables to specify 
information the program will use.  By default,  OnQueue executes a 
task with the same DOS environment the user had at the time the 
task was submitted.  The only user variable that will not be used is 
the COMSPEC=.  This variable is always set to the value of the 
OnQueue Task Server's environment space.  
When a task is submitted, the user has a choice of specifying one of 
the following DOS environments to be used by the Task Server 
when the task is executed:
	o       The user's DOS environment with the user's path (default)
	o       The user's DOS environment with the Task Server's path
	o       The user's DOS environment is preferred with the user's path
	o       The user's DOS environment is preferred with the Task 
		Server's path
	o       The Task Server's DOS environment with the user's path
	o       The Task Server's DOS environment with the Task Server's 
		path
	o       The Task Server's DOS environment is preferred with the 
		user's path
	o       The Task Server's DOS environment is preferred with the 
		Task Server's path
The user's DOS environment with the user's path option instructs 
the Task Server to use the same DOS environment the user had at 
the time the task was submitted with the user's path.  The user's 
DOS environment with the Task Server's path option instructs the 
Task Server to use the same DOS environment the user had at the 
time the task was submitted with the Task Server's path.  The Task 
Server's DOS environment with the user's path option instructs the 
Task Server to use its own DOS environment with the user's path.  
In this case, no variables from the DOS environment that the user 
had at the time the task was submitted are used.  The Task Server's 
DOS environment with the Task Server's path option instructs the 
Task Server to use its own DOS environment with the Task Server's 
path.  For the preferred options, the Task Server is instructed to use 
a combination of settings from the user's and its own DOS 
environment.  With this option, if the same DOS environment 
variable exists in the user's and Task Server's environment, then 
only the variable from the preferred environment is used.
All NetWare drive mappings are set to those the user had at the 
time of task submission evenif the Task Server's path option is 
selected.
If you specify a large number of environment variables in your 
workstation's environment space, you may need to increase the size 
of the DOS environment space available during task execution.  
This is particularly true if you use the "preferred" option since the 
task execution DOS environment will be the size of the combination 
of two environments.  By default, the Task Server provides 2048 
bytes of environment space.
If you need to increase the size of the DOS environment space, 
specify the following in the autoexec.bat file of the Task Server:
SET OnQueue_USER_ENV_MEM=XXXXX (where 160 bytes < 
XXXXX < 32767 bytes).  
*******************************************
DOS Environment Variables in Batch Files
*******************************************
You can submit a batch file as a task which includes environment 
variables specified by the DOS "SET" command.  These "SETs" 
override the DOS environment variables described above.  If you 
specify a large number of environment variables in this way, you 
may need to increase the size of the DOS environment space.  By 
default, the Task Server provides 2048 bytes of environment space.  
This includes all variables set prior to booting the Task Server, i.e., 
all variables specified in the autoexec.bat file, as well as variables 
from the DOS environment that the user had during task 
submission.
To change the size of the DOS environment space created by the 
OnQueue Task Server, specify the following in the autoexec.bat file 
of the Task Server:
SET OnQueue_ENV_MEM=XXXXX (where 160 bytes < XXXXX < 
32767 bytes).  

To minimize memory usage in your Task Server, SET the 
DOS environment size in the config.sys file to just the size 
needed for variables you will define in the autoexec.bat file.
Local Drives
If the task you wish to submit utilizes a local drive, you can change 
the task to use only file server drives to ensure that all specified 
drives (as well as utilities on these drives) are available to 
OnQueue.  Additionally, if you have frequently run tasks that are 
shared in common by many users, you can create the needed 
directories and install the shared utilities on the dedicated Task 
Server itself.
*******************************************
Network Printing
*******************************************
The printer port capture settings of the user's workstation  are stored 
as part of the task when it is submitted.  Printing is restricted to the 
the same file server that your job is submitted to.  When the task is 
executed, these capture settings are used.  Any printing that your 
task performs will be redirected to the network if your workstation 
had capture active at the time the task was submitted.  
When a task is submitted by a user, in addition to storing the user's 
capture settings, the Printer Setup Buffer & Printer Reset Buffer 
strings, if specified, are also stored.  During task execution, these 
are restored so that any printing will use the appropriate strings.
*******************************************
Task Server Peripherals
*******************************************
All network users have access to hardware installed on the Task 
Server by submitting tasks that utilize it.  For example, a plotter 
could be located at the Task Server along with access to the 
program that would use it.  A modem with software to perform 
upload and downloads from a mainframe could also be located at 
the Task Server.  Network users could then submit  tasks using 
these peripherals to the Task Server.  The incorporation of a special 
Math Processing chip at the Task Server is another example of 
locating shared resources at the Task Server.  This would enable all 
Network Users to take advantage of the processing powers of this 
device.
*******************************************
Submitting Tasks with Command.Com
*******************************************
Normally, tasks are executed by OnQueue without using 
command.com.  When OnQueue executes a task, it first searches 
the working directory and path to find the task to execute.  If the task 
is an EXE or COM file, the task is executed without command.com.  
If the task is a BATCH file, or if the append form of redirected output 
or redirected input are specified, OnQueue automatically executes 
the task with command.com.
The /C option can be used to specify that command.com is always 
used when executing a task. Execution of tasks with command.com 
requires slightly more memory than without.
*******************************************
Example Environment Setups
*******************************************
To illustrate the alternate environments, an example of compiling C 
programs with the Microsoft C compiler is shown.  Two forms of 
setup are described.  The first locates the C compiler on the C: drive 
of the OnQueue dedicated Task Server.  The second example 
assumes the C compiler is located on the network. 
Example 1 - Compiler Located on the Task Server
Locating your C compiler on the hard drive of the OnQueue Task 
Server allows less frequent access of the network File Server when 
executing compilations and links.  This approach is useful when 
many compilations are needed.  Additionally, this approach allows 
the network to purchase a single copy of the compiler, installed on 
the Task Server, for access by all users without ever running more 
than a single copy on more than one machine at all times.  Your 
source files and target directory for object and executable file 
creations must specify Novell File Server drives  When you submit 
the task, you should specify to use the Task Server DOS 
environment option.

The following directories must be created on your Task Server:
C:\C600\BINB
Specifies the location of Bound 
executables

C:\C600\BIN
Specifies the location of Real Mode  
executables

C:\C600\LIB
Specifies the location of standard library 
files

C:\C600\INCLUDE
Specifies the location of standard includes

C:\TMP
Specifies the location of temporary files


The following must be specified in the Task Server's autoexec.bat 
file.
SET LIB=C:\C600\LIB
Specifies the location of 
standard library files

SET INCLUDE=C:\C600\INCLUDE
Specifies the location of 
standard includes

SET TMP=C:\TMP
Specifies the location of 
temporary files

The following must be specified in your batch file that is submitted 
as the task to the Task Server.
MAP INSERT S5:=C:\C600\BINB
AND
MAP INSERT S6:=C:\C600\BIN
Inserts the location for the 
compiler tools into the 
search path. These are 
NOT needed if all user 
workstations have a C 
compiler in this directory.

Example 2 - Compiler Located on Network File 
Server
If your C compiler is located on the network File Server, all users as 
well as the OnQueue Task Server have access to it. Your source 
files and target directory for object and executable file creations 
must specify Network drives and the following directories must be 
created on your file server:
F:\TOOLS\C600\BINB
Specifies the location of Bound 
executables

F:\C600\BIN
Specifies the location of Real 
Mode  executables

F:\C600\LIB
Specifies the location of standard 
library files

F:\C600\INCLUDE
Specifies the location of standard 
includes

F:\TMP
Specifies the location of temporary 
files

If the same environment settings are issued repeatedly, you 
could simply include them in the autoexec.bat file of the 
Task Server itself; they can always be overridden each time 
a new task is submitted.
There is no need to insert the location of the compiler tools into the 
search path in a batch file if the workstation user has the C compiler 
tools in their path.  When you submit the task, you should specify 
that the Task Server use the user submitted DOS environment 
option.  This ensures that the following SETS specified in the user 
workstation autoexec.bat are used during execution.
SET LIB=F:\C600\LIB
Specifies the location of 
standard library files

SET INCLUDE=F:\C600\INCLUDE
Specifies the location of 
standard includes

SET TMP=F:\TMP
Specifies the location of 
temporary files


The next section presents some troubleshooting advice.


*******************************************
Problems?
*******************************************
If you have had problems getting your Task Server installed and up 
and running, the following checklist and troubleshooting tips are 
provided to help you fix any problems or show you where to get 
further help.
*******************************************
Final Checklist
*******************************************
HAVE YOU....
	Write protected the master program diskettes?
	Installed the software correctly? Need More Help?  See 
the instructions provided in the Installation section.


*******************************************
Troubleshooting Tips
*******************************************

*******************************************
Troubleshooting the Task Server
*******************************************
If the computer does not start, or an error message appears, turn off 
the computer and monitor and check all cables.  Then turn on the 
computer and monitor.  If the computer still does not start, refer to 
your PC owners manual for more help.
*******************************************
Troubleshooting the Software
*******************************************
If the Task Server does not start when you boot the dedicated 
workstation, power-down or reboot the computer.  If this does not 
correct the problem, boot the system as a Novell workstation and try 
logging into the Novell server.
If you are not successful and other workstations are able to login to 
the server, there may be a hardware problem with this particular 
workstation.  Try to login as a user.  If this does not work, correct the 
problem and make sure you can login as a user before proceeding.  
If you can login as a user but the Task Server does not boot, re-
install the Task Server software by making a new working copy from 
your archived master diskette and re-run install.  If the still does not 
start, turn the computer off and then on again.  

*******************************************
Installing a Task Server when Accounting is ON
*******************************************
If accounting has already been installed on the Novell File Server, 
when OnQueue is installed, unlimited credits provided.  If 
accounting is installed on the File Server after the Task Server is 
installed, a menu item in the Task Server Information menu 
appears.  This menu item allows you to add accounting support for 
the Task Server.  Remember, this menu item only appears if 
accounting is installed on the File Server and the Task Server does 
not have accounting support ON.
*******************************************
Troubleshooting Printing Problems
*******************************************
If tasks which print at the Task Server do not always setup or reset 
your printer correctly, your NetWare printer initialization and reset 
strings may be too long.  When OnQueue encounters a string longer 
than it's buffer, the string is not used.  Make sure that the 
workstation shell on the dedicated OnQueue Task Server has 
printer buffers as long as any that could be submitted by a user 
submitting tasks to OnQueue.  If you need to change them, you 
would modify the parameters in the SHELL.CFG of the OnQueue 
Task Server called PRINT HEADER=n and PRINT TAIL=n.  See 
your NetWare Installation manual for more information on 
configuring SHELL.CFG.


The next section contains technical information and error codes


*******************************************
Appendices
*******************************************

*******************************************
Appendix A - Specifications
*******************************************

Maximum Number of tasks in a Task Queue = 250

Maximum Number of Task Queues that can be attached to a
single OnQueue Task Server = 25

Maximum Number of OnQueue Task Servers that can be 
assigned to a single Task Queue = 25

Maximum Number of file servers that can be serviced 
by an OnQueue-M = 8

Size in kilobytes of the OnQueue Task Server which stays 
memory resident while executing users task excluding 
command.com and environment settings = 2.5Kb

*******************************************
Appendix B - Environment Variables
*******************************************

*******************************************
OnQueue Task Server Environment Variables
*******************************************
ONQUEUE_PATH
*******************************************
Specifies the location of the OnQueue Task Server files on 
the dedicated workstation.  If this variable is not specified, 
C:\ONQUEUE is used by default.

*******************************************
ONQUEUE_USER_ENV_MEM
*******************************************
Specifies the amount of memory set aside to restore the user 
submitted DOS environment variables when executing tasks by 
the OnQueue Task Server (default=2Kb).

*******************************************
ONQUEUE_ENV_MEM
*******************************************
Specifies the amount of memory set aside by the Task Server for 
batch file setting of environment variables when executing a batch 
file task by the OnQueue Task Server (default=2Kb).

*******************************************
ONQUEUE_LOG_FILE
*******************************************
The OnQueue Task Server supports a log file which captures all screen output.  This feature allows the 
network manager to monitor tasks.  The syntax for turning on this feature is:SET 
ONQUEUE_LOG_FILE=FILE_SERVER_NAME\VOLUME_NAME:NET_DIR\SUB_DIR\FILENAME.
EXT
The directory specified should be 
one where the group, 
EVERYONE, has access rights.  
The file server must be the 
primary file server that the Task 
Server is logged into.

User Workstation Environment Variables
TASKCON_DEFAULTS
Changes the OnQueue Task 
Console program defaults.  The 
same syntax that is used to 
submit tasks from the DOS 
command line, applies here.  For 
example, if you want to set the 
default queue to TASKQ_1 and 
you don't want completion 
messages sent to your 
workstation, specify:
SET TASKCON_DEFAULTS=
/Q:TASKQ_1 /NM

TASKCON_COLOR
Instructs TASKCON to run in 
monochrome mode.

SET TASKCON_COLOR = 
MONO

*******************************************
Appendix C - OnQueue Installation 
Alternatives
*******************************************

The following sections describe the procedure to follow in order to 
install OnQueue on either a floppy based workstation or a diskless 
workstation.
*******************************************
Installing OnQueue on a Floppy Based Workstation
*******************************************
If you want to install OnQueue on a floppy based workstation, do not 
use the built in installation program.  The OnQueue installation 
procedure is designed to install to a system with a hard drive.  To 
install OnQueue on a floppy based workstation follow the steps 
outlined below:
1) Insert the OnQueue Master diskette in your floppy based 
workstation.  This example uses drive B: for OnQueue.
2) Login as SUPERVISOR.
3) Copy the TASKCON files to the file server on volume SYS in the 
directory, PUBLIC (this example has the OnQueue floppy in drive B: 
and the floppy that the workstation will boot from in drive A:) by 
issuing:        COPY B:\TASKCON\*.* F:\PUBLIC.
4) Copy the OnQueue files to a directory on your floppy boot disk.  
For example, suppose the directory is A:\ONQUEUE.  Then issue:
	COPY B:\ONQUEUE\*.* A:\ONQUEUE.
5) Make sure that the autoexec.bat file on your boot disk sets 
ONQUEUE_PATH.  Set any other OnQueue optional environment 
variables here as well.  When installing to drive A:, use:      SET 
ONQUEUE_PATH=A:\ONQUEUE.
6) Create at least one queue by invoking TASKCON and selecting 
Queue Information.  Then press <Ins> and enter TASKQ_1 as your 
task queue.  (For more information, see the section, Queue 
Management.)
7) Create the Task Server by invoking TASKCON and selecting Task 
Server Information.  Press <Ins> and enter the name, 
TASK_SERVER_1, and serial number of your task server.  Then 
attach the queue, TASKQ_1, to this server.  (For more information, 
see the section, Task Server Management.)
8) Reboot your floppy based workstation.  After loading ipx/odi 
drivers and netx, invoke OnQueue by typing A:\OnQueue\OnQueue.
*******************************************
Installing OnQueue on a Diskless Workstation
*******************************************
If you want to install OnQueue on a diskless workstation, do not use 
the built in installation program.  The OnQueue installation 
procedure is designed to install to a system with a hard drive.  To 
install OnQueue on a diskless workstation, a RAM drive must be 
used.  Follow the steps outlined below:
1) Insert the OnQueue Master diskette in any workstation on the 
network.  Drive A: is used in this example.
2) Login as SUPERVISOR.
3) Copy the TASKCON files to the file server on volume SYS by 
issuing:        COPY A:\TASKCON\*.* F:\PUBLIC.
4) Use SYSCON and create a user name that is the same as the 
name you will use for the task server.  For example, suppose you 
plan to call the task server, TSERV_1.  Use SYSCON to create a 
user with the name, TSERV_1.  Create the home directory 
associated with this new user.
5) Copy the OnQueue files to the home directory.  For example, if 
the home directory is F:\USR\TSERV_1, then issue:       COPY 
A:\ONQUEUE\*.* F:\USR\TSERV_1.
6) Make sure that the autoexec.bat file found in the home directory 
sets the OnQUEUE_PATH.  It must also copy OnQueue.EXE and 
OnQueueC.EXE from the F:\USR\TSERV_1 directory to the RAM 
drive.  Set any other OnQueue optional environment variables here 
as well.  In our example:       SET ONQUEUE_PATH=E:, where E: is 
the RAM drive.
7) Create at least one queue by invoking TASKCON, and selecting 
Queue Information.  Then press <Ins> and enter TASKQ_1 as your 
task queue. (For more information, see the section, Queue 
Management.)
8) Create the Task Server by invoking TASKCON and selecting Task 
Server Information.  Press <Ins> and enter the name, TSERV_1, 
and serial number of your task server.  Then attach the queue, 
TASKQ_1, to this server. (For more information, see the section, 
Task Server Management.)
9) Reboot your diskless workstation.  Login as TSERV_1.  After 
login, change the current working directory to the home directory, 
F:\USR\TSERV_1.  Then invoke OnQueue by typing OnQueue.

*******************************************
Appendix D - OnQueue Software Removal
*******************************************

To remove a licensed or demo version of OnQueue you must login 
as supervisor and delete all task queues and task servers known to 
TASKCON.  The following example removes a demo version of 
OnQueue:
1) LOGIN as supervisor on any workstation.
2) Invoke TASKCON and, using the appropriate menu selections, 
delete the task queue(s).  Then delete the task server.  Then exit 
TASKCON.
3) Change Drives/Directories so that you are on Volume SYS in the 
directory, PUBLIC.  Then delete these six files:
1.      TASKCON.EXE
2.      TASKCONC.EXE
3.      TASKCON.HLP
4.      TASKCON$.ER
5.      TASKCON$.HLP
6.      TASKCON$.MS
4) Then, on the workstation that was used as the OnQueue Task 
Server, delete the files found in the C:\OnQueue directory.  Then 
remove the directory.

*******************************************
Appendix E - Error Codes
*******************************************

TA <num>: <error_string> where <num> and <error_string> are 
defined as follows:  
<num>
<error_string> 

TA01
A bad command line parameter was found

TA02
No task was found

TA03
A bad queue name was specified

TA04
The queue exists but user has no access rights

TA05
The specified Task Server does not exist

TA06
The specified Task Server is not assigned to this
 queue

TA09
Bad date specified

TA10
No queue could be found

TA11
The repeat every interval time specified was not valid

TA12
The File Server specified is not attached

*******************************************
OnQueue Task Server Error Codes
*******************************************
TS<num>: <error_string> where <num> and <error_string> are 
defined as follows:
<num>
<error_string>

TS01
Memory re-allocation failure: - The DOS memory 
re-allocation call failed.  Ensure that there is 
sufficient memory for OnQueue and check for 
TSRs that may interfere with its operation.

TS02
Could not spawn - OnQueue was unable to 
execute its child task or the user's requested 
task.  This may be due to insufficient memory.  
Also check for TSRs that may interfere with 
proper operation.

TS03
Unable to redirect output - error code: - OnQueue 
was unable to redirect standard output to the 
requested file.  There may have been no rights 
to this file or the path may have been incorrect. 
Also try repeating the operation using 
command.com.

TS04
Unable to restore output - error code: - OnQueue 
was unable to restore output to the console.

TS05
DOS critical error - function failed - While 
performing a request, a DOS critical error 
occurred.

TS10
No COMSPEC variable was found in the 
environment - Your environment must specify 
where command.com is found.  Check that  
your autoexec.bat does not delete this from the 
environment.  If command.com is not located 
in your root directory  you can specify its 
location in your config.sys file.

TS11
No ONQUEUE_PATH variable was found in the 
environment - You must specify the directory 
path of your OnQueue.exe and OnQueueC.exe 
files in the DOS environment.  To do this, add 
the following to your autoexec.bat file: 
SET ONQUEUE_PATH=your_path.

TS12
No PATH variable was found in the environment 
- Your DOS environment must specify a PATH.  
As a minimum, add PATH=C:\ to your 
autoexec.bat.

TS13
Unable to create child handle - error code:

TS14
Invalid Command Line Parameters - You have 
specified the incorrect number of command 
line arguments or illegal options.  For the 
correct syntax please see the section, Booting 
an OnQueue Task Server.

TS15
Invalid Serial Number - Please call NetPlus 
Software with the information output by 
OnQueue for additional assistance.

TS16
Command line arguments too long - The 
command line arguments passed are longer 
than allowed.  For the correct syntax please 
see the section, Booting an OnQueue Task 
Server.

TS17
Must be DOS 3.1 or higher

TS101
Couldn't set control break handler - OnQueue 
was unable to set its control break handler.

TS102
Warning - Could not open log file - The log file 
specified could not be opened.  This warning 
may occasionally occur if the log file is 
currently being used by a NetWare user.  If it 
occurs repeatedly, there may have been no 
rights to this file or the path may have been 
incorrect.

TS103
No COMSPEC found in environment - Your 
environment must specify where 
command.com is to be found.  Check that  
your autoexec.bat does not delete this from the 
environment.  If command.com is not located 
in your root directory  you can specify its 
location in your config.sys file.

TS104
Wrong Number of Parameters passed - You 
have specified an incorrect number of 
command line arguments or illegal options.  
Please see the section, Booting an OnQueue 
Task Server for the correct syntax.

TS105
Illegal Parameters passed - You have specified 
an incorrect number of command line 
arguments or illegal options.  Please see the 
section, Booting an OnQueue Task Server for 
the correct syntax.

TS106
Task Server unable to Login - Check that the 
specified Task Server name and file server 
name are correct.  Check that the appropriate 
NetWare shells have been loaded before 
booting OnQueue.  Please see the section, 
Booting an OnQueue Task Server.  You can 
also verify access to the server by logging in 
as a user.

TS107
Task Server unable to get connection information 
- Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server.

TS108
Task Server failed to read status information - 
Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server. 

TS109
Task Server serial number does not match - The 
serial number of this copy of OnQueue does 
not match that specified for the TASK Server 
name specified.  Login as supervisor and use 
TASKCON to determine the Task Server name 
assigned to this serial number.  If this is 
correct, check that the appropriate NetWare 
shells have been loaded before booting 
OnQueue.  Please see the section, Booting an 
OnQueue Task Server. 

TS110
Task Server failed to read queue information - 
The most likely cause of this error is that no 
queues are attached to this Task Server.  If 
TASKCON shows that there are queues, it is 
possible the Task Server record has become 
corrupt.  Try deleting the Task Server using 
TASKCON and then reinserting it and 
reassigning all queues.

TS111
Task Server failed to attach to queue - OnQueue 
attempted to attach to a queue unsuccessfully.  
OnQueue will still attach to other queues 
specified.  If this continuously occurs, delete 
the queue using TASKCON and reinstall it into 
the Task Server. 

TS112
No queues successfully attached - The most 
likely cause of this error is that no queues are 
attached to this Task Server.  If TASKCON 
shows that there are queues, it is possible the 
Task Server record has become corrupt.  Try 
deleting the Task Server using TASKCON and 
then reinserting it and reassigning all queues.

TS113
Task Server unable to get connection information 
- Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server. 

TS114
Task Server failed to read status information - 
Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server. 

TS115
Task Server failed to read queue information - If 
this repetitively occurs, it is possible the Task 
Server record has become corrupt.  Try 
deleting the Task Server using TASKCON and 
then reinserting it and reassigning all queues.

TS116
Task Server failed to detach from queue - 
OnQueue found it was not attached to a 
specified queue.  This is probably the result of 
not attaching to the queue during the boot 
process.

TS117
Unable to read queue task entry - see 
accompanying NetWare error.

TS118
Unable to restore server rights on task 
completion - see accompanying NetWare 
error.  This error occurs when a submitted 
batch file logs into the NetWare file server as 
part of it's actions.  The Task Server should 
successfully reattach to the NetWare file 
server, so this error can be ignored.

TS119
Error posting task completed - see 
accompanying NetWare error. This error 
occurs when a submitted batch file logs into 
the NetWare file server as part of it's actions.  
The Task Server should successfully reattach 
to the NetWare file server, so this error can be 
ignored.

TS120
Unable to change to default directory - The 
default directory may not exist.  OnQueue will 
still attempt to execute the task.

TS121
Unable to change to default drive -  The default 
drive may not exist.  Operation should continue 
normally.

TS122
Task Server unable to get connection information 
- Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server.

TS123
Task Server failed to read it's queue property 
information - If this repetitively occurs, it is 
possible the Task Server record has become 
corrupt.  Try deleting the Task Server using 
TASKCON and then reinserting it and 
reassigning all queues.

TS124
Error getting task - An error occurred while 
getting the task.  See accompanying NetWare 
error.  Normal operation should continue.

TS125
Error duping task handle - The Task Server was 
unable to save the task file handle.

TS126
Unable to change to client rights - After obtaining 
the task information, OnQueue was unable to 
change to the network rights of the user who 
submitted it.  One possible cause for this error 
could be the user no longer exists.

TS127
Unable to get task size - An error occurred 
obtaining some of the task's information.  This 
could be due to an error that occurred when 
the task was submitted.

TS128
Directory record was smaller than expected - see 
TS127.

TS129
Work DIR record was smaller than expected - 
see TS127.

TS130
Warning - Unable to change to requested 
directory -The working directory may not exist.  
Operation should continue normally.

TS131
Warning - Unable to change to requested drive - 
The working directory's drive may not exist.  
Operation should continue normally.

TS132
Drive vector record was smaller than expected - 
see TS127.

TS133
Path record was smaller than expected - see 
TS127.

TS134
Path record was smaller than expected - see 
TS127.

TS135
Insufficient Memory to complete action

TS136
Path record was smaller than expected - see 
TS127.

TS137
Path record was smaller than expected - see 
TS127.

TS138
Unable to set drive path - OnQueue was unable 
to re-store the search path to the search path 
present when the user submitted the task.

TS139
Warning - Unable to find one or more drive paths 
- OnQueue was unable to locate and restore 
one or more drive paths when setting the drive 
paths to those present when the user 
submitted the task.

TS140
Unable to find specified File Server - Check that 
the specified file server name is correct.   
Check that the appropriate NetWare shells 
have been loaded before booting OnQueue.  
Please see the section, Booting an OnQueue 
Task Server.  You can also verify access to the 
server by logging in as a user.

TS141
Task Server unable to login with this name - 
Check that the specified Task Server name 
and file server name are correct.  If more than 
one file server exists on the network,  the 
name of the file server must be specified in 
order for OnQueue to login.   Check that the 
appropriate NetWare shells have been loaded 
before booting OnQueue.  Please see the 
section, Booting an OnQueue Task Server.

TS142
A Task Server with this name is already logged 
in - The Task Server name specified has been 
used by another OnQueue Task Server to 
login.  Only one copy of OnQueue with the 
same serial number may be run at the same 
time.  Check that the specified Task Server 
name and file server name are correct.  Please 
see the section, Booting an OnQueue Task 
Server.

TS143
 Capture information was smaller than expected - 
see TS127.

TS144
Warning - Unable to set Capture information - 
OnQueue was unable to restore the print 
capture to that present when the user 
submitted the task.

TS145
 Warning - Not attached to the capture queue's 
server -OnQueue was not attached to the file 
server used to service one or more specified 
print queues.  OnQueue can only restore the 
user's print capture settings which were 
directed to the same file server that OnQueue 
is attached to.

TS146
Path record was smaller than expected - see 
TS127.

TS147
Unable to set drive path - OnQueue was unable 
to restore the search path to the search path 
present when the user submitted the task.

TS148
Capture information was smaller than expected - 
see TS127.

TS149
Error setting task file mode - see TS127.

TS150
Connection Server information was smaller than 
expected - see TS127.

TS151
Warning - Unable to set Capture information - 
see TS144.

TS152
Unable to read task description file see TS127

TS153
Path record was smaller than expected see 
TS127

TS154
Unable to set drive path - see TS138.

TS155
Environment information was smaller than 
expected - see TS127.

TS156
Environment information was smaller than 
expected - see TS127.

TS157
Environment information was smaller than 
expected - see TS127.

TS158
Unable to create new daily task - The OnQueue 
Task Server was unable to duplicate the task 
submitted as a daily task.  Check the original 
task that was submitted and determine if it was 
a valid task.

TS159
Unable to create new daily task - see TS158

TS160
Unable to create new daily task - see TS158

TS161
Unable to create new daily task - see TS158

TS162
Unable to read execution time bitmap - see 
accompanying NetWare error.  If this occurs 
repeatedly, it is possible the object has 
become corrupt.  Try deleting the object using 
TASKCON and then reinserting it and 
reassigning all queues.

TS163
Unable to read queue property - see 
accompanying NetWare error.  If this occurs 
repeatedly, it is possible the queue record has 
become corrupt.  Try deleting the queue using 
TASKCON and then reinserting it and 
reassigning all Task Servers.

TS164
Could not open log file - The log file specified 
could not be opened.  Check to see that the file 
server specified for the log file is the same as 
the file server where the queues the OnQueue 
Task Server is servicing are located.  Also see 
NetWare accompanying error.

TS165
Warning - Unable to get Capture information.  
The task server was unable to read back the 
capture flag information from NetWare. - See 
Netware accompanying error.

TS166
Shell Version Too Old.  The NetWare shell being 
used was too old too perform the requested 
function.  It is recommended you update the 
NetWare shells being used on the Task Sever.

TS167
Warning - Repeat job had no repeat time 
specified - The job was specified as weekly or 
monthly repeat yet no bits were set in the 
repeat bitmap.  As a result, the job was only 
executed once and not resubmitted for 
repetative execution.

TS168
 Warning - Insufficient Memory to complete 
action.

TS169
Warning - Insufficient environment space to 
complete action - The Task Server 
environment space was not large enough to 
store all of the user environment variables 
specified.  Try increasing the value of 
ONQUEUE_USER_ENV_MEM and restarting 
the Task Server.

TS170
Warning - Insufficient environment space to 
complete action - see TS169.

TS171
Task Server unable to get client connection 
information - The task server was unable to 
send a message to the user who submitted 
the job because it failed to get the user's 
connection information. 

TS172
Task Server can't get connection to main file 
server - The Task Server lost it's connection 
or could not verify it's connection to the file 
server it initially logged into.  This may be 
due to a task that was submitted detaching 
this connection.  It also may be because the 
bindery was temporarily locked.  The Task 
Server will automatically try to re-establish 
connection.  See the acompanying NetWare 
error for more information.

TS173
Unable to find specified File Server - The Task 
Server was unable to attach to the specified 
File Server that was to be serviced. Check 
that the specified file server name is correct 
and that it is currently running.

TS174
Task Server was unable to read other file 
servers - The Task Server was unable to 
read the property telling it what other file 
servers to log into.  If the task server record 
was created with an ealier version of the 
OnQueue this property will not exist.  To add 
this property, use TASKCON.  Select the 
task server information for this Task Server.  
Select File Servers to be Services.  Press 
insert. The property will be created.  You 
may also add other file servers to be 
serviced or simply hit multiple escapes to 
leave the menus.

TS175
Could not open log file - The specified File 
Server for the log file could not be found.  
Check that the specified file server namin the 
logfile path specification is correct and that 
the file server currently running.

TS176
Unable to set default directory - The default 
directory may not exist.  The Task Server 
was unable to allocate a handle to the 
specified NetWare path.  Operation should 
continue normally.

TS177
Error duping sent task handle - The Task 
Server was unable to restore the saved task 
handle.

TS178
Task not found or path invalid - The task 
specified could not be located in the working 
directory or the path.  If a full path 
specification is specified, OnQueue will only 
check for the task there.  If a file is specified 
only, OnQueue checks the working directory 
first and then the path.  If no extensions are 
specified, OnQueue will look for a .com, .exe 
and finally a .bat.  The first one found will be 
executed but if none are found this message 
is produced.

TS179
The Task Server DOS environment space is 
too small - The task server could not 
complete it's operation because the DOS 
environment space is too small.  Increase 
the size of the DOS environment.

TS180
The Task Server DOS environment space is 
too small - see TS179

TS181
Unable to find specified File Server -  see TS 
140

TS182
Path record was larger than expected -  see 
TS 127

TS183
Warning - Insufficient Memory to complete 
action - see TS168

TS184
Task Server program mismatch

TS185
Unable to find specified File Server - see 
TS118

TS186
Task Server can't get connection to main file 
server - see TS172

TS187
Task Server can't get connection to main file 
server - see TS172





ORIGINAL INDEX IN MANUAL IS
KEPT IN THIS ASCII VERSION FOR YOUR REFERENCE:

Index
A
Accounting
When it appears, 34
Additional Task Servers
Installing, 12
Appendix A
Specifications, 49
Appendix B
Environment variables, 49
Appendix C
Error codes
Task Server, 54
Assigning File Servers
Task Server, 36
Assigning Queues
Task Server, 34
Assigning Security Equivilence
Task Server, 38
Autoexec.bat
Modifications to allow 
automatic booting as a Task 
Server, 17
Available File Servers, 37
B
Booting
Task Server
Autoexec.bat modifications 
to allow automatic 
booting as a Task Server, 
17
C
Changing a task, 26
Command Line
Examples, 22
Command.com
Using when submitting a task, 
44
Components
Required, 1
Concep ts and terminology
Task Queue, 5
Concepts and terminology, 4
OnQueue - The Dedicated 
Task Server, 4
OnQueue System, 5
OnQueue-M, 5
Task, 5
Task Queue Operator, 6
Task Queue User, 6
Taskcon, 6
Creating
A Task Server, 31
Creating a Queue, 24
Current queue entries, 25
Task deletion, 26
Current Queue Status, 27
Current Task Server Status, 35
Custom installation instructions, 
11
D
De-installation of OnQueue 
Software, 53
Dedicated Task Server
OnQueue, 4
Dedicating a Workstation, 3
Default installation instructions, 9
Defaults
Changing them, 22
Defer execution, 19
Delayed Execution, 2
Deleting
A Task Server, 31, 33
Deleting a Queue, 24
Deleting a task in a queue, 26
Deleting assigned File Servers
Task Server, 38
Deleting assigned Security 
Equivilence
Task Server, 39
Deleting Queues
Task Server, 34
DOS command line operation of 
Taskcon, 21
DOS command options, 21
DOS Environment variables
DOS SET command, 10, 12, 
13, 15, 17, 22, 41, 42, 43, 
45, 50
DOS SET command
DOS Environment variables, 
10, 12, 13, 15, 17, 22, 41, 
42, 43, 45, 50
Dual Floppy Systems
Making backups of software, 8
E
Environment
Task Server, 41, 44, 45, 46
Environment space
specifying, 41
Environment variables
Appendix B, 49
Error codes
Appendix C, 54
Executing a task, 41
Execution
Delayed, 2
Immediate, 2
F
Final Checklist, 47
First time installation
Custom, 11
Default, 9
Floppy Drives
Dual
Software backup 
instructions, 8
Single
Software backup 
instructions, 7
G
Group
Everyone, 6
I
Installation, 8
Removing OnQueue, 8
Installation Alternatives
Diskless workstation, 52
Floppy based workstation, 51
Installing
Additional Task Servers, 12
For first time, 9, 11
OnQueue software, 7, 8
Updating, 14
Introduction
Required components, 1
User guide highlights, 1
IPX, 17
IPXODI, 17
K
Key assignments
<Del>, 20
<Enter>, 20
<Esc>, 20
<F1>, 20
Left &  Right Arrows, 20
Up & Down Arrows, 20
Key assignments for Taskcon, 20
L
LAN driver, 17
Local drive
specifying for task submission, 
43
logfile, 17
M
Making Software backups, 7, 8
Managing a Task Server, 31
Managing rights to a Task Server, 
31
Mapped roots, 41
Menu operation of Taskcon, 19
Monochrome support
/m modifier at installation of 
Onqueue, 9
SET TASKCON_COLOR, 50
Multiple File Server Support
OnQueue-M, 5
Multiple File Server support
OnQueue-M, 32
Multiple Task Servers
Utilizing, 4
N
NET3, 17
NetWare 2.2, 3.X, 4.X, 1
NetWare user
Task Server management 
rights, 31
Network printing, 43
Network Supervisor
Using Taskcon, 6
No rights
Queue management, 23
Novell, 1
O
OnQueue, 4
Designating a Workstation, 3
Submitting a Task, 2
OnQueues Task Console 
Program
Taskcon, 19, 21
OnQueue defaults, 22
OnQueue Master Diskette
Making backups
Dual Floppy System 
Instructions, 8
Single Floppy System 
Instructions, 7
OnQueue Software
Installing, 7, 8
OnQueue Software Removal, 53
OnQueue System, 5
OnQueue Task Server
Booting, 17
OnQueue-M, 5
Multiple File Server support, 
32
Operation Overview & 
Terminology
Designating a Workstation, 3
OnQueue features, 2
Submitting a Task, 2
Operator rights
Queue management, 23
Options
Taskcon DOS command, 21
P
Peripherals
Of Task Server, 44
Printing
Redirecting output, 43
Priorities
Queues, 2, 4, 24, 34, 41
Problems?, 47
Q
Queue
Assigning queue operators, 28
Assigning queue users, 28
Attached Task Servers, 28
Creation, 24
Deletion, 24
Priorities, 4
High, 2
Removing queue operators, 28
Removing queue users, 28
Queue entries
Display, 25
Queue Entry Information, 26
Queue Information Menu, 25
Current Queue Status, 25
Currently Attached Task 
Servers, 25
Queue Information Menu
Current Queue Entries, 25
Queue Operators, 25
Queue Users, 25
Time Restrictions, 25
Queue management
levels, 23
None, 23
Operator, 23
rights, 23
Supervisor, 23
User, 23
Queue operators
Assigning, 28
Removing, 28
Queue Selection, 24
Queue Status, 27
Queue users
Assigning, 28
Removing, 28
R
Removal of OnQueue Software, 
53
Removing OnQueue, 8
Repeat installation, 12
Repeat options, 18, 21
Required components, 1
Restricting task execution
In a Task Server, 36
In queues, 29
Restrictions
By queue, 29
By Task Server, 36
S
Security Equivalence, 39
Selecting
A Task Server, 33
Selecting a queue, 24
Serial Number
Task Server, 32
Server Type
Multiple File Server, 33
SET
logfile, 17
Single Floppy Systems
Making backups of software, 7
Specifications
Appendix A, 49
Starting the Task Server, 10, 12, 
13, 14
Status viewing
Task Server, 35
Submitting a task to a local drive, 
43
Submitting a task to a queue, 25
Submitting tasks
With command.com, 44
Supervisor
Task Server management 
rights, 31
T
Task, 5
Defer execution, 19
Deletion, 26
Editing fields, 26
Information viewing, 27
Queue entries, 27
Submitting, 25
Task Console Program
Taskcon, 19, 21
Task Execution, 41
Task executions
Restrictions by queue, 29
Restrictions by Task Server, 36
Task Queue, 5
Task Queue Operator, 6
Task Queue User, 6
Task Server
Assigning File Servers, 36
Assigning Queues, 34
Assigning Security 
Equivilence, 38
Creating, 31
Deleting, 31
Deleting a Security 
Equivilence, 39
Deleting assigned File Servers, 
38
Deleting Queues, 34
Matching Parameters
Directory assignments, 41
Path, 41
User working directory, 41
Selecting, 33
Serial Number, 32
Server Type, 33
Starting, 10, 12, 13, 14
Status, 35
Status viewing, 35
What to type to start, 10, 12, 
13, 14
Workstation dedication, 3
Task Server Environment, 41
Task Server environment
Example 1
Compiler located on Task 
Server, 45
Example 2
Compiler located on 
Network File Server, 46
Specifying, 44, 45, 46
Task Server Execution Times, 29
Task Server Information, 32
Task Server Information Menu
Current Queues, 33
Current Server Status, 33
Task Server management, 31
Task Server management rights, 
31
NetWare user, 31
Supervisor, 31
Task Server peripherals, 44
Task Server Time Restrictions, 36
Task Server Type, 33
Task Servers
Multiple, 4
Queue attachment, 28
Task Submission, 18
Taskcon, 6
DOS command line operation
Command options, 21
Key assignments, 20
Menu operation, 19
Network Supervisors role, 6
OnQueues Task Console 
Program, 19, 21
Using the program, 19, 21
Time restrictions
By queue, 29
By Task Server, 36
Troublehsooting
Accounting option, 48
Troubleshooting tips, 47
Printing Problems, 48
Software, 47
Task Server, 47
U
Update installation, 14
User rights
Queue management, 23
V
Viewing information about a task, 
27
W
Workstation
Dedication as a Task Server, 3

Page: 2
 









9
Operation Overview & Terminology

22
Installing the OnQueue Software

29
Using TASKCON   

41
Queue Management        

54
Task Server Management  

63
The Task Server Environment     

67
Problems?       

92






`



