FUNPRMU parameter

From m204wiki
Jump to navigation Jump to search

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, some auditing information may be 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.

Finally, setting any of the X'02', X'04', or X'08' bits of either FUNPARM or FUNPRMU to one will not cause messages to be removed from FUNAUDIT which occur there when all of those bits are zero.

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