Audit data set configuration

The format of the audit log data set name is determined by the setting of the AUDITHLQ parameter in the FMN0POPI definition in FMN3POPT. See AUDITHLQ for more information about the AUDITHLQ option.

The following data set name formats may be generated:

  • userid.FMNLOG.Dyymmdd.Thhmmss (when AUDITHLQ= (blank))
  • audithlq.userid.FMNLOG.Dyymmdd.Thhmmss (when AUDITHLQ=audithlq)
  • qual1.<qual2.><qual3.>Dyymmdd.Thhmmss (when AUDITHLQ=qual1.<qual2.><qual3>)

where:

audithlq
Any 1-8 character constant that is valid in the context of a data set name.
userid
The user ID creating the data set.
Dyymmdd
The date of the activity.
Thhmmss
The time of the activity.

When AUDITHLQ contains one or more periods, the AUDITHLQ value is treated as a data set prefix, with one, two or three levels. Each level of the prefix can be:

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 by used. This is null if TSO NOPREFIX is in effect and, after substitution, the appropriate level of the audit log data set name prefix is also null.
&&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 TSO 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.

Set the AUDITHLQ parameter in the FMN0POPI macro for the FMN3POPT to the required value, based on the above information and your site's requirements.

You can print the information in a File Manager CICS® audit data set using the FM/CICS Print Audit Trail utility. To do this select option 3.6 from the FM/CICS Primary Option Menu.

Note:
  • The format of the data set name for audit log data sets created under FM/CICS is the same as that for audit log data sets created by the File Manager base function. To distinguish between the two, use the AUDITHLQ option in FMN0POPT and FMN3POPT as appropriate.
  • If you specify a value for AUDITHLQ in FMN3POPT, this value will apply to audit data sets for FM/CICS and for data sets for File Manager base function running under FM/CICS.