General
Application area: | Messages; see "Messages" |
Macro type: | Type S, MF format 1: standard/L/E/C/D form; see "S-type macros" |
Message files can be assigned a scope (system-wide or task-specific). Nonprivileged users can use their own message files for message output restricted to their own tasks. In addition, it is possible to specify the language which is to be given preference when selecting the message texts for output. Message files and the language specification are included in the message system either by means of the MSGSMOD macro or the MODIFY-MSG-FILE-ASSIGNMENT command.
The SHOW-MSG-FILE-ASSIGNMENT command corresponds to the MSGSHOW macro. For further information on the commands, see the “Commands” manual [19 (Related publications)].
Macro description
The MSGSHOW macro provides information about the following:
number of message files (system-wide, task-specific)
language used for message output (system-wide, task-specific)
names of message files; each name is preceded by an indicator of the access method (DLAM, ISAM). System message files are listed first, followed by the task-specific message files.
An example of the layout of the output is given following the description of operands.
Macro format and description of operands
MSGSHOW |
BUFFER= (length, {addr / (r)}) ,SCOPE=BOTH / SYSTEM / TASK ,MF=S / C / (C,pre) / (E,...) / (D,pre) / D / L |
BUFFER=
Specifies the length and address of an area for the output data. The area must be aligned on a word boundary. The MSGDSHL macro serves to generate a description (DSECT/data list) of this output area.
length
Length of the area in bytes; “length” >= 16. If the area is too small, only the number of message files is entered; see “Return information and error flags”, below, RC = X'0C'.
addr
Symbolic address (name) of the area.
(r)
Register containing the address value “addr”.
SCOPE=
Specifies whether system-wide or task-specific message files are to be listed.
BOTH
Both system and task-specific message files are listed.
SYSTEM
Only the system message files are listed.
TASK
Only the task-specific message files are listed.
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.
In the C form or D form, a prefix (pre = 1..4 letters) can be specified, as shown in the macro format.
Default values: | pre = C for C form |
If less than four letters are specified for a prefix, the string SHOx results (where x corresponds to first letter).
Layout of the output
MSGDSHL |
[C/D][,p] |
The MSGDSHL macro serves to generate either a data list of the output area or a dummy section (DSECT) of the output area.
C/D
A data list/DSECT is generated.
p
Prefix for the symbolic names of the DSECT/data list. No more than the first 3 characters of the string specified here will actually be used as a prefix.
Default value: p=SHL.
Register contents
Register R1 contains the operand list address.
Register R15 contains the return code.
Return information and error flags
R15:
+---------------+ | | | | | |0|0|0|0|0|0|a|a| +---------------+
A return code relating to the execution of the MSGSHOW macro is transferred in the rightmost byte of register R15.
X'aa' | Meaning |
X'00' | Normal execution |
X'04' | Error during macro execution |
X'08' | Operand error |
X'0C' | Output area too small |
X'30' | Macro cannot be executed |
X'41' | MIP subsystem is not loaded |
DSECT of the output area
MSGDSHL D 1 #INTF INTCOMP=1,INTNAME=MIP-SHOW,REFTYPE=REQUEST 1 SHLD MFPRE MF=D,PREFIX=*NONE,DNAME=SHLD,MACID=SHL,DMACID=SHL, C 1 ALIGN=D 2 SHLD DSECT , 2 *,##### PREFIX=, MACID=SHL ##### 1 SHLDBUFL DC Y(SHLDMLEN) --LENGTH OF THE BUFFER 1 SHLDSYSN DC X'00' --SYSTEM FILE NUMBER 1 SHLDTSKN DC X'00' --TASK FILE NUMBER 1 SHLDSYSL DC CL3' ' --SYSTEM LANGUAGE 1 SHLDTSKL DC CL1' ' --TASK LANGUAGE 1 SHLDSEAR DC X'00' --SEARCH VALUE 1 SHLDSALL EQU X'80' --SEARCH = *ALL 1 SHLDSTSK EQU X'20' --SEARCH = *TASK 1 SHLDRES DS CL7 --RESERVED 1 SHLDFIXD EQU *-SHLD --FIXED-PART LENGTH 1 SHLDFLST DS 510CL55 --FILE NAMES LIST 1 ORG SHLDFLST 1 SHLDFNAM DS CL55 --1ST FILE 1 ORG SHLDFNAM 1 SHLDINDT DS CL1 --FILE TYPE 1 SHLDTIDL EQU X'80' --DLAM + ISAM 1 SHLDTISA EQU X'40' --ISAM 1 SHLDTDLA EQU X'20' --DLAM 1 SHLDTLDL EQU B'00010000' --LOCAL DLAM + ... 1 SHLDNAME DS CL54 --FILE NAME 1 ORG 1 SHLDMLEN EQU *-SHLD --MAX LENGTH OF THE BUFFER