Import Programs from PROTSYM Files

After creating an InterTest project and before debugging a program listing, you must import the program listing from the PROTSYM file. You can import program listings for programs executed in z/OS batch jobs into a batch project. For CICS projects, you may import program listings for programs executed in a CICS region. Use the Import PROTSYM Files dialog opens for importing program listings for both batch and CICS projects.

During the debug session, all listings will be synchronized to the same listing as is being used by the mainframe debugger. This synchronization takes place when a program is first monitored in CICS session and at entry for a batch program. If there is a possible choice, a dialog to select a listing opens at synchronization time. If CA Endevor SCM manages the listing, it will be loaded into the designated PROTSYM file at this time.

Note: Add Item can be used to add programs to a project and the listings will be imported during the debug session. This feature is useful when you do not know the actual PROTSYM file that contains the listing or when using support for CA Endevor SCM. You can add breakpoints after the listing is loaded.

To import programs from PROTSYM files

1. Select a batch or CICS project in the InterTest Debug view.
2. Select InterTest, Import PROTSYM Files.

   The Import PROTSYM Files dialog opens.

3. Enter the details in the following fields for importing programs:
   • [Required] CA TestingTools Server

     Displays the list of CA InterTest servers available to import programs.

   • [Required] PROTSYM Data set

     Displays the list of most recently used (MRU) PROTSYM data sets. Enter the PROTSYM data set name.

     Note: If you are using this dialog for the first time the list will be empty.

4. Click List Members to display all available programs to download.

   Note: You will be prompted for a user ID and password, if you have not entered your logon details earlier.

   The table lists the PROTSYM members ready to be imported.

5. Do one of the following to select which programs to import:
   • Check the boxes corresponding to the required programs.
   • Click Select All to select all available programs to download.
   • Click Deselect All to clear all selected programs and start a new selection or clear the boxes to avoid importing individual members.

     Note: If you have a large list of members, drag the edge of the dialog to make the visible part of the list larger. This resizing is persistent. If you click any program name in the list and type the first several characters of the program you want to search, the view will reposition the list at the first program with the same characters. Wait for one or two seconds before you repeat the search for a new set of characters.

6. Enter the details in the following fields to continue an import action:
   • Into Folder

     Specifies the destination project folder into which the imported programs are stored. Click Browse to select the project into which you want to import programs. The Import into Folder dialog opens. Locate and select the project folder into which you want to store the programs. Click OK to exit the dialog.

     Note: This field is automatically populated if you selected any project in the InterTest Debug view before importing programs.

   • Override file with same timestamp

     Restricts importing programs that have timestamps. Check this box to ignore programs with timestamps.

     Default: Off

   • Set new imported programs to monitor

     Enables monitoring new programs. Check this box if you want the imported programs to be monitored.

     Default: Off

     Note: You can move a program between monitored and unmonitored after a file import task is completed.

7. Click Finish.

   The InterTest Debug view refreshes to display the imported programs available for use.