Executing the Cross Reference Processor

Cross Reference Processor › Executing the Cross Reference Processor

Executing the Cross Reference Processor

Job Control Language (JCL) for executing the Cross Reference Processor under z/OS and z/VSE is shown below. Under both z/OS and z/VSE, processing options must be specified with the parameter statement.

Note: (z/OS users only)-The PARM clause of the EXEC statement cannot be used to specify options when executing this component.

z/OS JCL-PRANXREF

//PRANXREF EXEC PGM=PRANXREF,REGION=1024K
//STEPLIB  DD  DSN=idms.dba.loadlib,DISP=SHR
//         DD  DSN=idms.custom.loadlib,DISP=SHR
//         DD  DSN=idms.cagjload,DISP=SHR
//SYSLST   DD  SYSOUT=A
//SYSUDUMP DD  SYSOUT=A
//SORTMSG  DD  SYSOUT=A
//SORTLIB  DD  DSN=SYS1,SORTLIB,DISP=SHR
//SORTWK01 DD  UNIT=disk,SPACE=(cyl,(5,5))
//SORTWK02 DD  UNIT=disk,SPACE=(cyl,(5,5))
//SORTWK03 DD  UNIT=disk,SPACE=(cyl,(5,5))   Include only if using
//PRANLIB  DD  DSN=reflib,DISP=SHR  ◄    LIBRARY option.
//PRANREF  DD  DSN=sysref1,DISP=SHR
//         DD  DSN=sysref2,DISP=SHR              Include only
                  .                         ◄ if using DISK option
                  .
                  .
//         DD  DSN=sysrefn,DISP=SHR
//dcmsg    DD  DSN=idms.sysmsg.ddldcmsg,DISP=SHR
//sysjrnl  DD  *
//SYSOUT   DD  SYSOUT=a
//SYSIDMS  DD  *
dmcl=dmcl-name
Insert other SYSIDMS parameters as appropriate
//SYSIPT   DD  *
Insert optional control statements here

DSN	Description
idms.dba.loadlib	Data set name of the load library containing the DMCL and database name table load modules
idms.custom.loadlib	Data set name of the load library containing customized CA IDMS system software modules
idms.cagjload	Data set name of the load library containing CA IDMS system software modules that do not require customization
cyl,(5,5)	file space allocation of work file
disk	symbolic device name of disk file
reflib	data set name of partitioned data set containing data usage files
sysref1, sysref2, sysrefn	data set names of sequential data sets containing data usage files
dcmsg	DDname of the system message (DDLDCMSG) area
idms.sysmsg.ddldcmsg	Data set name of the system message (DDLDCMSG) area
SYSIDMS	DDname of the CA-IDMS parameter file specifying runtime directives and operating system-dependent parameters. For a complete description of the SYSIDMS parameter file, see the CA IDMS Common Facilities Guide.

z/VSE JCL-PRANXREF

// DLBL    SSln,'user.srclib'
// EXTENT  ,nnnnnn
// LIBDEF  SL,TO=SSln,TEMP
// DLBL    PRANREF,'sysref',,SD   ◄   Include only if using DISK option
// EXTENT  SYS010,nnnnnn
// ASSGN   SYS010,DISK,VOL=nnnnnn,SHR
// DLBL    SORTWK1,'WORK1',O,SD
// EXTENT  SYS001,nnnnnn,1,,ssss,200
// ASSGN   SYS001,DISK,VOL=nnnnnn,SHR
// EXEC    PRANXREF,SIZE=128K
optional control statements
/*

DSN	Description
nnnnnn	serial number of disk volume
ssss	starting track (CKD) or block (FBA) of disk extent
sysref	file-id for sequential file containing data usage file
SYS001	logical unit assignment for sort work file
SYS010	logical unit assignment for data usage file (SYS010 required)
user.srclib	source statement library containing data usage files
SSln	filename of source statement library