SHOW-MSG-SUBSCRIPTION

Show message subscriptions and suppression of nonsubscription messages

Component:	BS2000
Functional area:	Operator terminal control Message processing
Domain:	CONSOLE-MANAGEMENT
Privileges:	OPERATING
Routing code:	@

Function

This command supplies information on all the message subscriptions set up for the operator terminal (console) using the MODIFY-MSG-SUBSCRIPTION command. It also indicates whether suppression of nonsubscription messages has been activated for the operator terminal.
The operator terminal may be either a physical or logical operator terminal or an interactive task with the OPERATING privilege.

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

Format

SHOW-MSG-SUBSCRIPTION                                                                                                                         

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
1	0	NBR0094	There are no subscribed messages for this operator terminal
	1	CMD0202	Syntax error
	32	CMD2009	Error on output in S variables (e.g. subsystem not available)
	32	NBR0034	Error in command execution
	64	CMD0216	Required authorization not available

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Message codes of the relevant messages (padded with blanks to 7 characters)	var(*LIST).MSG-ID(*LIST)	S	<name 7..7>	If messages have been requested
Delivery of not requested messages	var(*LIST).DELIVER-OTHER-MSG	B	TRUE FALSE

Example

The device management messages in message class NKD are added to the message subscription for the operator terminal; the RSO and SPOOL messages in message classes SRO, SPC and SPM are removed from the subscription:

/mod-msg-subscript add=nkd,rem=(sro,spc,spm)

%  NBR0091 SOME MESSAGES SUBSCRIPTIONS IGNORED

/show-msg-subscript

%  NBR0093 THE FOLLOWING MESSAGE KEYS ARE SUBSCRIBED BY THIS CONSOLE:
%              NKD
%  NBR0096 UNSUBSCRIBED MESSAGES WILL ALSO BE DELIVERED TO THIS CONSOLE