Command Reference

10.5.4
- 10.5.5
- 10.5.3
- 10.0

Back Next

DEFINE_LOG Command

Adds PowerExchange Logger for z/OS log definitions to the restart data set. You can add definitions for the following types of log data sets:

Additional active log definitions

Replacement active log definitions

Replacement archive log definitions

PowerExchange installation creates definitions for at least three active log data sets. You can define additional active log data sets, up to a maximum of 31 active logs.

Include the DEFINE_LOG control statements in batch jobs that include log maintenance tasks. PowerExchange provides sample JCL for adding active log data set definitions in the #ADDLOGS member of the SAMPLIB library.

Syntax

To define PowerExchange Logger active logs, use the following syntax for the control statements:

DEFINE_LOG
DSN=data_set_name,
COPY={PRILOG|SECLOG},
[STARTRBA=X’start_rba’,ENDRBA=X’end_rba’]
END

To define PowerExchange Logger archive logs, use the following syntax for the control statements:

DEFINE_LOG
DSN=data_set_name,
[STARTRBA=X’start_rba’,ENDRBA=X’end_rba’,]
[TODSTATIME=X’start_time’,TODENDTIME=X’end_time’,]
{VOL1=archivelog1_volser|VOL2=archivelog2_volser}
END

Use the following syntax rules:

If you specify STARTRBA, you must also specify ENDRBA.

If you specify TODSTATIME, you must also specify TODENDTIME.

For archive logs, you must specify either VOLUME1 or VOLUME2. Do not specify both.

Parameter Descriptions

You can specify the following parameters for DEFINE_LOG:

COPY: Indicates whether to define the data set for the primary or secondary active logs. Enter one of the following options:

PRILOG. Defines a primary log data set.

SECLOG. Defines a secondary log data set, which acts as a backup copy.; This parameter is required for active logs.
{DSN|DSNAME|LOG_DSNAME}: Specifies a fully-qualified log data set name. Maximum length is 44 characters.
END: Indicates the end of the DEFINE_LOG control statement for a log data set.
ENDRBA: Specifies the RBA of the end of the replacement log data set that is named by the DSNAME parameter. A replacement log data set is one that replaces a previously existing log file. Enter this RBA value in hexadecimal format, beginning with the letter “X” and then adding exactly 12 hexadecimal digits enclosed in single-quotation marks, for example, X'0000004552FF'. If you do not know this RBA value, you can get it either by reviewing the messages that were generated when the log data set was originally created or by running the PowerExchange Logger DISPLAY OBJECT=LOG command.; This parameter is required only for replacement active or archive log data sets. Do not use the parameter if you are defining a new active log data set.; You must also specify the STARTRBA parameter. The STARTRBA value must be less than the ENDRBA value.
STARTRBA: Specifies the RBA of the start of the replacement log data set that is named by the DSNAME parameter. A replacement log data set is one that replaces a previously existing log file. Enter this RBA value in hexadecimal format, beginning with the letter “X” and then adding exactly 12 hexadecimal digits enclosed in single-quotation marks, for example, X'000000422108'. If you do not know this RBA value, you can get it either by reviewing the messages that were generated when the log data set was originally created or by running the PowerExchange Logger DISPLAY OBJECT=LOG command.; This parameter is required only for replacement active or archive log data sets in a non-Post-Log-Merge environment. Do not use the parameter if you are defining a new active log data set.; You must also specify the ENDRBA parameter. The ENDRBA value must be greater than the STARTRBA value.
TODENDTIME: For a Post-Log-Merge environment, specifies the timestamp of the end of the replacement archive log data set that is named in the DSNAME parameter. A replacement archive log data set is one that replaces a previously existing log file. Enter this timestamp value in hexadecimal format, beginning with the letter “X” and then adding exactly 16 hexadecimal digits enclosed in single-quotation marks, for example, X'BDCO5246A8723542'. If you do not know this timestamp value, you can get it either by reviewing the messages that were generated when the log data set was originally created or by running the PowerExchange Logger DISPLAY OBJECT=LOG command.; This parameter is required only for replacement archive log data sets in a Post-Log-Merge environment. Do not use the parameter if you are defining a new log data set or if you do not use the Post-Log Merge function.; You must also specify the TODSTATIME parameter. The TODSTATIME value must be less than the TODENDTIME value.
TODSTATIME: For a Post-Log-Merge environment, specifies the timestamp of the start of the replacement archive log data set that is named by the DSNAME parameter. A replacement archive log data set is one that replaces a previously existing archive log file. Enter this value in hexadecimal format, beginning with the letter “X” and then adding exactly 16 hexadecimal digits enclosed in single-quotation marks, for example, X'BDCO4135624371A8'. If you do not know this timestamp value, you can get it either by reviewing the messages that were generated when the archive log data set was originally created or by running the PowerExchange Logger DISPLAY OBJECT=LOG command.; This parameter is required only for replacement archive log data sets in a Post-Log-Merge environment. Do not use the parameter if you are defining a new log data set or if you do not use the Post-Log Merge function.; You must also specify the TODENDTIME parameter. The TODENDTIME value must be greater than the TODSTATIME value.
{VOL1|VOLUME1|COPYVOL1}: For archive logs only, specifies the volume serial number, also called volser
, where the archive log data set is located. Use this parameter only for a primary archive log data set.
{VOL2|VOLUME2|COPYVOL2}: For archive logs only, specifies the volume serial number, also called volser
, where the archive log data set is located. Use this parameter only for a secondary archive log data set.

Example

The following command and control statements define a primary archive log data set that is named ARCHLOG1.PWXL.LG1.D2007331.T1536523 in a non-Post-Log-Merge environment:

DEFINE_LOG
DSN=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523,
VOL1=DSK38F,
STARTRBA=X'000000168000',ENDRBA=X'0000002CFFFF'
END

The resulting output is:

L O G   S T A R T
PWXEDM172502I EDM Logger BATCH initialization in-progress product level V2.4.05 08/31/2006
PWXEDM172638I Logger system timestamp for ERDS = 2008.107 15:11:09.49
DEFINE_LOG DSNAME=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523,
                     VOL1=DSK38F,                                                 
                     STARTRBA=X'000000168000',ENDRBA=X'0000002CFFFF'   END           
PWXEDM172572I Logger input commands accepted execution started
PWXEDM172506I EDM Logger BATCH Shutdown in progress
PWXEDM172508I EDM Logger #### TASK EDMLIPC0 COMPLETE RC=00
PWXEDM172508I EDM Logger #### TASK EDMLCKP0 COMPLETE RC=00
PWXEDM172508I EDM Logger #### TASK EDMLRLM0 COMPLETE RC=00
PWXEDM172508I EDM Logger #### TASK EDMLLLG0 COMPLETE RC=00
PWXEDM172509I EDM Logger BATCH shutdown complete
L O G   E N D

Rename Saved Search

Table of Contents

Command Reference

Command Reference

DEFINE_LOG Command

DEFINE_LOG Command

Syntax

Parameter Descriptions

Example