AUDITHLQ


1 AUDITHLQ=
1 user-defined audithlq
1 user-defined prefix
AUDITHLQ
Specifies an optional high-level qualifier, or data set prefix, for the File Manager audit log data sets.
The format of the generated data set names is shown in The format of generated data set names.
Table 1. The format of generated data set names
FM component AUDITHLQ value Audit log data set name format
File Manager Base component, FM/CICS blank (none) userid.FMNLOG.Dyymmdd.Thhmmss
File Manager Base component, FM/CICS audithlq audithlq.userid.FMNLOG.Dyymmdd.Thhmmss
File Manager Base component, FM/CICS prefix qual1.<qual2.><qual3.>Dyymmdd.Thhmmss
FM/Db2 blank (none) userid.FMN2AUD.<ssid>.Dyymmdd.Thhmmss
FM/Db2 audithlq audithlq.FMN2AUD.<ssid>.Dyymmdd.Thhmmss
FM/Db2 prefix qual1.<qual2.><qual3.>Dyymmdd.Thhmmss
FM/IMS blank (none) userid.IMSAUDIT.Dyymmdd.Thhmmss
FM/IMS audithlq audithlq.IMSAUDIT.Dyymmdd.Thhmmss
FM/IMS prefix qual1.<qual2.><qual3.>Dyymmdd.Thhmmss
where:
audithlq
Is any 1-8 character constant that is valid in the context of a data set name
userid
Is the user ID creating the data set
Dyymmdd
Is the date of the activity
Thhmmss
Is the time of the activity
prefix
qual1.<qual2.><qual3.>, as defined below

The following values can be specified for each level (qual1, qual2, or qual3) of the data set name prefix.

XXX
Any 1-8 character constant that is valid in the context of a data set name.
&&PREFIX
Indicates that the user's TSO prefix should be used. This will be null if TSO NOPREFIX is in effect.
&&USER
Indicates that the user's logonid (ISPF system variable ZUSER, stored in the shared pool) should be used.
&&UID
Indicates that the user's TSO prefix should be used, when the value is non-blank. When TSO NOPREFIX is in effect, the user's logonid (ISPF system variable ZUSER, stored in the shared pool) should be used.
&&FUNCOD
Indicates that the File Manager internal function code should be used. Specifying this parameter allows the File Manager function that generated the audit log data set to be included in the audit log data set name.
&&SSID
Indicates that the currently connected subsystem name (Db2® or IMS only) should be used. If this symbolic parameter is specified in FMN0POPT or FMN3POPT, the value is ignored, the substituted value is null.
Notes:
  • When a symbolic parameter is specified (any value preceded by &&), a trailing period is required, except for qual3.
  • You cannot specify a combination of characters and symbolic parameters at the same level of the data set name prefix.
  • You cannot use more than one symbolic parameter at the same level of the data set name prefix.
  • You cannot specify a prefix value with more than 3 levels.
  • You can specify a trailing period to distinguish between a high level qualifier value and a prefix value comprising a single level.
Examples:
AUDITHLQ=
Default
AUDITHLQ=FMNAUD,
HLQ value is FMNAUD
AUDITHLQ=FMNAUD.,
Prefix value is FMNAUD
AUDITHLQ=&&USER..FMN1AUD
Two-level prefix
AUDITHLQ=FMNAUD.&&FUNCOD..&&USER
Three-level prefix
AUDITHLQ=FMNAUD.&&USER..&&SSID
Three-level prefix, SSID non-blank (Db2® and IMS only)