How do I add a program source listing to the PROTSYM symbolic repository using the CA InterTest Batch ISPF utilities menu option or through the batch utility program IN25SYMD?

Document ID : KB000025667
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction: 

The CA InterTest Batch PROTSYM symbolic repository(PROTSYM) file is a VSAM relative record data set (RRDS).
CA InterTest Batch supports programming languages COBOL, Assembler and PL/I. The PROTSYM file contains the application program listings used by application programmers to set breakpoint options.
Most users add a CA InterTest Batch post processing step to their compile procedure so the program source listing is available when debugging is necessary. 

For example the assembler post processing program is called IN25SYMA. The post processing program IN25SYMA processes the assembler output and loads the information to the PROTSYM file.
You can also add the program source listing to the PROTSYM file using the CA InterTest Batch ISPF utilities menu option or through the batch utility program IN25SYMD if the source listing was not added at compile time.

 

Instructions:

The two examples outlined below assume that you have the symbolic information - program source listing stored in a sequential file, PDS, CA Endevor, CA Librarian or CA Panvalet.

In the first example the CA InterTest Batch utilities option is used to load the symbolic information into the
PROTSYM file. This topic is outlined in the CA Intertest Batch User Guide Chapter Utilities.

Start CA Intertest Batch and from PRIMARY OPTION PANEL select option U and press ENTER.

 ---------------- CA InterTest Batch PRIMARY OPTION MENU -----------------------

    OPTION ===> U
                                                                                 Release  - r9.1
   1  Foreground - Test a Program in Foreground            Genlevel - SP00
   2  Core       - Display and Alter Virtual Storage            Userid   - XXXXXX
   3  Allocation - Allocations and JCL Conversion              Time     - 10:05:41
   4  Map        - Address Space Map                              Date(G)  - 02/03/16
   5  Batch      - Batch Link Facility                               Date(J)  - 16.034
   U  Utilities  - Symbolic Utilities and Preferences    
   X  EXIT       - Terminate the Session 

From the CA InterTest Batch Utilities Menu select option 2 and press ENTER.

 ---------------------- CA-InterTest Batch UTILITIES MENU ----------------------

 OPTION ===> 2

   Symbolic Utilities:

    1  DISPLAY    - List/Display PROTSYM File Contents

    2  ADD        - Add a Program Listing to a PROTSYM File

    Preferences:

    3  EXCLUDE    - Exclude Programs From "Auto-Monitoring"

    X  EXIT       - Return to Primary Option Menu

     PFkeys: HELP - Tutorial
                 END  - Exit

 

Fill in the appropriate keywords and press ENTER. The program source listing will then be added to the PROTSYM file.

If multiple program source listings are stored in a PDS you can add multiple programs to the PROTSYM file by using the FROM MEMBER and TO MEMBER keywords. Sequential files do not support the loading of multiple programs. 

 ---------------- CA-InterTest Batch PROTSYM Add Program Listings --------------
COMMAND ===>
------------------------------------------------------------------------------- 

 Use this panel to add program listings to a symbolic file using the listing post-processor.

 PROTSYM Dsname    ===> 'HLQ.PROTSYM'

  Listing Dsname    ===> 'HLQ.PROGRAM.SOURCE.LISTING'
   Library Type       ===> SEQ   (PDS, SEQ, LIB, PAN, or NDV)

  From Member       ===> PGM-NAME
  To Member           ===> PGM-NAME

 View Messages     ===> ALL   (ALL, NONE, RC)

 Press ENTER to add program listings to the PROTSYM file or END  to cancel this operation.
______________________________________________________________________________________

 

In the second example, the batch IN25SYMD utility program is used to load the program source listing into the PROTSYM file.
This topic is outlined in the CA Application Quality and Testing Tools Symbolic Guide Chapter 3 Adding Symbolic Information. 

//*------------------------------------------------------------------*
//*   IN25SYMD --- POST-PROCESSOR DRIVER
//*   SPECIFYING OPTIONS
//*   ------------------
//*   USE THE OPTIN DD TO PASS CONTROL OPTIONS TO IN25SYMD
//*   IN THE FORMAT:
//*          KEYWORD=VALUE
//*   SEPARATE EACH KEYWORD FROM ITS VALUE USING A SINGLE EQUAL
//*   SIGN "=" (NO SPACES) AS SHOWN ABOVE.
//*
//*   SEPARATE OPTIONS USING SPACES, COMMAS, OR END-OF-LINE.
//*   THE FOLLOWING OPTIONS ARE SUPPORTED:
//*
//*   OPTION  DESCRIPTION
//*   ------  ---------------------------------------------------
//*   LTYP=   IDENTIFIES THE LIBRARY TYPE.
//*              SUPPORTED VALUES: SEQ, PDS, PAN, LIB, NDV
//*   FROM=  IDENTIFIES THE MEMBER NAME (FOR SINGLE LISTINGS),
//*              STARTING MEMBER NAME (FOR A RANGE OF MEMBERS),
//*              OR PREFIX (WITH TRAILING ASTERISK).
//*   TO=     IDENTIFIES THE END OF A RANGE OF MEMBERS.
//*   MSG=   IDENTIFIES THE MESSAGE REPORTING LEVEL.
//*             SUPPORTED VALUES: ALL, NONE, RC.
//*------------------------------------------------------------------*
//STEP001  EXEC PGM=IN25SYMD,REGION=4M
//STEPLIB  DD DISP=SHR,DSN=HLQ.CAILIB
//PROTSYM  DD DISP=SHR,DSN=HLQ.PROTSYM
//LISTLIB  DD DISP=SHR,DSN=HLQ.PROGRAM.SOURCE.LISTING
//REPORT   DD SYSOUT=*
//MESSAGE  DD SYSOUT=*
//OPTIN    DD *
  LTYP=SEQ,MSG=ALL,FROM=PGM-NAME
/*

NOTE: To add a program source listing stored in CA Endevor you must execute program NDVRC1 with a PARM of IN25SYMD. See the example below.

//STEP001  EXEC PGM=NDVRC1,PARM=IN25SYMD,REGION=4M  <<<< Must execute NDVRC1 with PARM card.
//STEPLIB  DD DISP=SHR,DSN=HLQ.CAILIB
//PROTSYM  DD DISP=SHR,DSN=HLQ.PROTSYM
//LISTLIB  DD DISP=SHR,DSN=CA-Endevor Listing file
//REPORT   DD SYSOUT=*
//OPTIN    DD *
  LTYP=NDV,MSG=ALL,FROM=*
/*

 

Additional Information: 

Reference the following documentation for details on using any of the methods listed above:  

          CA InterTest Batch User Guide - Chapter 9 Add a Program to the PROTSYM File section.
          CA Application Quality and Testing Tools Symbolic Guide  - Chapter 3 Adding Symbolic Information.