CONFIG LOGFILE statement

Logging records activity within the Application Performance Analyzer started task. Log data will always be written to SYSOUT, but you have the option of also writing this data to log data sets. LOGFILE settings allow you manage these data sets. The following settings might be specified:

Note: The alphabetical order specified below is not the order of the parameters in the configuration file.

LogGDG

Optional. Dynamically modifiable.

If you have specified LogToFile=YES, then LogGDG allows you to specify whether the log data sets will be allocated as GDGs or normal sequential data sets. If you specify LogGDG=YES, you must first create the Generation Data Group Index using an index name of yourhlq.LOG (or LogHLQ.LOG if you choose to use LogHLQ). YES and NO are the only valid values.

Default: NO.

Note: A GDG log file cannot be shared by multiple instances of Application Performance Analyzer. A second started task with the same GDG log file will fail on start up with messages IKJ56225I and CAZ1030S. A unique GDG log file must be defined for each instance of Application Performance Analyzer.

LogHLQ

Optional. Dynamically modifiable.

Specifies the high-level qualifier to be used when creating log data sets. LogHLQ must comply with the JCL rule for specifying a data set name. It can be no more than 17 characters long. A data set will only be created if LogToFile=YES is specified.

If this parameter is not specified, the value that you specify for HLQ on the CONFIG BASIC statement will be used.

Default: none.

LogPRIM

Optional. Dynamically modifiable.

If you have specified LogToFile=YES, then LogPRIM allows you to specify the size of each log data set that is allocated. No secondary specification is permitted; therefore, when the log data set has filled, it will be closed and a new log data set will be allocated.

Default: 15.

LogToFile

Optional.

Specifies whether you want log data to be written to permanent data sets. YES and NO are the only valid values.

Default: NO.

Note: It is recommended that LogToFile be set to YES. The log can be used to help diagnose problems.

LogUNIT

Optional. Dynamically modifiable.

If you have specified LogToFile=YES, then LogUNIT allows you to specify whether you want the log data set to be allocated in Tracks or Cylinders. T and C are the only valid values.

Default: T.

SMSClass

Optional. Dynamically modifiable.

This setting is used to assign the SMS class values that Application Performance Analyzer is to use to allocate the log file data sets. It overrides the any values specified in the DefaultSMSClass setting in CONFIG BASIC. Omitted positional parameters use the corresponding positional parameter values from DefaultSMSClass.

The syntax for this setting is SMSClass=(mgmt,stg,data) where the positional parameters are:

mgmt = The management class name. It must be one to eight alphanumeric or national characters, as defined by the storage administrator at your installation.
stg = The storage class name. It must be one to eight alphanumeric or national characters, as defined by the storage administrator at your installation.
data = The data class name. It must be one to eight alphanumeric or national characters, as defined by the storage administrator at your installation.