Start of change

Customizing the set up procedure DFHMAINJ

The DFHMAINJ sample job creates the runtime libraries for CICS® Service Flow Runtime. It also copies all of the system libraries to the runtime libraries and customizes them based on a set of parameters that you can edit in the JCL before running the job.

Before you begin to customize the JCL, copy member DFHMAINJ from the .SCIZSAMP library to a new location. This ensures that any modifications to DFHMAINJ are not overwritten when system maintenance or version upgrades are applied.
Edit DFHMAINJ as follows:
  1. Specify a valid job card, change hlqual to the high level qualifier of your CICS SFR libraries, and change syshlq to the high level qualifier of your SMP/E installation libraries.
  2. Provide values for the mandatory parameters and any optional parameters if required. For any parameters that you do not require, replace the example parameter values with blanks. Do not remove or comment out any of the optional parameters from the job. The list of parameters are described in DFHMAINJ parameters.
  3. Optional: When APAR PK32131 is applied, the parameter values in DFHMAINJ are validated before the customization of the libraries take place. If you do not want validation to take place, edit DFHMAINJ to change validate to novalidate on the DFHMAINR invocation statement in the //REXX step.
  4. Submit DFHMAINJ and check the output. You should see the following messages in the //SYSTSPRT of the DFHMAINJ job output:
    CIAI1002I SCIZSAMP customization beginning.                   
    CIAI1000I Validation of input parameters is taking place.     
    .
    .
    CIAI1011I SCIZSAMP customization ended without errors.
    If there is a problem with any of the parameter values that you have specified and validation is switched on, the customization of the libraries does not take place. The job output contains one or more CIAI prefixed messages that describe what parameter values are causing the errors.
  5. Optional: If you have a BTS repository already installed and defined in the CICS region, you can use this in the runtime environment instead of the new BTS file that CICS SFR creates. Edit the member DFHMASCC in .SCIZSAMP to remove the RDO definition for the BTS file. DFHMASET still creates a new BTS file when you run it, but it is not referenced by CICS SFR.
Three runtime libraries are created and the members copied into them. These libraries are If the job fails, no customization takes place. When you have validation switched on, if there is a problem with one of the parameter values in the job, no customization takes place. The job output contains one or more error messages explaining why the customization could not take place. After you have corrected the cause of the error, rerun DFHMAINJ to perform the customization on your runtime libraries.
The customized DFHMAINJ JCL parameters could look as follows:
*****************************************************************               
JOB1        //++++++++ JOB ,CLASS=M,REGION=0M,                                  
JOB2        //         NOTIFY=&SYSUID,MSGCLASS=H                                
JOB3        //*                                                                 
*                                                                               
SHLQ        ANTZ.DFHMA000.INC10                                               
QUAL        WARDABL.ANTZTEST                                            
VOLSER      P2P210                                                              
RDOLIST     CICSSFRL                                                             
MQ          YES                                                           
CSDNAME     WARDABL.ZED3.DFHCSD                                                    
HLQCICS     CTS310.CICS640                                                       
HLQCOBOL    PP.COBOL390.V330                                                      
HLQCEE      CEE                                       
HLAPPLID    IYK2ZIO4                                                         
WSDIR_REQ   /hfs/wsbind/file/directory/structure/                    
CONFIG_REQ  /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11requester.xml                                           
SHELF_REQ   /var/cicsts/                                                        
WSDIR_PROV  /hfs/wsbind/file/directory/structure/                               
CONFIG_PROV /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11provider.xml                                            
SHELF_PROV  /var/cicsts/                                                        
*                                                                               
*****************************************************************               
*                                                               *               
* Optional values.                                              *               
*                                                               *               
* NOTE:                                                         *               
* If you specified "MQ YES" then you MUST specify a value for   *               
* HLQMQ.                                                        *               
*                                                               *               
*****************************************************************               
PREFIX      TEST                                                         
HLQMQ       MQM.V600                                                         
THE_QMGR    QG2C                                                            
CICS.INITQ  IYK2ZIO4.INITQ                                                     
HLSYSID     NIO4                                                      
*                                                                               
/*                                                                              
// 
End of change