Customizing the setup procedure DFHMAINJ

Stabilized feature: Service Flow Runtime and Service Flow Modeler capability in IBM Developer for z/OS 14.2.3 are stabilized. Consider exposing and orchestrating applications as API services by using z/OS Connect Enterprise Edition or CICS® web services, or by writing web applications in Java or Node.js. See also Stabilization notices and discontinued functions.

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

Before you begin to customize the JCL, copy member DFHMAINJ from the .SCIZSAMP library to a new location. Copying the member ensures that any modifications to DFHMAINJ are not overwritten when system maintenance or version upgrades are applied.

Procedure

Edit DFHMAINJ as follows:

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.
Provide values for the mandatory parameters and any optional parameters if required.
The list of parameters is described in DFHMAINJ parameters.
Optional: If you are using IBM® Enterprise COBOL for z/OS® V5.1 create hlqual.SCIZLOAD as a PDSE dataset. Change the JCL in the CREATE step for SCIZLOAD from 'DSNTYPE=PDS' TO 'DSNTYPE=LIBRARY'.
Optional: By default, 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.
Submit DFHMAINJ and check the output.
You will see the following messages in the //SYSTSPRT of the DFHMAINJ job output:
```
DFHMAI1002I SCIZSAMP customization beginning.                   
DFHMAI1000I Validation of input parameters is taking place.     
.
.
DFHMAI1011I SCIZSAMP customization ended without errors.
```
If any of the parameter values that you have specified has a problem and validation is switched on, the customization of the libraries does not take place. The job output contains one or more DFHMAI prefixed messages that tell you which parameter values are causing the errors.
Optional: If you have a BTS repository already installed and defined in the CICS region, you can use it 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.

Results

Three runtime libraries are created and the members copied into them:

.SCIZSAMP, containing JCL, parameter members, and sample jobs
.SCIZMAC, containing copybooks
.SCIZLOAD, containing executable members

If the job fails, no customization takes place. When you have validation switched on, if one of the parameter values in the job has a problem, no customization takes place. The job output contains one or more error messages explaining why the customization did not take place. After you have corrected the cause of the error, rerun DFHMAINJ to perform the customization on your runtime libraries.

Example

The customized DFHMAINJ JCL parameters will look similar to the following JCL:

*****************************************************************               
JOB1        //++++++++ JOB ,CLASS=M,REGION=0M,                                  
JOB2        //         NOTIFY=&SYSUID,MSGCLASS=H                                
JOB3        //*                                                                 
*                                                                               
SHLQ        ANTZ.DFHMA000.INC10                                               
QUAL        WARDABL.ANTZTEST                                            
VOLSER      P2P210                                                              
RDOLIST     CICSSFRL                                                             
CSDNAME     WARDABL.ZED3.DFHCSD                                                    
HLQCICS     CTS310.CICS640                                                       
HLQCOBOL    PP.COBOL390.V330                                                      
HLQCEE      CEE                                                                                                
WSDIR_REQ   /zfs/wsbind/file/directory/structure/                    
CONFIG_REQ  /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11requester.xml                                           
SHELF_REQ   /var/cicsts/                                                        
WSDIR_PROV  /zfs/wsbind/file/directory/structure/                               
CONFIG_PROV /usr/lpp/cicsts/samples/pipelines/\                                 
            \basicsoap11provider.xml                                            
SHELF_PROV  /var/cicsts/                                                        
*                                                                               
*****************************************************************               
*                                                               *               
* Optional values.                                              *               
*                                                               *               
*                                                               *               
*****************************************************************               
PREFIX      TEST                                                         
*                                                                               
/*                                                                              
//