CDC Guide for z/OS

10.5.1
- 10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.3
- 10.5.2
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Back Next

DEFINE_LOG Command

The DEFINE_LOG command adds log definitions to the emergency restart data set.

Use the DEFINE_LOG command to perform the following tasks:

Add a definition for a new active log to the restart data set.

Add a definition for a replacement active log to the restart data set.

Add a definition for a replacement archive log to the restart data set.

The DEFINE_LOG command has the following syntax for active logs:

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

The DEFINE_LOG command has the following syntax for archive logs:

DEFINE_LOG DSName=data_set_name,
COPY1VOL|COPY2VOL=volser,UNIT=unit_name,
STARTRBA=X’start_rba’,ENDRBA=X’end_rba’
END

You can also run the DEFINE_LOG command interactively: for active and archive logs. The following example shows how to define an active PRILOG data set:

F procname,DEFINE_LOG DSNAME=data_set_name,COPY=PRILOG

For the interactive form of the DEFINE_LOG command, if the length of the command is greater than 110 characters, you can split the command over two lines. You must use a comma at the end of the first line, which indicates to the logger that the command is not yet complete, and to wait for more input before processing the command.

For example, to define the first copy of an archive log, you can enter the following command:

F procname,DEFINE_LOG DSNAME=data_set_name,COPY1VOL=volser,UNIT=unit_name,

F procname,STARTRBA=X'start_rba_value',ENDRBA=X'end_rba_value'

The following table describes the DEFINE_LOG parameters:

Parameter	Definition	Valid Values
DSNAME	Specifies a log data set name.	The data set name can be up to 44 characters long.
COPY	Specifies which copy of the active log you are defining. This parameter is valid only when you are specifying active log options.	PRILOG indicates that you are defining a primary log data set for the PowerExchange Logger to use. SECLOG indicates that you are defining a secondary log (backup copy).
COPY1VOL \| COPY2VOL	Specifies which copy of the archive log you are creating.	The six-character volume name where the archive log resides.
STARTRBA	Specifies the log RBA of the beginning of either the replacement active log data set or the replacement archive log data set volume specified by data_set_name. You can obtain the start RBA from messages or by using the PowerExchange Logger DISPLAY command. You must enter this parameter for archive log definitions. It is optional for active log definitions.	Enter 12 hexadecimal digits for the rba value preceding them with the character X and enclosing them in single quotation marks. For active logs, use this parameter only for replacement log data sets. For archive logs, this parameter is required.
UNIT	Specifies the z/OS unit name of the archive log you are creating.	The z/OS unit name that matches the volume name you specified in the COPY1VOL or COPY2VOL parameter.
ENDRBA	Specifies the log RBA of the end of either the replacement active log data set or the replacement archive log data set volume specified by data_set_name. You can obtain the end RBA from messages or by using the PowerExchange Logger DISPLAY command. You must enter this parameter for archive log definitions. For active log definitions, this parameter is required if you specified STARTRBA.	Enter 12 hexadecimal digits for the rba value preceding them with the character X and enclosing them in single quotation marks. For active logs, use this parameter only for replacement log data sets. For archive logs, this parameter is required.
END	Indicates that the input for this command is complete.	This parameter is required.

Rename Saved Search

Table of Contents

CDC Guide for z/OS

CDC Guide for z/OS

DEFINE_LOG Command

DEFINE_LOG Command