FUNPRMU parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 19: Line 19:
</dl>
</dl>
==Description==
==Description==
This is a bitmask parameter that controls auditing of messages with the <var class="product">Fast/Unload User Language Interface</var>,
This parameter, together with the <var>[[FUNPARM parameter|FUNPARM]]</var> system parameter,
where the bits mean:
controls auditing of messages with the <var class="product">Fast/Unload User Language Interface</var>.
They are intended to augment the availability of auditing information, in such a way that the user or the system manager can
ensure that the information is available for a single request or all requests, without any changes to a User Language
program invoking <var>[[FastUnload (Recordset function)|FastUnload]]</var>, <var>[[FastUnloadTask (Recordset function)|FastUnloadTask]]</var>, or <var>[[$Funload]]</var>.
Without the use of these parameters,
sometimes auditing information is available from the <code>FUNAUDIT</code> DDname, but,
for example, messages from a <var>FastUnload</var> request will not be in <code>FUNAUDIT</code> if the
<var>Report</var> parameter is used.
This is a bitmask parameter where the bits mean:
<dl>
<dl>
<dt>X'02'
<dt>X'02'
<dd>Indicates that "basic" <var class="product">Fast/Unload</var> messages are always audited, whether or not a request has a <var class="product">Fast/Unload</var> report argument.
<dd>Indicates that "basic" <var class="product">Fast/Unload</var> messages are always audited, whether or not a request has a <var class="product">Fast/Unload</var> report argument.
<dt>X'04'
<dt>X'04'
<dd>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages, except lines issued by the <var>REPORT</var> statement and the "Field statistics" lines, are always audited, whether or not a request has a <var class="product">Fast/Unload</var> report argument.
<dd>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages, except "Field statistics"
and <var>REPORT</var> statement lines,
are always audited, whether or not a request has a <var class="product">Fast/Unload</var> report argument.
The X'02' bit need not be set if the X'04' bit is set.
The X'02' bit need not be set if the X'04' bit is set.
<dt>X'08'
<dt>X'08'
<dd>If the X'02' or X'04' bit is on, the X'80' bit causes all messages thus selected to be sent to the <var class="product">Model 204</var> audit trail, whether or not the <code>FUNAUDIT</code> DDname is present.
<dd>If the X'02' or X'04' bit is on, the X'08' bit causes all messages thus selected to be sent to the <var class="product">Model 204</var> audit trail, whether or not the <code>FUNAUDIT</code> DDname is present.
   
   
In the odd case that there is no <var class="product">Model 204</var> audit trail, the X'80' bit is ignored (treated as if it were zero).
In the odd case that there is no <var class="product">Model 204</var> audit trail, the X'08' bit is ignored (treated as if it were zero).
</dl>
</dl>
   
   
For both of the <var>FUNPRMU</var> X'02' and X'04' bits, the same bit has the same meaning in the <var>[[FUNPARM parameter|FUNPARM]]</var> system parameter;   the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits is on.
For both of the <var>FUNPRMU</var> X'02' and X'04' bits, the same bit has the same meaning in the <var>FUNPARM</var> system parameter; the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits is on.
   
   
For the X'80' bit:
For the X'08' bit:
<ul>
<ul>
<li>If both <var>FUNPARM</var> and <var>FUNPRMU</var> have the X'80' bit on,
<li>If both <var>FUNPARM</var> and <var>FUNPRMU</var> have the X'08' bit on,
then the X'02' and X'04' bits do not affect any output to <code>FUNAUDIT</code>.
then the X'02' and X'04' bits do not affect any output to <code>FUNAUDIT</code>.
<li>If either <var>FUNPARM</var> or <var>FUNPRMU</var> has the X'80' bit on and the other has it off,
<li>If either <var>FUNPARM</var> or <var>FUNPRMU</var> has the X'08' bit on and the other has it off,
and there is a <code>FUNAUDIT</code> DDname, then any extra auditing
and there is a <code>FUNAUDIT</code> DDname, then any extra auditing
selected by X'02' or X'04' goes both to <code>FUNAUDIT</code> and to the <var class="product">Model 204</var> audit trial.
selected by X'02' or X'04' goes both to <code>FUNAUDIT</code> and to the <var class="product">Model 204</var> audit trial.
</ul>
</ul>
In other words:
<ul>
<li>If the X'08' bit is <b>on in either</b> <var>FUNPARM</var> or <var>FUNPRMU</var>, then messages selected by the collective
X'02' and X'04' bits will go to the <var class="product">Model 204</var> <b>audit trial</b>.
<li>If the X'08' bit is <b>off in either</b> <var>FUNPARM</var> or <var>FUNPRMU</var>, then messages selected by the collective
X'02' and X'04' bits will go to <b><code>FUNAUDIT</code></b> if it is present.
</ul>
Note that the X'01' bit is not used by <var>FUNPRMU</var>.
Note that the X'01' bit is not used by <var>FUNPRMU</var>.
[[Category:User parameters]]
[[Category:User parameters]]
[[Category:Parameters]]
[[Category:Parameters]]
[[Category:Fast/Unload User Language Interface]]
[[Category:Fast/Unload User Language Interface]]

Revision as of 18:30, 25 June 2012

This page is under construction and the feature being proposed is tentative - not even yet ready for βeta testing.

User-level Fast/Unload flags

Summary

Default value
X'00'
Parameter type
User
Where set
Any user
Related products
Fast/Unload User Language Interface
Introduced
Sirius Mods 8.1

Description

This parameter, together with the FUNPARM system parameter, controls auditing of messages with the Fast/Unload User Language Interface. They are intended to augment the availability of auditing information, in such a way that the user or the system manager can ensure that the information is available for a single request or all requests, without any changes to a User Language program invoking FastUnload, FastUnloadTask, or $Funload. Without the use of these parameters, sometimes auditing information is available from the FUNAUDIT DDname, but, for example, messages from a FastUnload request will not be in FUNAUDIT if the Report parameter is used.

This is a bitmask parameter where the bits mean:

X'02'
Indicates that "basic" Fast/Unload messages are always audited, whether or not a request has a Fast/Unload report argument.
X'04'
Indicates that all Fast/Unload messages, except "Field statistics" and REPORT statement lines, are always audited, whether or not a request has a Fast/Unload report argument. The X'02' bit need not be set if the X'04' bit is set.
X'08'
If the X'02' or X'04' bit is on, the X'08' bit causes all messages thus selected to be sent to the Model 204 audit trail, whether or not the FUNAUDIT DDname is present. In the odd case that there is no Model 204 audit trail, the X'08' bit is ignored (treated as if it were zero).

For both of the FUNPRMU X'02' and X'04' bits, the same bit has the same meaning in the FUNPARM system parameter; the indicated effect takes place if either of the FUNPRMU or FUNPARM bits is on.

For the X'08' bit:

  • If both FUNPARM and FUNPRMU have the X'08' bit on, then the X'02' and X'04' bits do not affect any output to FUNAUDIT.
  • If either FUNPARM or FUNPRMU has the X'08' bit on and the other has it off, and there is a FUNAUDIT DDname, then any extra auditing selected by X'02' or X'04' goes both to FUNAUDIT and to the Model 204 audit trial.

In other words:

  • If the X'08' bit is on in either FUNPARM or FUNPRMU, then messages selected by the collective X'02' and X'04' bits will go to the Model 204 audit trial.
  • If the X'08' bit is off in either FUNPARM or FUNPRMU, then messages selected by the collective X'02' and X'04' bits will go to FUNAUDIT if it is present.

Note that the X'01' bit is not used by FUNPRMU.

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=FUNPRMU_parameter&oldid=51254"