AUDITHLQ

Read syntax diagramSkip visual syntax diagram
>>-AUDITHLQ=--+-user-defined audithlq-+------------------------><
              '-user-defined prefix---'   

AUDITHLQ
Specifies an optional high-level qualifier, or data set prefix, for the Z Data Tools audit log data sets.
The format of the generated data set names is shown in Table 1.
Table 1. The format of generated data set names
ZDT component AUDITHLQ value Audit log data set name format
Base, ZDT/CICS blank (none) userid.HFMLOG.Dyymmdd.Thhmmss
Base, ZDT/CICS audithlq audithlq.userid.HFMLOG.Dyymmdd.Thhmmss
Base, ZDT/CICS prefix qual1.<qual2.><qual3.>Dyymmdd.Thhmmss
ZDT/Db2 blank (none) userid.HFM2AUD.<ssid>.Dyymmdd.Thhmmss
ZDT/Db2 audithlq audithlq.HFM2AUD.<ssid>.Dyymmdd.Thhmmss
ZDT/Db2 prefix qual1.<qual2.><qual3.>Dyymmdd.Thhmmss
ZDT/IMS blank (none) userid.IMSAUDIT.Dyymmdd.Thhmmss
ZDT/IMS audithlq audithlq.IMSAUDIT.Dyymmdd.Thhmmss
ZDT/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 Z Data Tools internal function code should be used. Specifying this parameter allows the Z Data Tools 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 HFM0POPT or HFM3POPT, 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=HFMAUD,
HLQ value is HFMAUD
AUDITHLQ=HFMAUD.,
Prefix value is HFMAUD
AUDITHLQ=&&USER..HFM1AUD
Two-level prefix
AUDITHLQ=HFMAUD.&&FUNCOD..&&USER
Three-level prefix
AUDITHLQ=HFMAUD.&&USER..&&SSID
Three-level prefix, SSID non-blank (Db2 and IMS only)