Display message files currently in use
Component: | MIP |
Functional area: | Message processing |
Domain: | MESSAGE-PROCESSING |
Privileges: | STD-PROCESSING |
Function
The SHOW-MSG-FILE-ASSIGNMENT command outputs the following information to SYSOUT:
number of active message files
language used for message output
names of the active message files with scope and access method.
The information output can also be limited according to the scope of the active message files (system-wide, or for one task only).
The command supports structured output in S variables (see "Output in S variables").
Format
SHOW-MSG-FILE-ASSIGNMENT |
INFORMATION = *ALL / *SYSTEM / *TASK |
Operands
INFORMATION =
Specifies the scope of information output.
INFORMATION = *ALL
Provides information on all message files activated in the system and on those activated for the task.
The system message files are followed by the message files activated for the task.
INFORMATION = *SYSTEM
Provides information on all the message files activated at the system level.
INFORMATION = *TASK
Provides information on all the message files activated for the task.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NMH1174 | Syntax error | |
32 | NMH1121 | Internal error | |
32 | CMD2009 | Internal error during S variable generation | |
64 | CMD0216 | Semantic error | |
64 | OPS0001 | SDF-P reporting space problems |
Output in S variables
The INFORMATION operand identifies the S variables which are to be created. The possible values for INFORMATION are *ALL/*SYSTEM/*TASK.
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
DLAM access to the message file | var(*LIST).F(*LIST).DLAM | B | FALSE | INF=*ALL/ |
Name of the message file | var(*LIST).F(*LIST).F-NAME | S | <filename> | INF=*ALL/ |
ISAM access to the message file | var(*LIST).F(*LIST).ISAM | B | FALSE | INF=*ALL/ |
Scope of the message file | var(*LIST).F(*LIST).SCOPE | S | *SYS | INF=*ALL/ |
S | *TASK | INF=*ALL/ | ||
System-wide language used for message output | var(*LIST).SYS-LANG(*LIST) | S | <name 1..1> | INF=*ALL/ |
Task-specific language used for message output | var(*LIST).TASK-LANG | S | ’’ | INF=*ALL/ |
Examples
Output in S variable
/declare-variable var-name=var(type=*structure),multiple-elem=*list
/exec-cmd (show-msg-file-assign inf=*task),text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal)
VAR(*LIST).TASK-LANG = ' ' VAR(*LIST).F(*LIST).F-NAME = ':2OSG:$USER1.USER.MELDUNGSDATEI.1 ' VAR(*LIST).F(*LIST).ISAM = TRUE VAR(*LIST).F(*LIST).DLAM = FALSE VAR(*LIST).F(*LIST).LOCAL-DLAM = FALSE VAR(*LIST).F(*LIST).SCOPE = '*TASK' *END-OF-VAR
/exec-cmd (show-msg-file-assign inf=*sys),text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)
VAR#1.SYS-LANG#1 = 'E' VAR#1.SYS-LANG#2 = 'D' VAR#1.F#2.F-NAME = ':SQGB:$TSOS.SYSMES.TASKDATE.200 ' VAR#1.F#2.ISAM = TRUE VAR#1.F#2.DLAM = FALSE VAR#1.F#2.LOCAL-DLAM = FALSE VAR#1.F#2.SCOPE = '*SYS' *END-OF-VAR ........ ........ ........ *END-OF-VAR VAR#1.F#154.F-NAME = ':SQGB:$TSOS.SYSMES.SDF-P-BASYS.025 ' VAR#1.F#154.ISAM = TRUE VAR#1.F#154.DLAM = FALSE VAR#1.F#154.LOCAL-DLAM = FALSE VAR#1.F#154.SCOPE = '*SYS' *END-OF-VAR VAR#1.F#155.F-NAME = ':1OSH:$TSOS.SYSMES.BS2CP.200 ' VAR#1.F#155.ISAM = TRUE VAR#1.F#155.DLAM = TRUE VAR#1.F#155.LOCAL-DLAM = TRUE VAR#1.F#155.SCOPE = '*SYS' *END-OF-VAR VAR#1.F#156.F-NAME = ':SQGB:$TSOS.SYSMES.EKP.01 ' VAR#1.F#156.ISAM = TRUE VAR#1.F#156.DLAM = FALSE VAR#1.F#156.LOCAL-DLAM = FALSE VAR#1.F#156.SCOPE = '*SYS' *END-OF-VAR *END-OF-VAR
Output to SYSOUT
/mod-msg-file-assign add-file=user.meldungsdatei.1 ——— (1)
% NMH1102 MESSAGE OUTPUT FILE ':2OSG:$USER1.USER.MELDUNGSDATEI.1', ACCESS=ISAM ACTION=ADD % NMH1180 FILE ':2OSG:$USER1.USER.MELDUNGSDATEI.1' HAS BEEN ADDED
/show-msg-file-assign ————————————————————————————————— (2)
NUMBER OF SYSTEM MESSAGES-FILES : 165
NUMBER OF TASK MESSAGES-FILES : 1
SYSTEM LANGUAGES : ED
TASK LANGUAGE : TASK SEARCH : *ALL
MESSAGES-FILES NAMES OPEN
:SQGB:$TSOS.SYSMES.TASKDATE.200 S I
:SQGB:$TSOS.SYSMES.OPENFT-AC.121 S I
:SQGB:$TSOS.SYSMES.ONETSTOR.030 S I
:SQGB:$TSOS.SYSMES.OPENFT.121 S I
:SQGB:$TSOS.SYSMES.ASE.010 S I+L
:SQGB:$TSOS.SYSMES.TCP-IP-AP.053 S I
:SQGB:$TSOS.SYSMES.PRNGD.011 S I
:SQGB:$TSOS.SYSMES.OSS.041 S I
:SQGB:$TSOS.SYSMES.MAIL.034.MAILCLNT S I
:SQGB:$TSOS.SYSMES.REWAS.020 S I
:SQGB:$TSOS.SYSMES.CAPRI.020 S I
:SQGB:$TSOS.SYSMES.JITSYS.070 S I
:SQGB:$TSOS.SYSMES.IOCFCOPY.190 S I
:SQGB:$TSOS.SYSMES.DCAM.133 S I
:SQGB:$TSOS.SYSMES.DAB.095 S D+I+L
.
.
.
:SQGB:$TSOS.SYSMES.SDF.048 S I
:SQGB:$TSOS.SYSMES.SDF-A.041 S I
:SQGB:$TSOS.SYSMES.SDF-CONV.030 S I
:SQGB:$TSOS.SYSMES.SDF-I.041 S I
:SQGB:$TSOS.SYSMES.SDF-P-BASYS.025 S I
:SQGB:$TSOS.SYSMES.BS2CP.200 S D+I+L
:SQGB:$TSOS.SYSMES.EKP.01 S I
:2OSG:$USER1.USER.MELDUNGSDATEI.1 T I
(1) | Adds the task message file USER.MESSAGEFILE.1. |
(2) | Displays all system and task message files assigned to the task (only part of the system message file output is shown here). |
Note
The meanings of the codes in the output column headed “OPEN” are as follows:
The first code refers to the scope of the message file (S for system, T for task)
The second code refers to the file access method (I for ISAM, D for DLAM)