Information Management IBM InfoSphere Classic Change Data Capture for z/OS, Version 11.1

Running the installation customization utility

The installation customization utility generates the JCL and configuration members needed in the USERHLQ.USERSAMP and USERHLQ.USERCONF data sets based on the values that you provide in the customization parameters file.

The installation customization utility performs these functions:
You use the USERHLQ.USERSAMP(CECCUSC2) job to run the installation customization utility. You specify the following input as parameters:
CACINHLQ=CEC.V11R1M00
The value specified for the CACINHLQ keyword must be the high-level qualifier for Classic distribution data sets produced by the SMP/E installation. This value is automatically populated with the value previously specified as input to the user samples allocation utility.
CACUSHLQ=USER.V11R1M00.CDCSRC
The value specified for the CACUSHLQ keyword must be the high-level qualifier for the USERHLQ.USERSAMP and USERHLQ,USERCONF data sets that were created or updated by the user samples allocation utility. This value is automatically populated with the value previously specified as input to the user samples allocation utility.
MEMBER=(member-name, ...)
This is an optional parameter. The value specified for the MEMBER keyword identifies a list of one or more member names to process. Only a subset of the members associated with the specified SERVERROLE parameter is processed. If you specify multiple member names, you must separate the names with commas and enclose the names in parentheses.

All members are processed when this parameter is not specified.

OVERWRITE=YES|NO
The value specified for the OVERWRITE keyword indicates how to process existing members of target data sets, for example the USERHLQ.USERSAMP and USERHLQ.USERCONF data sets.
  • When you specify OVERWRITE=NO, existing members of the target data sets are not replaced. OVERWRITE=NO is the default.
  • When you specify OVERWRITE=YES, existing members of the target data sets are replaced.
Example: OVERWRITE=NO is in effect. Members CACCFGDS and CACCFGUT already exist in the target data set. Member CACSX04 does not exist in the target data set.
Member   Status
-------- --------
CACCFGDS CACCFGDS not replaced in DDN(USERSAMP)
CACCFGUT CACCFGUT not replaced in DDN(USERSAMP)
CACSX04  Processed successfully in DDN(USERSAMP)
Example: OVERWRITE=YES is in effect. The processing status for the same members shown in the previous example appear as follows (whether or not any of these members previously existed in the target data set):
Member   Status
-------- --------
CACCFGDS Processed successfully in DDN(USERSAMP)
CACCFGUT Processed successfully in DDN(USERSAMP)
CACSX04  Processed successfully in DDN(USERSAMP)
The processing summary information produced at the bottom of the report identifies the number of members that were stored successfully and the number of members that were not replaced. For example:
Summary:
   Members Successful:       90     
   Members in Error:          0     
   Members Not Replaced:      0     
   Members Processed:        90
SERVERROLE=CDC_IMS_SRC
The value of the SERVERROLE keyword specifies that the server environment being installed and customized contains the components required for a source server environment. Specify the value CDC_IMS_SRC to install the components required for a source server.

The utility produces a summary report that is written to the SYSTSPRT DD that is specified in the JCL. The report lists the partitioned data sets and the data set members that were processed. The final summary lists the total number of members processed, the number that were successful, and the number with errors.

The following figure shows sample output written to SYSTSPRT.
Figure 1. Sample output for the installation customization summary report.
********************     Installation Customization    ***********************
                             Summary Report

CACCUSX2 compiled on 2012-08-15 08:46:51 by REXXC370 3.48                       
Execution timestamp: 2012-08-15 08:49:39  MVS Product ID: z/OS 01.10.00 SMF ID: SYE9  System ID: 
------------------------------------------------------------------------------------------------

Effective Parameters:              
                                   
  CACINHLQ:    CEC.V11R1M00     
  CACUSHLQ:    USER.V11R1M00.CDCSRC     
  OVERWRITE:   No                
  SERVERROLE:  CDC_IMS_SRC

	
Processing parameters file: USER.V11R1M00.CDCSRC.USERSAMP  Member: CECCUSPC  
                                                                                                                                                     
Processing Members for Product: All  Role: Common  
Member     Status                                  
--------   --------                                
CACCFGDS   Processed successfully in DDN(USERSAMP) 
CACCFGUT   Processed successfully in DDN(USERSAMP) 
CACPRTLS   Processed successfully in DDN(USERSAMP) 
CACLGFLT   Processed successfully in DDN(USERSAMP) 
CACSX04    Processed successfully in DDN(USERSAMP)
                       
Processing Members for Product: Classic Change Data Capture for z/OS Role: Common 
Member     Status                                                
--------   --------                   
CECCDCFG   Processed successfully in DDN(USERSAMP)
CECCDCAT   Processed successfully in DDN(USERSAMP) 
CECCDSLS   Processed successfully in DDN(USERSAMP) 
CECCDSUB   Processed successfully in DDN(USERSAMP)
CECCDSRC   Processed successfully in DDN(USERSAMP)
CECCDVCD   Processed successfully in DDN(USERSAMP)
. . .
. . .
                           

Processing Members for Product: Classic Change Data Capture for z/OS Role: CDC_IMS_SRC 
Member     Status                                                 
--------   --------                                               


Summary:                        
   Members Successful:       24 
   Members in Error:          0 
   Members Not Replaced:      0 
   Members Processed:        24

Return Status: 0

© Copyright IBM Corporation 2011. All Rights Reserved.