Dynamic Symbolic Support for CA Endevor Software Change Manager › Define Unique PROC

Define Unique PROC

Define a unique PROC in your PROCLIB for each CA Endevor SCM site ID in your environment.

Each copy of the PROC must have the following PROCNAME:

xxxxxxxy

• xxxxxxx is the first seven characters of the PROCNAME defined in the testing tools product.
• y, the eighth character, is your CA Endevor SCM site ID.

For example, if the first seven characters of the PROCNAME are INTNDVR and the CA Endevor SCM site ID is 4, the PROCNAME defined in your PROCLIB is INTNDVR4.

Note: The first seven character names defined in your PROCLIB must match the PROCNAME defined to the CA Technologies testing tools product.

PROCNAME is defined in the following elements by product:

• CA InterTest Batch is defined in IN25SITE
• CA SymDump Batch is defined in CAOUXFDR
• CA InterTest for CICS is defined in IN25OPTS
• CA SymDump for CICS is defined in IN25OPTS
• CA Mainframe Application Tuner is defined in the TUNUDEFS member of the option library

PROC Customization

The sample PROC can be found in hlq.CAVHPROC. When modifying the PROC, consider the following recommendations:

• Specify MSGLEVEL= (1,1) on the JOB statement so that a more comprehensive view of the events leading up to a problem can be obtained. Set MSGCLASS to a class that does not get purged immediately after job termination. A sample JOB statement is shown next:

  //INTNDVR4 JOB (JOBACNT),MSGLEVEL=(1,1),MSGCLASS=X
  

• Remove the STEPLIB DD statement containing the yourhlq.cavhload data set name if the data sets that contain the symbolic common components are defined in the LINKLIST. A sample STEPLIB DD statement is shown next:

  //STEPLIB DD DSN=yourHLQ.cavhload,DISP=SHR                <== MODIFY
  

  Note: The load module data sets containing symbolic common components must be APF-authorized.

• The MODLRESP DD statement specifies the model space allocation (for CA Endevor for SCM response files) to override the default of (TRK, (5,5)). Depending on your requirement, you can override this limit to avoid SB37s. A sample MODLRESP DD statement is shown next:

  //MODLRESP DD DUMMY,SPACE=(CYL,(1,1))    MODEL FOR RESPONSE DATASET 
  

• The MODLLIST DD statement specifies the model space allocation (for CA Endevor for SCM listing files) to override the default of (TRK, (5,5). Depending on your requirement, you can override this limit to avoid SB37s. A sample MODLLIST DD statement is shown next:

  //MODLLIST DD DUMMY,SPACE=(CYL,(5,5))    MODEL FOR LISTING DATASET    
  

• The SRVPRINT DD statement is used to log CA CCI activities. The presence of SRVPRINT triggers logging information across all dynamic symbolic support components, including CA Endevor for SCM activities, system assigned DDnames and space allocated for all the work files. A sample SRVPRINT DD statement is shown next:

  //SRVPRINT DD SYSOUT=*    <== COMMENT OUT TO TURN OFF LOGGING
  

  Note: We strongly recommend that you do not comment out this DD statement because the information is critical for CA Technical Support to help you resolve any problems you encounter.

• The DSSLOG DD statement is used to log dynamic symbolic support-related diagnostic messages including Binder errors and CA CCI feedback messages. A sample DSSLOG DD statement is shown next:

  //DSSLOG   DD SYSOUT=*    <== COMMENT OUT TO TURN OFF DSS LOGGING
  

  Note: We strongly recommend that you do not comment out this DD statement because the information is critical for CA Technical Support to help you resolve any problems you encounter.

• The JOBLOG DD statement is used to trigger message extraction when any subtask encounters critical errors or abends. The extracted messages, including PSW and the registers when the abend occurred, are reported back to the remote host. A sample JOBLOG DD statement is shown next:

  //JOBLOG   DD SYSOUT=*    <== REQUIRED FOR REPORTING REMOTE FAILURES
  

  Note: We strongly recommend that you do not comment out this DD statement because the information is critical for CA Technical Support to help you resolve any problems you encounter.

If the data sets containing the CA Endevor SCM C1DEFLTS, CA Endevor SCM CSIQLOAD (CONLIB), and CSIQAUTH (AUTHLIB) data sets are not defined in the LINKLIST, also define these data sets in the STEPLIB DD statement concatenation.

Note: CONLIB must be defined with a DDName of CONLIB. not part of the STEPLIB concatenation.