CDC Guide for z/OS

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

Back Next

Adding Active Log Data Set Definitions to the Restart Data Set

The installation process creates definitions for at least three active log data sets. With three data sets allocated, two are active and one is always available for selection. The startup procedure for the PowerExchange Logger dynamically allocates the active log data sets named in the restart data sets. Use this procedure to create additional data set definitions as required for your site. You can have a maximum of 31 active logs.

First determine the size and number of active log data sets required for your organization.

To help distinguish log data sets from different PowerExchange Logger subsystems, include the subsystem name in the high-level qualifiers of these data sets. Use the IDCAMS parameters to define the active log data sets. Adjust the CYL parameters for the active log data sets according to the expected volume of logging.

Use the following sample JCL in the #ADDLOGS member of the hlq
.SAMPLIB library, where hlq
the high-level qualifier that you specified during installation, to add active log data sets:

//         JOB
//*-------------------------------------------------------------------* 
//* PowerExchange CDC - DEFINE ACTIVE LOG DATA SETS TO LOGGER          
//*-------------------------------------------------------------------* 
//* REPLACE THE FOLLOWING ITEMS WITH PROPER INSTALLATION VALUES         
//* 1. JCL DATA SET NAMES                                               
//* 2. REPLACE ???? WITH YOUR LOGGER NAME. USING THE LOGGER NAME AS A   
//*    DATA SET NAME QUALIFIER PROVIDES A STANDARD TO INDICATE WHICH    
//*    DATA SET BELONGS TO WHICH LOGGER.                                
//*-------------------------------------------------------------------* 
//DEFLOG   EXEC PGM=EDMLC000,PARM='????,BATCH'                          
//STEPLIB  DD DISP=SHR,DSN=HLQ.LOAD              <=== PWX LOAD 
//EDMPARMS DD DISP=SHR,DSN=YOUR.USERLIB          <=== EDMSDIR,EDMUPARM  
//ERDS01   DD DISP=SHR,DSN=YOUR.????.ERDS01      <=== PRI RESTART DSN   
//ERDS02   DD DISP=SHR,DSN=YOUR.????.ERDS02      <=== SEC RESTART DSN   
//SYSPRINT DD SYSOUT=*                                                  
//SYSIN    DD *                                                         
DEFINE_LOG                                                              
    DSNAME=YOUR.????.PRILOG.DS03,                                       
    COPY=PRILOG                                                         
END                                                                     
DEFINE_LOG                                                              
    DSNAME=YOUR.????.SECLOG.DS03,                                       
    COPY=SECLOG                                                         
END                                                                     
/*

In this JCL, HLQ and YOUR represent high-level qualifiers that you specified during installation. The question marks represent the PowerExchange Logger ID associated with the log data sets.

To add active log data set definitions to the restart data set:

Make a working copy of the sample #ADDLOGS member. Then, edit the copy as required.

The following table describes the JCL statements:

JCL Statement	Description
EXEC	Specify the EDMLC000 program.
PARM	Include the Logger name, followed by BATCH.
STEPLIB DD	Include the PowerExchange CDC load library. If you added the load library to your system's LNKLST concatenation, you do not need to add it to the STEPLIB.
EDMPARMS DD	Specify the name of the user library (YOUR.USERLIB) that contains the PowerExchange Logger EDMUPARMS module options associated with the PowerExchange Logger that uses these data sets.
ERDS01 DD	Specify the data set name of the primary restart data set. Make sure that this name matches the name you used when you created this data set.
ERDS02 DD	Specify the data set name of the backup restart data set. Ensure that this name matches the name you used when you created this data set.
SYSPRINT DD	Specify the output data set for MVS system messages.
SYSIN DD	Specify the PowerExchange Logger command, DEFINE_LOG.