SHOW-MSG-OPTIONS

Show unsolicited message logging options

Component:	BS2000
Functional area:	Job processing
Domain:	JOB
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The SHOW-MSG-OPTIONS command lists the parameter settings defined with the MODIFY-MSG-OPTIONS options command which govern the output of unsolicited messages. The values shown apply only to the task issuing the command.

The user can configure message reception requirements separately for three types of message:

• job-related messages sent to that user by systems support using the INFORM-JOB command

• messages sent to all users by systems support using the INFORM-ALL-JOBS command (broadcasts)

• messages from system tasks (e.g. on completion of a file transfer)

The command supports structured output in S variables (see "Output in S variables").

Format

SHOW-MSG-OPTIONS                                                                                                                               

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
	32	NBR0034	Error during command execution
	32	CMD2009	Error on structured output in S variables
	64	CMD0216	User does not have required privilege

Output information

In an interactive task, the information begins with the following header line:

% OP-BROADCAST I OP-MSG I SYSTEM-MSG I INFO-OUTPUT

The values shown in the output line which follows correspond to the operand values set in the MODIFY-MSG-OPTIONS command. 

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Operator broadcast is output	var(*LIST).OPER-BROAD	S	*NO *YES
Operator message output is desired	var(*LIST).OPER-MSG	S	*NO *YES
Standard output desired	var(*LIST).STD-OUT	S	*NO *YES
Output in system line desired	var(*LIST).SYS-LINE-OUT	S	*NO *YES
Output of asynchronous system messages desired	var(*LIST).SYSTEM-MSG	S	*NO *YES

Example

/show-msg-opt ————————————————————————————————————————————————————————— (1)

%  I OP-BROADCAST I OP-MSG I SYSTEM-MSG I INFO-OUTPUT
%        YES     I  YES   I    YES     I      STD     

/mod-msg-opt operator-broadcast=*no,info-output=(*std,*systemline) ———— (2)
/show-msg-opt ————————————————————————————————————————————————————————— (3)

%  I OP-BROADCAST I OP-MSG I SYSTEM-MSG I INFO-OUTPUT
%         NO     I  YES   I    YES     I STD + SYS.LINE      

(1)	Listing the current settings.
(2)	Modifying the settings: Messages that are not job-related are to be suppressed. The other messages are to appear both on the current screen line and on the interactive terminal’s display line.
(3)	Listing the new settings.