Task options

The task options are listed in Table 1. An X means that the option is valid for the task.

-c xagent,host,master

Specifies the names of the extended agent, the host, and the master domain manager separated by commas.

-n nodename

Specifies the node name of the computer associated with the extended agent, if any. This is defined in the extended agent's workstation definition Node field.

-p portnumber

Specifies the TCP/IP port number associated with the extended agent, if any. This is defined in the extended agent's workstation definition TCP Address field.

-r currentrun,specificrun

Specifies the current run number of Tivoli Workload Scheduler and the specific run number associated with the job separated by a comma. The current and specific run numbers might be different if the job was carried forward from an earlier run.

-s jstream

Specifies the name of the job's job stream.

-d scheddate,epoch

Specifies the job stream date (yymmdd) and the epoch equivalent, separated by a comma.

-l user

Specifies the job's user name. This is defined in the job definition Logon field.

-o stdlist

Specifies the full path name of the job's standard list file. Any output from the job must be written to this file.

-j jobname,id

Specifies the job's name and the unique identifier assigned by Tivoli Workload Scheduler, separated by a comma. The name is defined in the job definition Job Name field.

-q qualifier

Specifies the qualifier to be used in a test command issued by the method against the file.

-w timeout

Specifies the amount of time, in seconds, that Tivoli Workload Scheduler waits to get a reply on an external job before sending a SIGTERM signal to the access method. The default is 300.

-S new name

Specifies that the job is rerun using this name in place of the original job name. Within a job script, you can use the jobinfo command to return the job name and run the script differently for each iteration.

-- ljstring

Used with the LJ task. The string from the Script File or Command field of the job definition.

-- mjstring

Used with the MJ task. The information provided to the Tivoli Workload Scheduler by the method in a message indicating a job state change %CJ (see Method response messages for additional details on messages indicating job state change) following to a LJ task. Usually, this identifies the job that was launched. For example, a UNIX method can provide the process identification (PID) of the job it launched, which is then sent by the Tivoli Workload Scheduler as part of an MJ task.

-- cfstring

Used with the CF task. For a file opens dependency, the string from the Opens Files field of the job stream definition.

-- gsstring

Used with the GS task. Specifies the job whose status is checked. The format is as follows:

followsjob[,jobid]

where:

followsjob

The string from the Follows Sched/Job list of the job stream definition.

jobid

An optional job identifier received by Tivoli Workload Scheduler in a %CJ response to a previous GS task.