RPuszewski at 06:02, 1 March 2024

2024-03-01T06:02:05Z

← Older revision		Revision as of 06:02, 1 March 2024
Line 1:		Line 1:
	<span class="pageSubtitle">Setting message output</span>		<span class="pageSubtitle">Setting message output</span>

			<p class="note"><b>Note:</b> This command is only available in of <var class="product">[[Model 204]]</var> version 7.9 and above.</p>

	==Summary==		==Summary==

RPuszewski: Created page with "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]....."

2024-03-01T05:57:05Z

Created page with "Setting message output ==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== MSGCTLU [OFF] | {M204 | USER | MSIR}.msg-number [msg-option [msg-option]....."

New page

Setting message output

==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==
MSGCTLU [OFF] | {M204 | USER | MSIR}.msg-number
[msg-option [msg-option]... ]


Where:
<table>

<tr>
<th><var>OFF</var></th>
<td>Removes all MSGCTLU specified messages from processing.</td>
</tr>

<tr>
<th><var>M204</var></th>
<td>A standard <var class="product">Model 204</var> message.</td>
</tr>

<tr>
<th><var>USER</var></th>
<td>A user message.</td>
</tr>

<tr>
<th><var>MSIR</var></th>
<td>A Sirius message.</td>
</tr>

<tr>
<th>msg-number</th>
<td>The four-digit number of the message.</td>
</tr>

<tr>
<th>msg-option</th>
<td>If none of the options are specified, the current options are displayed (V7.9 or later).
Otherwise, one of the following:
<table>
<tr class="head">
<th>Option</th>
<th>Action</th>
</tr>

<tr> <th><var>OFF</var></th>
<td>Removes the specified MSGCTLU message from processing.
</td> </tr>

<tr> <th><var>AUDIT</var></th>
<td>Puts the specified message on the audit trail.
</td> </tr>

<tr> <th><var>NOAUDIT</var></th>
<td>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.
</td> </tr>

<tr> <th><var> NOTERM</var></th>
<td>Does not display the specified message on the user's terminal or for single user jobs in CCAPRINT.
Note: <var class="product">Model 204</var> passes return codes back in login and logout messages; if you set the <var>NOTERM</var> option for login and logout messages, you cannot get the return code.
</td> </tr>

<tr> <th><var>SNAP</var></th>
<td><var>SNAP</var> produces the same information as <var>SNAPALL</var>. </td> </tr>

<tr> <th><var>SNAPALL </var></th>
<td>The SNAP includes all allocated storage except the <var class="product">Model 204</var> load module.</td> </tr>

<tr>
<th><var>TERM</var></th>
<td>Causes the specified message to be displayed on the user's terminal or for single user jobs in CCAPRINT. </td> </tr>
</table>

===Syntax notes===
<ul>
<li>A period, with no space before or after, must be specified between the message prefix, <var>M204</var> or <var>USER</var>, and the message number.</li>

<li>Any number of nonconflicting options can be specified in the <var>MSGCTLU</var> command. If conflicting options are specified, for example, <var>TERM</var> and <var>NOTERM</var>, the option specified last takes effect.</li>

==Example==
The following V7.9 example displays the current options for the standard <var class="product">Model 204</var> 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==
<ul>
<li>The <var>MSGCTLU</var> command lets any logged on user change the way <var class="product">Model 204</var> processes a particular error or informational message. Changes made to a message affect only the user issuing the MSGCTLU.

<li>You can use the <var>MSGCTLU</var> command to change processing for either standard <var class="product">Model 204</var> messages with a <var class="product">Model 204</var> prefix or for messages with a user prefix developed by the installation. Note that you can also use the <var>MSGCTL</var> 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 <var class="product">Model 204</var> and described in the [[Model 204 installation|Model 204 installation documentation]].</li>

<li>For all <var class="product">Model 204</var> message event conditions, the <var class="product">Model 204</var> [[M204wiki main page#Messages|message documentation]] lists the error number, the text of the message, and the default action that is taken when the event occurs. </li>
</ul>

[[Category: User commands]]
[[Category:Commands]]

MSGCTLU command - Revision history

RPuszewski at 06:02, 1 March 2024