CRASUB*, the batch submit server startup

RSE starts CLIST CRASUB*, which in turn submits an embedded JCL to create a valid environment to execute batch TSO and ISPF commands. Developer for z/OS® uses this environment to run the CARMA server, CRASERV.

CRASUB* is located in FEL.#CUST.CNTL, unless you specified a different location when you customized and submitted the FEL.SFELSAMP(FELSETUP) job. For more details, see Customization setup.

Note: Changes are in effect for all CARMA servers that are started after the update.
Developer for z/OS provides multiple CRASUB* JCL jobs. Each of these sample files is pre-configured for a specific customization scenario:
  • CRASUBCA is configured for batch startup with CA Endevor® SCM RAM.
  • CRASUBMT is configured for batch startup with sample RAMs.

Figure 1 shows a basic CRASUB* skeleton that includes ISPF services.

Figure 1. CRASUB*: CARMA startup using batch submit
PROC 8 CRAPRM1 CRAPRM2 CRAPRM3 CRAPRM4 CRAPRM5 CRAPRM6 CRAPRM7 CRAPRM8
/* SET CRAPRM2=420
SUBMIT * END($$)
//CRA&CRAPRM1  JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1)
//* 
//RUN      EXEC PGM=IKJEFT01,DYNAMNBR=125,REGION=0M,TIME=NOLIMIT 
//* 
//* DD used by RAM 
//*
//* DD used by CARMA server (CRASERV)
//STEPLIB  DD DISP=SHR,DSN=FEL.SFELLOAD
//CRADEF   DD DISP=SHR,DSN=FEL.#CUST.CRADEF
//CRAMSG   DD DISP=SHR,DSN=FEL.#CUST.CRAMSG
//CRASTRS  DD DISP=SHR,DSN=FEL.#CUST.CRASTRS
//CARMALOG DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//*
//* DD used by ISPF (ISPSTART)
//ISPPROF  DD DISP=(NEW,DELETE,DELETE),UNIT=SYSALLDA,
//            LRECL=80,RECFM=FB,SPACE=(TRK,(1,1,5))
//ISPCTL0  DD DISP=(NEW,DELETE,DELETE),UNIT=SYSALLDA,
//            LRECL=80,RECFM=FB,SPACE=(TRK,(5,5))
//ISPCTL1  DD DISP=(NEW,DELETE,DELETE),UNIT=SYSALLDA,
//            LRECL=80,RECFM=FB,SPACE=(TRK,(5,5))
//ISPMLIB  DD DISP=SHR,DSN=ISP.SISPMENU
//ISPPLIB  DD DISP=SHR,DSN=ISP.SISPPENU
//ISPSLIB  DD DISP=SHR,DSN=ISP.SISPSENU
//ISPTLIB  DD DISP=SHR,DSN=ISP.SISPTENU
//*
//* DD used by TSO (IKJEFT01)
//SYSPROC  DD DISP=SHR,DSN=#FEL.SFELPROC               * CRAALLOC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD *	
%CRAALLOC ISPSTART PGM(CRASERV) PARM(&CRAPRM1 &CRAPRM2 &STR(+)
&CRAPRM3 &STR(+) 
&CRAPRM4 &STR(+) 
&CRAPRM5 &STR(+) 
&CRAPRM6 &STR(+) 
&CRAPRM7 &STR(+) 
&CRAPRM8 &STR(+) 
)
$$
EXIT CODE(0)
Note:
  • If you alter the SYSTSIN data, ensure that there is at least one blank before the closing round bracket (“)”) of the PARM() statement to simplify processing of the string.
  • You can add your own DD statements and data set concatenations to customize the CARMA TSO environment, thus mimicking a TSO logon procedure.
  • You can use the CRAPRM* variables in the CLIST and JCL definitions.
    • &CRAPRM1.: Port number.
    • &CRAPRM8.: Site-specific value set by the user exit referenced by the system.exit directive in CRASRV.properties.
  • Optionally, you can change CARMA's timeout value by uncommenting and modifying the SET CRAPRM2=420 line in the CRASUB* CLIST. The timeout value is the number of seconds that CARMA waits for the next command from the client. Setting a value of 0 results in the default timeout value, currently 420 seconds (7 minutes).
  • Details of the CARMA startup process are shown in rsecomm.log when the server ends. For more information on setting the detail level of rsecomm.log, see the IBM® Explorer for z/OS Host Configuration Guide (SC27-8437)..