How to add a program source listing to the PROTSYM symbolic repository using InterTest Batch ISPF utilities or batch utility IN25SYMD

Products

• InterTest - CICS
• InterTest - Batch

Issue/Introduction

The InterTest Batch PROTSYM symbolic repository(PROTSYM) file is a VSAM relative record data set (RRDS).
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 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 InterTest Batch ISPF utilities menu option or through the batch utility program IN25SYMD if the source listing was not added at compile time.

 

 

 

 

Resolution

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

In the first example the InterTest Batch utilities option is used to load the symbolic information into the PROTSYM file. 

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

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

    OPTION ===> U
                                                           
   1  Foreground - Test a Program in Foreground              Release - V11.0
   2  Core       - Display and Alter Virtual Storage         Userid  - xxxxx    
   3  Allocation - Allocations and JCL Conversion            Time    - hh.mm.ss
   4  Map        - Address Space Map                         Date(G) - mm/dd/yy
   5  Batch      - Batch Link Facility                       Date(J) - yy.jjj
   U  Utilities  - Symbolic Utilities and Preferences    
   X  EXIT       - Terminate the Session 

From the 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.
 

//*------------------------------------------------------------------*
//*   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.CAVHLOAD
//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 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=Endevor Listing file 
//REPORT   DD SYSOUT=*
//OPTIN    DD *
  LTYP=NDV,MSG=ALL,FROM=*
/*