Running CICS® VR JCL customization

CICS® VR JCL customization is an optional step that assists you to customize the CICS® VR sample jobs, clists, and ISPF dialog skeletons.

This function copies the SDWWCNTL and SDWWSENU/SJPN libraries to your specified output data sets and then sets symbolic variables, such as a high-level qualifier of the CICS® VR data sets and RCDS prefix and suffix, to specified values to suit your environment.

To start the CICS® VR JCL customization, run member DWWCSTG1 of the SDWWCNTL library. The function requires two parameters to be passed to it:
  1. The high-level qualifier and, optionally, the suffix of the CICS® VR data sets as &HLQ[/&SUFFIX].
  2. The national language to be used in messages and on panels &LANG. Two languages are supported:
    • ENU English, the default.
    • JPN Japanese
This example shows a command that you enter at an ISPF command line to start the CICS® VR JCL customization. In this example the CICS VR data sets do not have a suffix in the names:
tso ex ’DWW.V630.SDWWCNTL(DWWCSTG1)’  ’DWW.V630  ENU’
This example shows a command when a suffix is specified for CICS® VR data sets: 
tso ex 'DWW.V630.SDWWCNTL.STAGE01(DWWCSTG1)' 'DWW.V630/STAGE01  ENU'

To customize CICS® VR, on the Welcome panel, DWWCST00, press Enter to proceed to the DWWCST01 panel that presents the customization parameters that you can modify.

Here is an example of setting some parameters on the DWWCST01 panel that are matched with those parameters that are used in Overview of CICS VR installation.
Output Data sets:                                              
OUTPUT DSN FOR SDWWCNTL  . . . . DWW.V630.SDWWCNTL.OUT 
OUTPUT DSN FOR SDWWSENU/SJPN . . DWW.V630.SDWWSENU.OUT    
…
RCDS data set names:                              
RCDS PREFIX  . . . . . . . . . DWWUSER.V630       
GRPNAME SUFFIX  . . . . . . .  PROD
…
IVP test data allocation parameters:            
CUSTOMIZE IVP JOBS . . . . . . YES  (YES or NO) 
HLQ FOR VSAM DATA SETS . . . . DWWUSER.V630     
…
LOG STREAM NAME  . . . . . . . DWWUSER.IVP.FILELOG
…
Setting up the ISPF interface:                                      
HLQ FOR USER DATA SETS (ISPFILE, DWWMSG, etc) . . DWW.&ZUSER         
USE STEPLIB DD FOR CICS VR LIBRARIES  . . . . . . YES  (YES or NO)   
USE CICS VR EXIT LOAD LIBRARY . . . . . . . . . . YES  (YES or NO)   
USE CICS VR EXIT LOAD LIBRARY . . . . . . . . . . YES  (YES or NO)
…

For the list of all customization parameters, see Customization parameters.

When the CICS® VR customization function is complete, the customized output data sets, in this example, which is known as SDWWCNTL.OUT and SDWWSENU/SJPN.OUT, are used instead of the installed CICS® VR SDWWCNTL and SDWWSENU/SJPN, without extra modifications.