MSGCTL parameter: Difference between revisions

Latest revision as of 23:28, 6 July 2016

Message printing options

Summary

Default value: 0
Parameter type: User
Where set: By any user
Related products: All
Introduced: Model 204 V8.1 or earlier

Description

The type of display of message prefixes and error and informational messages on the user's terminal

Valid settings of MSGCTL options, which can be summed, are:

Setting	Meaning
`0`	Enable display of messages.
`1`	Suppress display of message prefixes and numbers associated with all messages.
`2`	Suppress display of informational messages.
`4`	Suppress display of error messages.

Settings of 0, 2, and 4 affect the display of the messages on the user's terminal. A setting of 1 affects both the display of messages on the terminal and the writing of messages to the audit trail.

The DEBUGUL parameter can override the MSGCTL parameter

If you have set the MSGCTL parameter to a value that suppresses the message, and set the DEBUGUL parameter to a value that includes the X'10' bit, the DEBUGUL setting forces the message to the terminal, even though the MSGCTL parameter setting says not to do so.

The MSGCTL command can override the MSGCTL and DEBUGUL parameters

If you use the MSGCTL command, and suppress the display of a message by using the NOTERM keyword, then no matter how the MSGCTL or DEBUGUL parameters are set, the message does not go to the terminal. Conversely, if you want messages displayed at the terminal, enter the MSGCTL command using the following syntax:

MSGCTL {M204 | USER}.msg-number TERM

Where:

M204 or USER specifies either a Model 204 or a user-defined message, respectively.
msg-number is the 4-digit number of the message.
TERM displays the specified error message on the user's terminal, when appropriate.

@@ Line 1: / Line 1: @@
 {{Template:MSGCTL parameter subtitle}}
+__NOTOC__
 ==Summary==
 <dl>
@@ Line 5: / Line 7: @@
 <dd>0
 <dt>Parameter type
-<dd>System
+<dd>User
 <dt>Where set
-<dd>On User 0's parameter line.
+<dd>By any user
 <dt>Related products
 <dd>All
 <dt>Introduced
-<dd><var class="product">Model 204 V6.1</var> or earlier
+<dd><var class="product">Model 204 V8.1</var> or earlier
 </dl>
 ==Description==
-<p>The type of display of message prefixes and error and informational messages on the user's terminal</p>
+<p>
-<p>Valid settings of MSGCTL options, which can be summed, are:</p>
+The type of display of message prefixes and error and informational messages on the user's terminal</p>
+<p>
+Valid settings of <var>MSGCTL</var> options, which can be summed, are:</p>
 <table>
-<tr><th>Setting</th><th>Meaning</th></tr>
+<tr class="head"><th>Setting</th><th>Meaning</th></tr>
 <tr><th align="right"><var>0</var></th><td>Enable display of messages.</td></tr>
 <tr><th align="right"><var>1</var></th><td>Suppress display of message prefixes and numbers associated with all messages.</td></tr>
 <tr><th align="right"><var>2</var></th><td>Suppress display of informational messages.</td></tr>
 <tr><th align="right"><var>4</var></th><td>Suppress display of error messages.</td></tr>
 </table>
-<p>Settings of 0, 2, and 4 affect the display of the messages on the user's terminal. A setting of 1 affects both the display of messages on the terminal and the writing of messages to the audit trail. </p>
+<p>
-====How the DEBUGUL parameter can override the MSGCTL parameter====
+Settings of 0, 2, and 4 affect the display of the messages on the user's terminal. A setting of 1 affects both the display of messages on the terminal and the writing of messages to the audit trail. </p>
-<p>If you have set the MSGCTL parameter to a value that suppresses the message, and set the DEBUGUL parameter to a value where the X'10' bit is on, then the DEBUGUL parameter setting forces the message to the terminal, even though the MSGCTL parameter setting says not to.</p>
-<p><b>How the MSGCTL command can override both the MSGCTL and DEBUGUL parameters</b></p>
+===The DEBUGUL parameter can override the MSGCTL parameter===
-<p>If you use the MSGCTL command, and suppress the display of a message by using the NOTERM keyword, then no matter how the MSGCTL or DEBUGUL parameters are set, the message does not go to the terminal. Conversely, if you want messages displayed at the terminal, enter MSGCTL command using the following syntax: </p>
+<p>
-<p class="code">MSGCTL {M204 | USER}.msg-number TERM
+If you have set the <var>MSGCTL</var> parameter to a value that suppresses the message, and set the <var>[[DEBUGUL parameter|DEBUGUL]]</var> parameter to a value that includes the X'10' bit, the <var>DEBUGUL</var> setting forces the message to the terminal, even though the <var>MSGCTL</var> parameter setting says not to do so.</p>
+===The MSGCTL command can override the MSGCTL and DEBUGUL parameters===
+<p>
+If you use the <var>[[MSGCTL command|MSGCTL]]</var> command, and suppress the display of a message by using the <var>NOTERM</var> keyword, then no matter how the <var>MSGCTL</var> or <var>DEBUGUL</var> parameters are set, the message does not go to the terminal. Conversely, if you want messages displayed at the terminal, enter the <var>MSGCTL</var> command using the following syntax: </p>
+<p class="syntax">MSGCTL {M204 | USER}.<span class="term">msg-number</span> TERM
 </p>
-<p>Where:</p>
+<p>
-<p><var>M204</var> or <var>USER</var> specifies either <var class="product">Model&nbsp;204</var> or User defined message, respectively</p>
+Where:</p>
-<p><var>Msg-number</var> is the 4-digit number of the message.</p>
+<ul>
-<p>TERM displays the specified error message on the user's terminal, when appropriate.</p>
+<li><var>M204</var> or <var>USER</var> specifies either a <var class="product">Model&nbsp;204</var> or a user-defined message, respectively.</li>
+<li><var class="term">msg-number</var> is the 4-digit number of the message.</li>
+<li><var>TERM</var> displays the specified error message on the user's terminal, when appropriate.</li>
+</ul>
 [[Category:System parameters]]
 [[Category:Parameters]]