General
Application area: | Messages (system administration macro); see "Messages" |
Macro type: | Type S, MF format 1: 31-bit interface: standard/L/E/C/D form; |
System messages are assigned to the message files that contain them by means of the global class list. The class list contains all message classes (the first 3 characters of the message code) and the assigned names of the message files. The class list is created at system start time, and can be modified by system administration during normal operation using the MSGSINIT / MSGSMOD macros, or the MODIFY-MSG-FILE-ASSIGNMENT command.
A message file consists of a message work file and the corresponding HELP file (reduced message primary file).
Macro description
The MSGSINIT macro enables system administration to add a further message file to the message system or to prohibit access to a message file. The message class and name of the new message file are entered at the beginning of the class list. All references to a message file which is to be locked are deleted from the class list.
Modification of this list applies only to the current system run; the generation values are not changed. MSGSINIT enables system administration to activate or deactivate the MIP trace function.
Macro format and description of operands
MSGSINIT |
[FILE=ADD / DEL / STD] [,TRACE=ON / OFF] ,MF=S / C / (C,pre) / (E,...) / (D,pre) / D / L |
FILE=
This operand refers to the message file that is to be added or locked. The link name SMSGFILE must be assigned to the appropriate message work file before the macro call.
ADD
Message classes and the name of the message file are added at the beginning of the global class list.
DEL
All references to the message file to be locked are deleted from the class list.
STD
The STARTUP state is created for the class list.
TRACE=
The operand switches the MIP trace function on or off.
ON
The trace function is activated.
OFF
The trace function is deactivated.
MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. for a prefix), see section “S-type macros”. The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
A prefix (pre = 1 letter) can be specified in the C form or D form, as shown in the macro format. This prefix is inserted into all symbolic names of the CSECT/DSECT as the 4th character (after “INI”).
Default values: | pre = C for C form |
Return information and error flags
R15:
+---------------+ | | | | | |b|b| | | | |a|a| +---------------+
A return code relating to the execution of the MSGSINIT macro is transferred in the rightmost byte of register R15.
Ret.Code | Meaning |
X'00' | Normal execution |
X'04' | Error in the FILE operand: message file is not available or link name is not assigned |
X'08' | Operand error |
X'0C' | Error during access authorization check: the caller is not system administration (does |
X'10' | Resource limit: macro cannot be executed |
X'41' | MIP subsystem is not loaded |