/XTASK Command

The /XTASK command can control the Cross-Platform Scheduling Router (Router) and the CA Workload Automation SE Cross-Platform Tracking System (Tracker).

Note: /XTASK can be used with the CA Workload Automation SE Cross-Platform Tracking System only if that system runs in the CA Workload Automation SE address space.

The router and the tracker (if it runs in the CA Workload Automation SE address space) are started automatically when CA Workload Automation SE initializes. You can manually stop and restart these tasks using /XTASK.

To stop an active cross-platform scheduling task, use the CMD function to send a STOP command to the task. You can use the ADD function to restart the task if necessary.

The CA Workload Automation SE cross-platform tracking system recognizes other commands besides STOP. These are documented in the Interface Reference Guide. STOP is the only command that is recognized by the cross-platform scheduling router.

The router and the tracker run as subtasks when they run in the CA Workload Automation SE address space. CA Workload Automation SE does not wait for the subtask to return the results of the command but continues to perform its primary task of scheduling jobs. To see the output from the /XTASK command, you must browse the CA Workload Automation SE job log because the output does not appear online. For Tracker commands, the results are also written to the XPRINT DD statement.

This command has the following format:

►►─ /XTASK ───────────────────────────────────────────────────────────────────►

 ►─ , ─┬─ M ───┬─ =(function-name,task-name ─┬─────────────────┬─ ) ──────────►◄
       └─ MSG ─┘                             └─ ,command-text ─┘

MSG

Identifies the input for a cross-platform task. The value of MSG must be a comma-delimited sublist enclosed in parentheses.

function-name

Indicates the first element in the sublist is the name of the function. This is a required element. Valid function names are the following:

ADD: Uses this value to start a cross-platform scheduling task.
CMD: Uses this value to send a command to a cross-platform scheduling task.

task-name

Indicates the second element in the sublist is the name of the task that is the target of the function. This is a required element. Valid task names include the following:

ROUTER: Indicates the cross-platform scheduling router.
TRACKER: Indicates the CA Workload Automation SE cross-platform tracking system.

command-text

(Optional) Indicates the third element in the sublist is the text of the command to be sent to the task. It is required only when the function name is CMD. Valid values include the following:

STOP: Terminates a cross-platform scheduling task.

The CA Workload Automation SE cross platform tracking system (XTRK) may recognize other values. These values are documented in the Interface Reference Guide.