Task options
The task options are listed in Table 1. An X means that the option is valid for the task.
| Task | -c | -n | -p | -r | -s | -d | -l | -o | -j | -q | -w | -S | Task String |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| LJ | X | X | X | X | X | X | X | X | X | X | ljstring | ||
| MJ | X | X | X | X | X | X | X | X | X | mjstring | |||
| CF | X | X | X | X | cfstring | ||||||||
| GS | X | X | X | X | X | X | gsstring |
- -c xagent,host,master
- Specifies the names of the agent, the host, and the master domain manager separated by commas.
- -n nodename
- Specifies the node name of the computer associated with the 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 agent, if any. This is defined in the agent workstation definition TCP Address field.
- -r currentrun,specificrun
- Specifies the current run number of HCL Workload Automation 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 HCL Workload Automation, 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 HCL Workload Automation 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 HCL Workload Automation by the method in a message indicating a job state change %CJ (for additional details on messages indicating job state change, see Method response messages ) following to an 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 HCL Workload Automation 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 HCL Workload Automation in a %CJ response to a previous GS task.