Interfaces and Compatibility

This article describes considerations for using your CA InterTest and CA SymDump products with other products and interfaces. This article contains the considerations for all products.
caitsd-11-0
This article describes considerations for using your CA InterTest and CA SymDump products with other products and interfaces. This article contains the considerations for all products.
2
Configure Dynamic Symbolic Support
The dynamic symbolic support feature improves your productivity by reducing the pre-testing setup time commonly involved in locating and loading a program's compiler or assembler listing. This feature automatically locates the listing and loads the symbolic file. This feature is fully integrated with CA Endevor SCM.
You can implement the dynamic symbolic support feature if the CA Endevor SCM footprint (FOOTPRNT) feature is used when applications programs are generated in CA Endevor SCM.
Configure the Started Task Procedure for CA Endevor support
This configuration procedure is required in the following situations:
  • If you want to use Dynamic Symbolic Support for CA InterTest CICS or SymDump CICS.
  • If you are not using any of the CICS products and you use multiple CA Endevor SCM C1DEFLTS which are not in your STEPLIB(s). For more information, see Batch Link Facility or Symbolic Utilities.
Follow these steps:
  1. Install CAICCI as discussed in the section CA Common Services for z/OS and Requirements.
  2. Copy the CAVHSAMP member INDVSPWN to the CA ENF parameter library and add the spawn parameter to the CA ENF spawn parameter list.
  3. Use the CAVHPROC member INTNDVR, the started task procedure, to access CA Endevor SCM to dynamically load program symbolic information.
  4. Modify this procedure to conform to your installation standards.
  5. Copy it to a system procedure library as member INTNDVRn. The member name of the procedure should have the CA Endevor SCM C1DEFLTS table site ID appended to it. For example, if the site ID is 3, the procedure member name should be INTNDVR3.
  6. Repeat step 5 for each unique site ID.
  • This started task must be an APF-authorized task.
  • The INTNDVRn procedures require read security access to any load library data sets in which application programs that were created by CA Endevor SCM reside. They also require write security access to any PROTSYM files they will populate.
  • CA ENF will need to be refreshed to activate the new spawn parameters added for this feature.
Shut Down CA Endevor SCM Dynamic Symbolic Support Started Task
The CA SymDump for CICS Dynamic Symbolic Support started task is simply canceled with the CANCEL operator command when shutdown is required.
Configure Dynamic Symbolic Support for CA InterTest Batch
If you changed the procedure name from the default INTNDVR, you must also change and reapply USERMOD for the IN25SITE table. Edit CAVHJCL member IN25SITE.
Following is a sample IN25SITE program:
****************************************************************** * THIS TABLE IS USED TO SUPPORT CUSTOMER'S ENVIRONMENT * * WHERE MULTIPLE C1DEFLTS ARE USED. * * * * THE TABLE CONTAINS AN ENDEVOR SITE ID AND THE ASSOCIATED * * PROCNAME TO START LISTING SERVER AS A STARTED TASK TO * * RETRIEVE LISTINGS STORED UNDER ENDEVOR CONTROL. * * * * THIS TABLE MUST BE MODIFIED VIA SMP/E USRMOD IF THE * * CUSTOMER HAS MORE THAN ONE C1DEFLTS. A SINGLE C1DEFLTS * * SITE, DOES NOT NEED TO MODIFY THIS TABLE. * * * * THIS MODULE MUST BE ASSEMBLED AND LINKAGE EDITED INTO * * CA INTERTEST BATCH LOAD MODULE LIBRARY. * * * * MACRO @NDVRSTE IS USED TO GENERATE THIS TABLE. * * * * MACRO FORMAT: * * @NDVRSTE PROC= * * PROC = A MAXIMUM OF 7 CHARACTER PROC NAME. * * PROC = BLANKS FOR SINGLE C1DEFLTS SITE. * * * * NOTE: CA INTERTEST WILL APPEND THE SITE ID OBTAINED FROM * * ENDEVOR FOOTPRINT AS THE 8TH CHARACTER. THUS THE * * PROCNAME IN YOUR PROCLIB IS EIGHT CHARACTERS. * ******************************************************************* IN25SITE CSECT , IN25SITE AMODE 31 IN25SITE RMODE ANY * @NDVRSTE PROC= * @NDVRSTE PROC=INTNDVR * END ,
The table is generated using macro @NDVRSTE. The macro has one parameter PROC, which is explained as follows:
A maximum seven-character name of a cataloged procedure used to start the listing server started task (STC). The eighth character is reserved as a suffix to be appended by the product based on your site ID. The name defined in the PROC keyword parameter must match the procedure name described above.
The JCL is included in the configuration PTF that assembles and links this program. The JCL member is IN25SITE and it is found in the CAVHJCL data set. The JCL must be modified JCL to conform to their installation standards before submitting it.
Configure Dynamic Symbolic Support for CA SymDump Batch
The first seven-character prefix of the procedure member name you copied to the system procedure library must match the value defined in the NDVRPROC option in CAOUDFRX.
Configure Dynamic Symbolic Support for CA InterTest and SymDump for CICS
  • The seven-character prefix for this procedure name is specified and can be changed by editing the NDVRPROC parameter in the IN25OPTS macro.
  • Include an NDVRSYM ddname in the IN25OPTS SYMFIL= parameter to indicate the PROTSYM file to be used for dynamic symbolic loading. The presence of an NDVRSYM PROTSYM ddname in the CICS startup JCL indicates to CA InterTest and SymDump for CICS to invoke the dynamic symbolic load option.
    SYMFIL=(PROTSYM,xxxxxxx,xxxxxxx,NDVRSYM)
  • If you use multiple CA Endevor SCM C1DEFLTS in your environment.