General
Application area: | System files; see "System files" |
Macro type: | Type S, MF format 1: standard/E/L/C/D form; see "S-type macros" |
The (standard) file names SYSDTA, SYSCMD, SYSLST, SYSLST01, SYSLST02,..., SYSLST99 and SYSOUT denote files used by the operating system to input data and commands to the operating system or to output data via the operating system. These files are created by the appropriate task and specify input and output areas that were preset from the start.
The SYSFL macro allows users to revoke the primary assignment and assign their own (cataloged) files to the (standard) file names. Some of the standard names can also be equated.
Macro description
The SYSTA macro enables the user to issue the SHOW-SYSTEM-FILE-ASSIGNMENTS command via the macro interface of the macro command language processor (MCLP) without interrupting program mode (see section “Macro Command Language Processormacros” (Standard header)).
Messages concerning command processing are issued on SYSOUT and are also entered in a program area of the calling program. The SHOW-SYSTEM-FILE-ASSIGNMENTS command permits the user to receive information on the assignment of system files and the object module file (TASKLIB) for the dynamic binder loader.
Macro format and description of operands
SYSTA |
'([SYSCMD][,SYSDTA][,SYSOUT][,SYSLST][,SYSLST01][,SYSLST02]...[,SYSLST99][,TASKLIB])' [,addr / (r)] ,SYSOUT=YES / NO ,DIALOG=NO / YES [,PARMOD=24 / 31] [,MF=L / (E,..) / D / C] |
SYSCMD / SYSDTA / SYSOUT / SYSLST / SYSLST01 / SYSLST02 / .. / SYSLST99 / TASKLIB
Several system files, including TASKLIB, may be specified. Parentheses can be omitted if only one file is specified.If the operands are omitted, the user receives information about all system files and the TASKLIB. These operands must be enclosed in single quotes.
addr
Symbolic address (name) of a field to receive the SYSOUT log.
(r)
Register containing the address value “addr”.
This field must be aligned on a word boundary. The output record starts with the 4-byte record length field, which contains the record length in bytes 0-1. The record length field is followed by the output text.
Structure of the output area:
DS 0F
OUTPUT DC Y(AENDE-OUTPUT) Output area
SLF DS 0CL4 4 bytes: record length field
SL DS CL2 2 bytes: record length
DS CL2 2 bytes: reserved
TEXT DS CL300 Output text
AENDE EQU *
SYSOUT=
Specifies whether the log is also to be output to SYSOUT.
YES
Default setting: the log is also output to SYSOUT.
NO
The log is not output to SYSOUT.
In this case, the “addr” of the receiving field must be specified.
DIALOG
Specifies whether an error dialog is to be conducted if syntax errors are detected.
NO
Default setting: no error dialog is conducted.
YES
An error dialog is to be conducted.
Return information and error flags
Messages concerning command processing are part of the SYSOUT log, which is also transferred to the output area (“addr” operand).
R15:
+---------------+ | | | | | | | | | | | |a|a| +---------------+
A return code relating to the execution of the SYSTA macro up to command execution is transferred in the rightmost byte of register R15.
X'aa' | Meaning |
X'00' | Normal termination. |
X'04' | Insufficient memory area is available; the request was not carried out. |
X'08' | Error in the operand list (address area). |
X'0C' | The last output record entered in the user area is truncated. |
X'10' | Macro/command error (the command returned an error to the MCLP). |