Usage

Optional

Format

Select Handle Output from the Do list box and specify the relevant sub-parameters.

The following sub-parameters are available for this parameter:

Option

Indicates what to do with the output data.

The options that can be selected in this list box are:

Computers other than z/OS:

• Copy
• Delete
• Move
• Print

z/OS:

• None
• Change jobs class
• Delete output
• Copy output
• Move output

File

Name of the file.

The format for this parameter is the same as specified for Output Handling. For more information about this parameter, see Action

Variable Support

A variable or expression can be specified as all or part of the value for this parameter.

Alternate names

• Control‑M/EM Utilities: HANDLEOUTPUT
• Control-M Report: (none)
• Control‑M/Server Utilities: ‑handleoutput
• Control‑M for z/OS: HANDLE OUTPUT
• Control‑M/EM API: handle_output

Alternate formats

Control‑M/EM Utilities

HANDLEOUTPUT is composed of the parameters below.

EXAMPLE: <HANDLEOUTPUT OPTION="ChangeClass" PAR="F" FROM="C"/>

OPTION

Indicates what to do with the Output data. Mandatory.

Valid values:

• Release
• Delete
• Copy
• Move

  NOTE: Copy and Move are not used with z/OS.

PAR

Certain OPTION values require that you supply additional information (such as Release, NewDest). The PAR parameter holds that information as a string.

FROM

Limits the Output handling operation to only Outputs from the specified class.

Control‑M for z/OS

Handle Output is composed of the parameters below.

OPT

Output option code. Mandatory.

Valid values:

• C – Change the class of the job output.
• D – Delete (purge) the job output.
• F – Copy the job output to file.
• N – Change destination of job output.
• R – Release the job output.

data

Relevant Output data. Mandatory and valid only if the specified OPT value is C, F, or N.

Valid values depend on the OPT value, as follows:

• F – File name. String comprised of from 1 through 44 characters. All characters are valid except blanks.
• C – New class (1 character). Any character is valid except blank, but an asterisk (*) indicates the original MSGCLASS of the job.
• N – New destination (1 through 8 characters). All characters are valid except blanks.

FRM

FROM class. Optional. Limits the Output handling operation to only Outputs from the specified class.