FUNPRMU parameter

From m204wiki
Revision as of 20:21, 12 July 2012 by Dme (talk | contribs)
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 job or all jobs, 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 job 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, regardless of the presence of a Fast/Unload User Language Interface report argument.
X'04'
Indicates that all Fast/Unload messages, except "Field statistics" and REPORT statement lines, are always audited, regardless of the presence of a Fast/Unload User Language Interface 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.

Fast/Unload report processing

Every Fast/Unload User Language Interface job has a "report", which contains at least the line indicating the end of the job. The User Language invocation (of FastUnload, for example) can designate a DDname or Stringlist or $list destination for the report, or it can omit the destination, in which case the report is sent to the FUNAUDIT DDname, if there is one, or otherwise to the Model 204 audit trail.

The FUNPARM and FUNPRMU parameters allow the auditing of some of the information from the report to be captured on FUNAUDIT and/or the Model 204 audit trail, regardless of the designation of the report destination in the various User Language invocations of the Fast/Unload User Language Interface.

The effect of these parameters is shown in the following table; it is based on the values of the parameters when User Language invokes a Fast/Unload User Language Interface job.

If the report's destination is FUNAUDIT
  • If either FUNPARM or FUNPRMU has the X'08' bit off and the X'04' bit on, it is ensured that FUNAUDIT will contain the list of Fast/Unload parameter settings and of the FUEL program.
  • Otherwise, FUNAUDIT is not affected by these parameters.
If the report's destination is the Model 204 audit trail
  • If either FUNPARM or FUNPRMU has the X'04' bit on, it is ensured that the Model 204 audit trail will contain the list of Fast/Unload parameter settings and of the FUEL program.
  • Otherwise, the Model 204 audit trail is not affected by these parameters.
Otherwise (the report's destination is a DDname - other than FUNAUDIT, a Stringlist, or a $list)
  • If either FUNPARM or FUNPRMU has either of the X'04' or X'02' bits on, an "audit" stream is produced for the job, containing at least the job's "basic" Fast/Unload messages.
  • If either FUNPARM or FUNPRMU has the X'04' bit on, this will also contain the list of Fast/Unload parameter settings and of the FUEL program.
  • ??

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