FUNPRMU parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
This page is [[under construction]].
This page is [[under construction]] and the feature being proposed is tentative - not even yet ready for <span style="color:red">&#x3B2;eta</span> testing.


<span class="pageSubtitle">User-level Fast/Unload flags</span>
<span class="pageSubtitle">User-level Fast/Unload flags</span>
Line 20: Line 20:
<dl>
<dl>
<dt>X'02'
<dt>X'02'
<dd>Indicates that <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. Unless the X'02' bit is also on, the set of messages is as controlled by the arguments to the <var class="product">Fast/Unload User Language Interface</var> function being used.
<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 are always audited whether or not a request has a <var class="product">Fast/Unload</var> report argument. This set of messages is the same as would be sent to the <var class="product">Fast/Unload</var> report if the <var>AllMessages</var> argument were <code>True</code> (to, for example, the <var>[[FastUnload (Recordset function)|FastUnload]]</var> function) or if the <code>ALLMSG</code> option were supplied to the [[$FunLoad]] function.
<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.
 
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>Indicates that all auditing of <var class="product">Fast/Unload</var> messages (regardless of the reason they are audited) be sent to the <var class="product">Model 204</var> audit trail. This may be in addition to the messages being audited to the <code>FUNAUDIT</code> DDname.
<dd>If the X'02' or X'04' bit is on, this 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. When this bit is on, then the X'02' and X'04' bits do not affect any output to <code>FUNAUDIT</code>.
 
If the X'08' bit is <b>not</b> on, and there as a <code>FUNAUDIT</code> DDname, then any extra auditing selected by X'02' or X'04' goes to <code>FUNAUDIT</code> and no <var class="product">Fast/Unload</var> messages are sent to the <var class="product">Model 204</var> audit trial.
 
In the odd case that there is no <var class="product">Model 204</var> audit trail, this bit is ignored (treated as if it were zero).
</dl>
</dl>



Revision as of 15:57, 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 is a bitmask parameter that controls auditing of messages with the Fast/Unload User Language Interface, 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 lines issued by the REPORT statement and the "Field statistics" 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, this bit causes all messages thus selected to be sent to the Model 204 audit trail, whether or not the FUNAUDIT DDname is present. When this bit is on, then the X'02' and X'04' bits do not affect any output to FUNAUDIT. If the X'08' bit is not on, and there as a FUNAUDIT DDname, then any extra auditing selected by X'02' or X'04' goes to FUNAUDIT and no Fast/Unload messages are sent to the Model 204 audit trial. In the odd case that there is no Model 204 audit trail, this bit is ignored (treated as if it were zero).

For each of the FUNPRMU bits X'02', X'04', and X'08', 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.

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