Reference Guide › Configuration File Reference › MESSAGE Record

MESSAGE Record

Use the MESSAGE record to control various aspects of CA VM:Director messages.

MESSAGE {"ParmA" | "ParmB" | "ParmC"}

ParmA:

{MSGNOH | MSG}

ParmB:

{MIXED | UPPER | LOWER}

ParmC:

{ON | OFF | CODE | TEXT | ABEND} msgnumber ...

Configuration File

MESSAGE is defined in the PRODUCT CONFIG file.

Definitions

MSGNOH | MSG

Indicates which CP message facility command should be used. It specifies that CA VM:Director should always use either the CP MSGNOH command (MSGNOH) or the CP MSG command (MSG) when required to send a message to another user with the CP message facility. MSGNOH requires that CA VM:Director have CP privilege class B.

Note: For information about the difference between the MSG and MSGNOH CP commands, see the appropriate IBM CP commands manual. If no value is specified, MSGNOH is used.

MIXED | UPPER | LOWER

Causes CA VM:Director to display messages in either mixed case (MIXED) or uppercase (UPPER). If no value is specified, mixed case is used.

ON | OFF | CODE | TEXT | ABEND

Controls the contents of the displayed message. The ON, OFF, CODE, TEXT, and ABEND levels are all mutually exclusive. The most recently requested level for a specific message number will override all previous settings for that message:

• ON indicates that the message should be displayed in its entirety, but still subject to the user’s EMSG setting when appropriate. This is the default.
• OFF indicates that the message should be completely suppressed to all destinations.
• CODE indicates that only the message prefix (product prefix, CSECT name, message number) should be displayed.
• TEXT indicates that only the text of the message, and not the message prefix, should be displayed.
• ABEND indicates that CA VM:Director should abend as soon as the specified message has been formatted. This is typically only used during problem determination, and should not be specified unless requested by customer support.

Msgnumber …

Specifies a list of the message identifiers controlled by this display specification. This option consists of 4 numeric digits, followed by one alphanumeric suffix.

Description

With the MESSAGE record you can set which CP message facility command should be used, the case of the text of the messages, and attributes of the messages themselves.

Messages sent by either command, MSG or MSGNOH, contain a standard 11‑character message header.

Note: For an explanation of the message format, see CA VM:Director Messages. For an explanation of each message, see the Message Reference Guide.