%OUTFILE assigns output files to AID link names F0 through F7 or closes output files. You can write output of the commands %DISASSEMBLE, %DISPLAY, %HELP, %SDUMP and %TRACE to these files by specifying the corresponding link name in the medium-a-quantity operand of %OUT, %DISPLAY, %HELP or %SDUMP. If a file does not yet exist, AID will make an entry for it in the catalog and then open it.
When information which is available in UTF16/ UTFE is output, AID takes into account the CCSN of the output medium and performs the requisite conversion. UTFE and all 1-byte EBCDIC encodings which are supported by XHCS are permitted as CCSNs. %SHOW %CCSN enables the OUTFILEs currently assigned to be displayed with the CCSNs used by AID.
With link you select a link name for the file to be cataloged and opened or closed.
With file you designate the output file.
Command | Operand |
%OUTFILE | [link [ = file]] |
If you do not specify the file operand, this causes AID to close the file designated using link. In this way an intermediate status of the file can be printed during debugging.
An %OUTFILE without operands closes all open AID output files. If you have not explicitly closed an AID output file using the %OUTFILE command, the file will remain open until /LOGOFF or /EXIT-JOB.
Without %OUTFILE, you have two options of creating and assigning AID output files:
Enter an ADD-FILE-LINK command for a link name Fn which has not yet been reserved. Then AID opens this file when the first output command for this link name is issued.
Leave the creation, assignment and opening of files to AID. AID then uses default file names with the format AID.OUTFILE.Fn corresponding to link name Fn.
%OUTFILE does not alter the program state.
If a file does not have a CCSN itself, AID uses the CCSN selected via %AID EBCDIC when character conversion is required. If the file’s CCSN is not permissible for AID and if character conversion is required, e.g. because the input medium is of the type UTFE, no output takes place.
link |
Designates one of the AID link names for output files and has the format Fn, where n is a number with a value 0 ≤ n ≤ 7.
The REP records for the %MOVE command are written to the output file with link name F6 (see also the %AID and %MOVE commands). Care should therefore be taken that no other outputs are allowed to be written to the file with link name F6.
tDDDDDDh
file |
specifies the fully-qualified file name with which AID catalogs and opens the output file. Use of an %OUTFILE command without the file operand closes the file assigned to link name Fn.