/XTASK Command

The /XTASK command can control the Cross-Platform Scheduling Router (Router) and the CA WA CA 7 Edition Cross-Platform Tracking System (Tracker).

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

The router and the tracker (if it runs in the CA WA CA 7 Edition address space) are started automatically when CA WA CA 7 Edition 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 WA CA 7 Edition cross-platform tracking system recognizes other commands besides STOP. These commands are documented in the Interface Reference Guide. STOP is the only command that the cross-platform scheduling router recognizes.

The router and the tracker run as subtasks when they run in the CA WA CA 7 Edition address space. CA WA CA 7 Edition 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, browse the CA WA CA 7 Edition 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|MSG}=(function-name,task-name[,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 that the first element in the sublist is the name of the function. This value is a required element. Valid function names are the following values:

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 that the second element in the sublist is the name of the task that is the target of the function. This value is a required element. Valid task names include the following values:

ROUTER: Indicates the cross-platform scheduling router.
TRACKER: Indicates the CA WA CA 7 Edition cross-platform tracking system.

command-text

(Optional) Indicates that the third element in the sublist is the text of the command to send to the task. This value is required only when the function name is CMD. Valid values include the following values:

STOP: Terminates a cross-platform scheduling task.

The CA WA CA 7 Edition cross platform tracking system (XTRK) sometimes recognizes other values. These values are documented in the Interface Reference Guide.