************************************************* 
*                                               * 
*          OnQueue(TM) Taskcon                  * 
*            Reference Card                     * 
*                                               * 
************************************************* 
		       
 
 
************************************************* 
*        TASKCON 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 Server Path] 
  /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 queue's 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 every days:hours:minutes 
/S:task_server_name  specify a Task Server to 
		     execute the task 
 /T: HH:MM           execution time of day in format shown
 /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  it's   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

