AUDITHLQ
- 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 The format of generated data set names.
ZDT component | AUDITHLQ value | Audit log data set name format |
---|---|---|
Z Data Tools Base component, ZDT/CICS | blank (none) | userid.HFMLOG.Dyymmdd.Thhmmss |
Z Data Tools Base component, ZDT/CICS | audithlq | audithlq.userid.HFMLOG.Dyymmdd.Thhmmss |
Z Data Tools Base component, 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)