LoadMsgctl (XmlDoc subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:XmlDoc:LoadMsgctl subtitle}}
{{Template:XmlDoc:LoadMsgctl subtitle}}
This method displays the messages in the current session that have been affected by <var>MSGCTL</var> commands, as well as the current attributes of those messages.


==Syntax==
==Syntax==
{{Template:XmlDoc:LoadMsgctl syntax}}
{{Template:XmlDoc:LoadMsgctl syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table>
<tr><th>doc</th>
<tr><th>doc</th>
<td>An XmlDoc object, to which elements are added corresponding to the cumulative set of <var>[[MSGCTL command|MSGCTL]]</var> commands which have been issued, or to the single MSGCTL setting as specified by the <var>EDEFHD</var> argument.</td></tr>
<td>An XmlDoc object, to which elements are added corresponding to either of these:
<ul>
<li>The cumulative set of <var>[[MSGCTL command|MSGCTL]]</var> commands which have been issued.</li>
 
<li>The single <var>MSGCTL</var> setting as specified by the <var>EDEFHD</var> argument. </li>
</ul></td></tr>
 
<tr><th><var>EDEFHD</var></th>
<tr><th><var>EDEFHD</var></th>
<td>A string of at least 14 bytes.  If this argument is specified, it is used to create a single element in the <var class="term">doc</var> method object, corresponding to the first 14 bytes of the value specified for <var>EDEFHD</var>.</td></tr>
<td>Used by Rocket Support.</td></tr>
</table>
</table>


==Usage notes==
==Usage notes==
==Examples==
In the [[RKTools]] file <code>M204PROC</code> (which can be [https://model204.rocketsoftware.com/maint/ullist downloaded from Rocket]) is a procedure (<code>RKTCMP_MSGINFO</code>) you can use to show the <var>MSGCTL</var> commands currently in effect in the Online. Example output from the procedure is shown below:
===Cumulative affect of all MSGCTL commands===
 
<p class="output"><b>OPEN FILE SIRIUS
INCLUDE RKTCMP_MSGINFO</b>
MSGCTL M204.0843 NOOPR
MSGCTL M204.1303 NODUMP NOSNAP
MSGCTL M204.0099 NOAUDIT
MSGCTL M204.0131 NOAUDIT
MSGCTL M204.0353 NOAUDIT
MSGCTL M204.0608 NOAUDIT
MSGCTL M204.0619 NOAUDIT
MSGCTL M204.0620 NOAUDIT
MSGCTL M204.0621 NOAUDIT
MSGCTL M204.0622 NOAUDIT
MSGCTL M204.0821 NOAUDIT
MSGCTL M204.0858 NOAUDIT
MSGCTL M204.1149 NOAUDIT
MSGCTL M204.1203 NOAUDIT
MSGCTL M204.1238 NOAUDIT
MSGCTL MSIR.0007 DUMPALL
</p>
 
===Cumulative effect of all MSGCTL commands===
If the only <var>MSGCTL</var> command issued in the Online has been:
If the only <var>MSGCTL</var> command issued in the Online has been:


Line 34: Line 64:
</nowiki></p>
</nowiki></p>


(The value of the <code>M204Version</code> attribute will, of course, depend on the Model 204 version you are using.)
The value of the <code>M204Version</code> attribute will, of course, depend on the Model 204 version you are using.


If you subsequently return M204.0843 to its normal state:
If you subsequently return M204.0843 to its normal state:
Line 48: Line 78:


The <code>opr="yes"</code> attribute indicates that the message is sent to the console operator.
The <code>opr="yes"</code> attribute indicates that the message is sent to the console operator.
===Settings from a single MSGCTL command - EDEFHD===
If you inspect the hex value for the MSGCTL settings:
<p class="code">*LOOK MSGCTL 0 14                                   
MSGCTL  7D88E020                                   
MSGCTL  +00000000  7D89F080 034B0103 01000000 00000000
</p>
You can use the first 28 hexadecimal characters of the data at offset <code>+00000000</code>:
<p class="output"><nowiki>%doc:loadMsgctl(EDEFHD=('00000000' '034B0103' '0100000000' '0000'):hexToString)
%doc:print
</nowiki></p>
The result of the above fragment is:
<p class="output"><nowiki><msgctls M204Version="7.7.0F">
  <msg num="Mxxx.0843" class="I" auditType="MS" term="no" opr="yes" count="no"/>
</msgctls>
</nowiki></p>


==See also==
==See also==
<ul>
<ul>
<li><var>[[LoadMessageInfo (XmlDoc subroutine)|LoadMessageInfo], which produces an XmlDoc with the same attributes for the <code>&lt;msg></code> elements.
<li><var>[[LoadMessageInfo (XmlDoc subroutine)|LoadMessageInfo]]</var>, which produces an <var>XmlDoc</var> with the same attributes for the <code>&lt;msg></code> elements.
</ul>
</ul>


{{Template:XmlDoc:LoadMsgctl footer}}
{{Template:XmlDoc:LoadMsgctl footer}}

Latest revision as of 09:27, 28 May 2019

Load MSGCTL commands to this XmlDoc (XmlDoc class)

[Introduced in Model 204 7.7]


This method displays the messages in the current session that have been affected by MSGCTL commands, as well as the current attributes of those messages.

Syntax

doc:LoadMsgctl[( [EDEFHD= forRocketSupport])]

Syntax terms

doc An XmlDoc object, to which elements are added corresponding to either of these:
  • The cumulative set of MSGCTL commands which have been issued.
  • The single MSGCTL setting as specified by the EDEFHD argument.
EDEFHD Used by Rocket Support.

Usage notes

In the RKTools file M204PROC (which can be downloaded from Rocket) is a procedure (RKTCMP_MSGINFO) you can use to show the MSGCTL commands currently in effect in the Online. Example output from the procedure is shown below:

OPEN FILE SIRIUS INCLUDE RKTCMP_MSGINFO MSGCTL M204.0843 NOOPR MSGCTL M204.1303 NODUMP NOSNAP MSGCTL M204.0099 NOAUDIT MSGCTL M204.0131 NOAUDIT MSGCTL M204.0353 NOAUDIT MSGCTL M204.0608 NOAUDIT MSGCTL M204.0619 NOAUDIT MSGCTL M204.0620 NOAUDIT MSGCTL M204.0621 NOAUDIT MSGCTL M204.0622 NOAUDIT MSGCTL M204.0821 NOAUDIT MSGCTL M204.0858 NOAUDIT MSGCTL M204.1149 NOAUDIT MSGCTL M204.1203 NOAUDIT MSGCTL M204.1238 NOAUDIT MSGCTL MSIR.0007 DUMPALL

Cumulative effect of all MSGCTL commands

If the only MSGCTL command issued in the Online has been:

MSGCTL M204.0843 NOOPR

Then the following request:

begin %d is object xmlDoc auto new %d:loadMsgctl %d:print end

Produces:

<msgctls M204Version="7.7.0F"> <msg num="M204.0843" class="I" auditType="MS" term="no" count="no"/> </msgctls>

The value of the M204Version attribute will, of course, depend on the Model 204 version you are using.

If you subsequently return M204.0843 to its normal state:

MSGCTL M204.0843 OPR

Then the result of the above request will be:

<msgctls M204Version="7.7.0F"> <msg num="M204.0843" class="I" auditType="MS" term="no" opr="yes" count="no"/> </msgctls>

The opr="yes" attribute indicates that the message is sent to the console operator.

See also

  • LoadMessageInfo, which produces an XmlDoc with the same attributes for the <msg> elements.