Provide mechanism for setting BZUEXTRA with location of loadlib dataset (PDS) containing business load module

I am opening this RFE on behalf of customer (THE PNC FINANCIAL SERVICES GROUP) to improve zUnit automation and generation process. Currently, zUnit does not provide an easy method for specifying the loadlib dataset (PDS) containing the test target load module (business module).

The JCL generation process can further be improved by setting the BZUEXTRA variable to loadlib dataset (PDS) name so the customer doesn't have to manually override the REPLAY.STEPLIB of BZUPLAY proc.


For new zUnit users, we should look for a way to simplify the process and avoid manual invention where possible. There is a workaround for when the business logic module is not on the same dataset as the test case modules. This can be done by overriding the STEPLIB of the REPLAY step, on the BZUPPLAY procedure:

- On the Property Group, zUnit tab, expand the REPLAY step and add this for the Additional JCL:

//REPLAY.STEPLIB DD
// DD
// DD
// DD
// DD
// DD
// DD
// DD
// DD
// DD DISP=SHR,DSN=MY.PDSELOAD

- The result will be that MY.PDSELOAD dataset is going to be inserted in the 10th position of the DD datasets on the STEPLIB concatenation, and all the other datasets will be preserved. For example the final JCL would look like:

101 XXREPLAY EXEC PGM=BZUPLAY,COND=(&MAXRC,LT),REGION=&RGN,
XX PARM='&PRM'
IEFC653I SUBSTITUTION JCL - PGM=BZUPLAY,COND=(4,LT),REGION=0M,PARM='TRACE=Y,STOP=E,REPORT=XML'
102 //REPLAY.STEPLIB DD
X/STEPLIB DD DISP=SHR,DSN=&BZU..SBZULOAD Test Runner common
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=SYS1.V10.PROD-AL6.SBZULOAD
103 // DD
X/ DD DISP=SHR,DSN=&BZU..SBZULMOD Test Runner replay
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=SYS1.V10.PROD-AL6.SBZULMOD
104 // DD
X/ DD DISP=(OLD,DELETE),DSN=&&LLEP custom replay *
105 // DD
X/ DD DISP=SHR,DSN=&BZU..SBZULLEP&LLEP Test Runner replay *
XX* DD DISP=SHR,DSN=&BZU..SBZULLEP Test Runner replay
XX* DD DISP=SHR,DSN=&BZU..SBZULINK Test Runner (APF)
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=SYS1.V10.PROD-AL6.SBZULLEP
106 // DD
X/ DD DISP=SHR,DSN=&CEE..SCEERUN LE
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=CEE.SCEERUN
107 // DD
X/ DD DISP=SHR,DSN=&CEE..SCEERUN2 LE
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=CEE.SCEERUN2
108 // DD
X/ DD DISP=SHR,DSN=&EQA..SEQAMOD Debugger
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=SYS1.V42.PROD-ADR.SEQAMOD
109 // DD
X/ DD DISP=SHR,DSN=&BZULOD caller provided
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=USER001.ZUNIT.COBOL.LOAD
110 // DD
X/ DD DISP=SHR,DSN=&BZUCBK caller provided
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=USER001.ZUNIT.COBOL.LOAD
111 // DD DISP=SHR,DSN=USER001.PDSELOAD
X/ DD DISP=SHR,DSN=&BZUEXTRA caller provided
IEFC653I SUBSTITUTION JCL - DISP=SHR,DSN=USER001.PDSELOAD
112 XXSYSPRINT DD SYSOUT=*
...

- This is covered on zOS docs here: https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.ceea200/clccatv.htm