CAVHPROT

Member CAVHPROT in CAI.CAVHJCL contains sample JCL for defining and initializing a PROTSYM file.

Note: If you are installing one of the CA Testing and Fault Management products, be sure to follow the instructions for creating the PROTSYM file in the Installation Guide for the product you are installing. Some products may provide custom JCL members that have been tailored for use with the product.

CAVHPROT contains the following two steps:

Step 1 (DEFSYM)—Invokes IDCAMS to define the PROTSYM file.
Step 2 (LOAD)—Invokes IN25UTIL to initialize each of the PROTSYM records.

The following JCL for member CAVHPROT shows these two steps:

//CAVHPROT JOB
//DEFSYM   EXEC PGM=IDCAMS,REGION=1024K                          
//SYSPRINT DD SYSOUT=*                                           
//SYSIN    DD *                                                  
   DELETE $PROTSYM$ CLUSTER PURGE                                
   SET MAXCC=0                                                   
   DEFINE CLUSTER (NAME($PROTSYM$)			-  
                   REC($RECS$)					-  
                   CISZ(2048)            /* DO NOT CHANGE */		-  
                   VOLUME($SYMVOL$)				-  
                   RECSZ(2040 2040)				-  
                   SHR(4 4)					-  
                   NUMBERED)					-  
          DATA (NAME($PROTSYM$.DATA))                            
/*                                                               
//LOAD     EXEC PGM=IN25UTIL,REGION=2048K                        
//STEPLIB  DD DSN=$LOADLIB$,DISP=SHR                             
//MESSAGE  DD SYSOUT=*                                           
//PROTSYM  DD DSN=$PROTSYM$,DISP=SHR                             
//CARDS    DD *                                                  
PASSWORD=$PASSWORD$                                               
INITIALIZE   
REPORT       
/*           
//

Make the following substitutions in member CAVHPROT:

Symbol	Description
$PROTSYM$	Is the fully-qualified name of your new PROTSYM library.
$SYMVOL$	The volume on which the PROTSYM resides.
$RECS$	Is the primary space allocation in records. (See Notes 1 and 2.)
$LOADLIB$	Is the one- to eight-character PROTSYM update password for your installation, from IN25SOPT. (See Note 3.)

Submit the JCL to allocate and initialize a new PROTSYM file.

Notes:

Do not allocate any secondary space.
The space required depends on many factors including the size of your programs, the number of variables and labels, the average length of their names, and the LISTER options used for loading symbolic information. We recommend an initial allocation of 10,000 records. You can allocate new PROTSYM files as needed, and expand and reorganize existing files.
If you have not altered the installation default, specify PASSWORD=12345678

Tell Technical Publications how we can improve this information