Operation Log Switch

You can back up existing operation logs (file access log and command execution log) and switch existing files to new ones. The output destination, the naming conventions, and the generational management of backup files are the same as in the case of automatic switching. For details, refer to the following:

HULFT10 for zOS Administration Manual : Operation logs

Operation Log Switch Program (XROPLBK)

Program Name

XROPLBK

Execution parameters (for EXEC statement)

FL|CL|ALL|FL,AUT|CL,AUT|ALL,AUT

These parameters define the operation logs to be switched. (Optional)

Define one of the following parameters. You cannot define two or more of the parameters simultaneously.

FL

Defining this parameter switches only the file access log to a new file and backs up the log.

CL

Defining this parameter switches only the command execution log to a new file and backs up the log.

ALL

Defining this parameter switches both the file access log and the command execution log to new files and backs up the logs.

FL,AUT

Defining this parameter backs up only the file access log.

CL,AUT

Defining this parameter backs up only the command execution log.

ALL,AUT

Defining this parameter backs up both the file access log and the command execution log.

Defaulting these parameters sets 'ALL.'

When you define 'FL,AUT,' 'CL,AUT,' or 'ALL,AUT,' note the following points:

Note

If a backup fails after the operation logs are switched, you must remove the cause of the failure and then back up the operation logs again.

Unless a backup of the operation logs ends successfully, any subsequent switching of the operation logs will fail. Therefore, define and back up again the operation logs that are not backed up.

Note that when you attempt to create a backup by defining the operation logs for which the backup has failed, the command execution log is not output.

Use the following procedure to back up the operation logs by defining the operation logs for which the backup has failed:

  1. Check HULFT operation environment including the System Environment Settings and the contents of the JCL that was executed, and define the operation log backup.

  2. If you modify the System Environment Settings while HULFT is running, restart HULFT.

  3. Execute XROPLBK by using one of the following parameters to define the Operation Log files for which the backup has failed:

    Types of Operation Logs for Which Backup Failed

    Parameter to Be Defined

    Only File Access Log

    FL,AUT

    Only Command Execution Log

    CL,AUT

    Both File Access Log and Command Execution Log

    ALL,AUT
= Remarks =

Operation log data is not output to the Operation Log files to be backed up. To back up the files to which operation log data is output, you must switch the operation logs before you back up the files.

Define 'FL,' 'CL,' or 'ALL' when you execute the Operation Log Switch program (XROPLBK).

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the following:

HULFT10 for zOS Administration Manual : Explanation of each field

Format of definition card

OPLSELECT=Operation Log Output Option 
OPLCMD1=Command Execution Log Output Data Set Name 1 
OPLCMD2=Command Execution Log Output Data Set Name 2 
OPLFILE1=File Access Log Output Data Set Name 1 
OPLFILE2=File Access Log Output Data Set Name 2 
OPLCHARACTER=Operation Log User-specified Character 
OPLEBCDIC=Operation Log EBCDIC Code 
OPLCMDBKVOL=Command Execution Log Backup Output Volume Name 
OPLFILEBKVOL=File Access Log Backup Output Volume Name 
OPLUNIT=UNIT Name of Operation Log Output Data Set 
OPLCMDBK=Command Execution Log Backup Output Data Set Name 
OPLFILEBK=File Access Log Backup Output Data Set Name 
OPLBKJOBNM=Operation Log Auto Switch Job Name

= Remarks =

When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs.

Example of JCL

//XROPLBK  JOB  CLASS=A,MSGCLASS=B                                              
//XROPLBK  EXEC PGM=XROPLBK,PARM='ALL'                                          
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File