MSGCTLU command

From m204wiki
Revision as of 05:57, 1 March 2024 by RPuszewski (talk | contribs) (Created page with "<span class="pageSubtitle">Setting message output</span> ==Summary== <dl> <dt>Privileges <dd>User <dt>Function <dd>Displays or specifies the actions to be taken when <var class="product">Model 204</var> produces a particular error or informational message on this user's thread. </dl> ==Syntax== <p class="syntax">MSGCTLU [OFF] | {M204 | USER | MSIR}.<span class="term">msg-number</span> [<span class="term">msg-option</span> [<span class="term">msg-option</span>].....")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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.