MSGLVL


   .-MSGLVL--=--START-----.   
>>-+----------------------+------------------------------------><
   |            .-START-. |   
   '-MSGLVL--=--+-------+-'   
                +-BASE--+     
                +-V4R1--+     
                +-V4R2--+     
                +-V4R3--+     
                +-V4R4--+     
                '-CS390-'

macroinstructions:

USSMSG

dependencies:

VTAM® operator messages only

Specifies the version of the message to issue on a message-by-message basis. MSGLVL is valid only for those messages listed in z/OS Communications Server: SNA Messages. The value specified on the MSGLVL operand overrides the MSGLEVEL start option value for this message.

The V4R1 and above messages often use network-qualified names for session-capable resources to enable you to know specifically which resource is affected by the message. You can choose to have VTAM issue the message that uses non-network qualified names to the VTAM operator console, but be aware that the messages that use network-qualified names might be more descriptive. Because the MSGLEVEL start option has a default value of BASE, you do not have to do anything if you want VTAM to issue the pre-V4R1 messages.

For example, message

IST073I  command for ID=nodename FAILED - MORE POWERFUL REQUEST IN PROGRESS

has been replaced by the following message group

IST1129I  command FAILED, nodename - DEACTIVATE PENDING
IST1045I  NODE TYPE = nodetype
IST314I   END

If you want to continue to get IST073I, code the following information:

[name]   USSMSG     MSG=IST1129I,MSGLVL=BASE

MSGLVL=BASE: Specifies that for the message number indicated on the MSG operand, issue the pre-V4R1 message that this message number replaces, regardless of the value coded on the MSGLEVEL start option.
For messages replaced by message groups, to get the base message, code MSGLVL=BASE for the first message in the group. See z/OS Communications Server: SNA Messages for a list of messages supported by the MSGLVL operand.

Note: If you specify MSGLVL=BASE and if there are duplicate names in your SNA interconnected networks, you might not know which resource the message applies to.
MSGLVL=START: Specifies that for the message number indicated on the MSG operand, issue the version of the message specified on the MSGLEVEL start option. START is the default for only those messages supported by the MSGLVL operand.
MSGLVL=V4R1: Specifies that for the message number indicated on the MSG operand, issue the V4R1 message or messages, regardless of the value specified on the MSGLEVEL start option. See z/OS Communications Server: SNA Messages for a list of V4R1 messages supported by the MSGLVL operand.
MSGLVL=V4R2: Specifies that for the message number indicated on the MSG operand, issue the V4R2 message or messages, regardless of the MSGLVL value specified on the MSGLEVEL start option. See z/OS Communications Server: SNA Messages for a list of messages supported by the MSGLVL operand.
MSGLVL=V4R3: Specifies that for the message number indicated on the MSG operand, issue the V4R2 message or messages, regardless of the MSGLVL value specified on the MSGLEVEL start option. See z/OS Communications Server: SNA Messages for a list of messages supported by the MSGLVL operand.
MSGLVL=V4R4: Specifies that for the message number indicated on the MSG operand, issue the V4R2 message or messages, regardless of the MSGLVL value specified on the MSGLEVEL start option. See z/OS Communications Server: SNA Messages for a list of messages supported by the MSGLVL operand.
MSGLVL=CS390: Specifies that for the message number indicated on the MSG operand, issue the z/OS® Communications Server message or messages, regardless of the MSGLVL value specified on the MSGLEVEL start option. See z/OS Communications Server: SNA Messages for a list of messages supported by the MSGLVL operand.