MSGCTLU command

Setting message output

Summary

Privileges

User

Function

Displays or specifies the actions to be taken when Model 204 produces a particular error or informational message on this user's thread.

Syntax

MSGCTLU [OFF] | {M204 | USER | MSIR}.msg-number [msg-option [msg-option]... ]

Where:

OFF	Removes all MSGCTLU specified messages from processing.
M204	A standard Model 204 message.
USER	A user message.
MSIR	A Sirius message.
msg-number	The four-digit number of the message.
msg-option	If none of the options are specified, the current options are displayed (V7.9 or later). Otherwise, one of the following: Option Action OFF Removes the specified MSGCTLU message from processing. AUDIT Puts the specified message on the audit trail. NOAUDIT Suppresses the auditing of a specific error message. Use with caution, since preventing certain messages from going to the journal could make problem diagnosis more difficult. NOTERM Does not display the specified message on the user's terminal or for single user jobs in CCAPRINT. Note: Model 204 passes return codes back in login and logout messages; if you set the NOTERM option for login and logout messages, you cannot get the return code. SNAP SNAP produces the same information as SNAPALL. SNAPALL The SNAP includes all allocated storage except the Model 204 load module. TERM Causes the specified message to be displayed on the user's terminal or for single user jobs in CCAPRINT. Syntax notes A period, with no space before or after, must be specified between the message prefix, M204 or USER, and the message number. Any number of nonconflicting options can be specified in the MSGCTLU command. If conflicting options are specified, for example, TERM and NOTERM, the option specified last takes effect. Example The following V7.9 example displays the current options for the standard Model 204 password prompt: MSGCTLU M204.0347 Which returns: MSGCTLU M204.0347 NOCAN NOOPR NOCOUNT PREFIX TERM NOSAVE NOSNAP NODUMP RETCODEB=0 RETCODEO=0 CLASS=P AUDIT AUDITMS NOUPPER The following example suppresses the display of the message on the user terminal: MSGCTLU M204.0347 NOTERM Usage notes The MSGCTLU command lets any logged on user change the way Model 204 processes a particular error or informational message. Changes made to a message affect only the user issuing the MSGCTLU. You can use the MSGCTLU command to change processing for either standard Model 204 messages with a Model 204 prefix or for messages with a user prefix developed by the installation. Note that you can also use the MSGCTL parameter to control the display of message prefixes as well as error and informational messages on the user's terminal. User messages are built in the MSGU module distributed with Model 204 and described in the Model 204 installation documentation. For all Model 204 message event conditions, the Model 204 message documentation lists the error number, the text of the message, and the default action that is taken when the event occurs.