Where does the EXAMSTRT CLIST get the names of the required datasets that are allocated

Products

• Auditor for z/OS

Issue/Introduction

The EXAMSTRT CLIST will dynamically allocate the required Examine datasets based on the last qualifier of LOAD library dataset name on the CALL statement in the CLIST.  Where does the EXAMSTRT CLIST obtain the names of the required datasets that are allocated?

 

Environment

Release: 12.0  12.1

Resolution

When EXAMSTRT receives control, it invokes a Auditor module that allocates the Auditor data sets. The  Auditor data set names are derived from the name of the last qualifier of LOAD library dataset name on the CALL statement, which is specified in the EXAMSTRT CLIST.
EXAMSTRT will allocate the following libraries:

    Examine           Examine         Examine                                                                        
NON-SMP Install    SMP INSTALL     SMP Install                              
12.0 AND 12.1          12.0            12.1                             
---------------   --------------  ---------------                       
PREFIX.CLIST      PREFIX.CAICLS0  PREFIX.CAJ0CLS0                       
PREFIX.DBASE1     PREFIX.CAIDBS1  PREFIX.CAIDBS1                        
PREFIX.DBASE2     PREFIX.CAIDBS2  PREFIX.CAJ0DATA                       
PREFIX.LOAD       PREFIX.CAILOAD  PREFIX.CAJ0LOAD                       
PREFIX.MESSAGES   PREFIX.CAIMSG0  PREFIX.CAJ0MSG0                       
PREFIX.PANELS     PREFIX.CAIPNL0  PREFIX.CAJ0PNL0                       
PREFIX.TABLES     PREFIX.CAITBL0  PREFIX.CAJ0TBL0 

where prefix can be more than one qualifier.

Note, Auditor will allocate the above datasets based on the last qualifier of the Auditor Load Library. For version 12.0 and 12.1, if the last qualifier of the Load Library is 'LOAD' the NON-SMP datasets as noted above will be allocated. For version 12.0, if the last qualifier is 'CAILOAD' then the SMP datasets as noted above will be allocated. For version 12.1, if the last qualifier is 'CAJ0LOAD' then the SMP datasets as noted above will be allocated.

The following are example CALL statements in the EXAMSTRT CLIST and the list of datasets that are dynamically allocated.

Example 1:

CALL 'SYS1.EXM12SP1.LOAD(LTD2STRT)'

Datasets Allocated:

SYS1.EXM12SP1.CLIST 
SYS1.EXM12SP1.DBASE1 
SYS1.EXM12SP1.DBASE2 
SYS1.EXM12SP1.LOAD 
SYS1.EXM12SP1.MESSAGES 
SYS1.EXM12SP1.PANELS 
SYS1.EXM12SP1.TABLES

Example 2:

CALL 'SYS1.EXM12SP0.CAILOAD(LTD2STRT)'

Datasets Allocated:

SYS1.EXM12SP0.CAICLS0 
SYS1.EXM12SP0.CAIDBS1 
SYS1.EXM12SP0.CAIDBS2 
SYS1.EXM12SP0.CAILOAD 
SYS1.EXM12SP0.CAIMSG0 
SYS1.EXM12SP0.CAIPNL0 
SYS1.EXM12SP0.CAITBL0

Example 3:

CALL 'SYS1.EXAMV120.SP0.CAJ0LOAD(LTD2STRT)' 

Datasets Allocated:

SYS1.EXAMV120.SP0.CAJ0CLS0 
SYS1.EXAMV120.SP0.CAIDBS1 
SYS1.EXAMV120.SP0.CAJ0DATA 
SYS1.EXAMV120.SP0.CAJ0LOAD 
SYS1.EXAMV120.SP0.CAJ0MSG0 
SYS1.EXAMV120.SP0.CAJ0PNL0 
SYS1.EXAMV120.SP0.CAJ0TBL0

Details on the EXAMSTRT CLIST can be found in the section entitled  Verify Your Installation  in the Auditor documentation.