SHOW - Display message file contents

Function

The //SHOW statement outputs the contents of a message file to the screen or to a printer. The message units are sorted by message class and transferred with or without documentation lines to SYSOUT or SYSLST. For more information on the output format of the message file, see "SHOW-OUTPUT mask - Output message units and additional information".

Differences compared with the SHOW statement in menu mode

The //SHOW statement that can be entered in the command area of the screen mask differs from the //SHOW statement in command procedures in that

• in menu mode, the operand value *PANEL-REQUEST can be assigned to any operand

• an additional value can be specified for the MSG-ID operand

For further details, see section “Special features of statements in menu mode”.

Format

SHOW

MSG-ID = *ALL / list-poss(2000): *CLASS(...) / *INTERVAL(...) / <name 7..7>
	*CLASS(...)
		|	MSG-CLASS = <name 3..3>
	*INTERVAL(...)
		|	FROM = <name 7..7>
		|	,TO = <name 7..7>
,INFORMATION = *MESSAGES (...) / *ALL / list-poss(4): *MESSAGES(...) / *DOCUMENTATION /
				*COMPONENT-ID / *CORRECTION-INFO
	MESSAGES(...)
		|	LANGUAGES = *ALL / list-poss(8): <name 1..1>
		|	,ELEMENTS = *ALL / list-poss(2000): *ATTRIBUTES / *MSG-TEXT /
		|			*MEANING-RESPONSE / *INSERT-ATTRIBUTES
,FROM-FILE = *CURRENT / <filename 1..54>
,OUTPUT = *SYSOUT / *ALL / list-poss(2): *SYSOUT / *SYSLST

Operands

MSG-ID = *ALL / list-poss(2000): *CLASS(...) / *INTERVAL(...) / <name 7..7>

Specifies the message codes of one or more message units of the open message file that are to be output.
If INFORMATION=*DOCUMENTATION is specified, the documentation lines defined for these message codes are also output.

MSG-ID = *ALL
All message components defined in the INFORMATION operand are output.

MSG-ID = *CLASS(...)
All message units whose message code begins with the specified message class are displayed, with or without documentation lines (depending on the value specified in the INFORMATION operand).

MSG-CLASS = <name 3..3>
Specifies the three-letter message class.

MSG-ID = *INTERVAL(...)
All message units whose message code is within the specified message range are displayed, with or without documentation lines (depending on the value specified in the INFORMATION operand).

FROM = <name 7..7>
Specifies the first message code of the message range.

TO = <name 7..7>
The full seven-character message code must be specified.

MSG-ID = <name 7..7>
Specifies the full message code of a message unit that is to be displayed with or without documentation lines (depending on the value specified in the INFORMATION operand).

INFORMATION = *MESSAGES(...) / *ALL / list-poss: *MESSAGES(...) / *DOCUMENTATION / *COMPONENT-ID / *CORRECTION-INFO
Specifies the message file components to be displayed.

INFORMATION = *MESSAGES(...)
One or more message units are to be displayed.

LANGUAGES = *ALL / list-poss(8): <name 1..1>
Specifies the identifiers for the languages in which the message, meaning and response texts were defined.

LANGUAGES = *ALL
All language-dependent elements of a message unit are displayed in alphabetical order.

LANGUAGES = list-poss(8): <name 1..1>

Up to eight language identifiers may be specified. The elements of the message unit that were defined in these languages are displayed in the order in which the language identifiers are specified here.

ELEMENTS = *ALL / list-poss: *ATTRIBUTES / *MSG-TEXT /
*MEANING-RESPONSE / *INSERT-ATTRIBUTES
Specifies elements of a message unit. The operand values *ATTRIBUTES and *INSERT-ATTRIBUTES do not depend on the definition of a language.

ELEMENTS = *ALL
All defined elements of a message unit are output, including the message attributes, insert attributes and message, meaning and response texts.

ELEMENTS = *ATTRIBUTES
All defined message attributes of the message unit are output.

ELEMENTS = *MSG-TEXT
The message text is output.

ELEMENTS = *MEANING-RESPONSE
The meaning and response texts are output.

ELEMENTS = *INSERT-ATTRIBUTES
All defined insert attributes are output.

INFORMATION = *ALL
All message file components defined in the message range (MSG-ID operand) are output. If the MSG-ID operand is assigned the value *ALL, all the contents of the message file are displayed.

INFORMATION = *DOCUMENTATION
Documentation lines in the specified message range (MSG-ID operand) are output. Documentation lines in message ranges that only partially overlap the specified message range are also displayed.

Example

If MSG-ID = *INTERVAL(TST1500-TST1599) is specified, all the documentation lines of the defined message ranges (TST1500-TST1510), (TST1000-TST1999), (TST1000-TST1500) and TST1510 are displayed.

INFORMATION = *CORRECTION-INFO / *COMPONENT-ID
These operands are reserved for internal use with the manufacturer.

FROM-FILE = *CURRENT / <filename 1..54 without-gen-vers>

Name of the message file whose message components are to be displayed.
The operand value *CURRENT refers to the message file that is currently open.

OUTPUT = *SYSOUT / *ALL / list-poss: *SYSOUT / *SYSLST
Specifies the output destination for the message file components defined above.

OUTPUT = *SYSOUT
The message file components are output to SYSOUT.

OUTPUT = *ALL
The message file components are output to SYSOUT and SYSLST.

OUTPUT = *SYSLST
The message file components are output to SYSLST. When MSGMAKER is terminated, the SYSLST file can be printed out using the BS2000 command /PRINT-DOCUMENT. Lines per page = 60.

Example

//SHOW MSG-ID=*INTERVAL (TSTAAA,TTT9999),
    INFORMATION=MESSAGES(LANGUAGES=(E,F),ELEMENTS=(ATTIBUTES,MSG-TEXT)),
    FROM-FILE=SYSMES.TSTFILE.OUTPUT=*SYSLST