With %OUT you define the media via which data is to be output and whether output is to contain additional information, in conjunction with the output commands %DISASSEMBLE, %DISPLAY, %HELP, %SDUMP and %TRACE.
With target-cmd you specify the output command for which you want to define medium-a-quantity.
With medium-a-quantity you specify which output media are to be used and whether or not additional information is to be output.
Command | Operand |
%OUT | [target-cmd [medium-a-quantity][,...] ] |
In the case of %DISPLAY, %HELP and %SDUMP commands, you may specify a
medium-a-quantity operand which for these commands temporarily deactivates the declarations of the %OUT command. %DISASSEMBLE and %TRACE include no medium-a-quantity operand of their own; their output can only be controlled with the aid of the %OUT command. Before selecting a file as the output medium via %OUT, you must issue the %OUTFILE command to assign the file to a link name and open it; otherwise AID creates a default output file with the name AID.OUTFILE.Fn.
The declarations made with the %OUT command are valid until overwritten by a new %OUT command, or until /LOGOFF or /EXIT-JOB.
An %OUT command without operands assumes the default value T=MAX for all targetcommands.
%OUT may only be specified as an individual command, i.e. it may not be part of a command sequence or subcommand.
%OUT does not alter the program state.
target-cmd |
designates the command for which the declarations are to apply. Any of the commands listed below may be specified.
{ %D[IS]A[SSEMBLE] | %D[ISPLAY] | %H[ELP] | %SD[UMP] | %T[RACE] }
medium-a-quantity |
In conjunction with target-cmd this specifies the medium or media via which output is to take place, as well as whether or not AID is to output additional information pertaining to the AID work area, the current interrupt point and the data to be output.
If the medium-a-quantity operand has been omitted, the default value T=MAX applies for target-cmd.
medium-a-quantity-OPERAND - - - - - - - - - - - - - - - - - - - - - - - - -
{T | H | Fn | P } = {MAX | MIN | XMAX | XFLAT }
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
medium-a-quantity is described in full detail in the AID Core Manual (Related publications) [1].
T | Terminal output |
H | Hardcopy output (includes terminal output and cannot be specified together with T) |
Fn | File output |
P | Output to SYSLST |
AID does not take into account XMAX and XFLAT modes for outputting the %OUT log. Instead, it generates the default value (T=MAX).
MAX | Output with additional information |
MIN | Output without additional information |
XMAX | Definition of XMAX mode for the corresponding command %DISASSEMBLE, %DISPLAY, %HELP, %SDUMP or %TRACE. |
XFLAT | Definition of XFLAT mode for the corresponding command %DISASSEMBLE, %DISPLAY, %HELP, %SDUMP or %TRACE. |
Examples
%OUT %SDUMP T=MIN,F1=MAX
Data output of the %SDUMP command should be output on the terminal in abbreviated form, and in parallel to this also to the file with link name F1, along with additional information.%OUT %TRACE F1=MAX
The TRACE log with additional information is output only to the file with link name F1.%OUT %TRACE
For the %TRACE command, this specifies that previous declarations for output of data are erased, and that the default value T=MAX applies.