AUDITHLQ
- 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.
| FM component | AUDITHLQ value | Audit log data set name format |
|---|---|---|
| Base, FM/CICS | blank (none) | userid.FMNLOG.Dyymmdd.Thhmmss |
| Base, FM/CICS | audithlq | audithlq.userid.FMNLOG.Dyymmdd.Thhmmss |
| Base, 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)