Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Convert Program Compiler Listing screen


Accessed from the Source Mismatch screen, the Convert Program Compiler Listing screen allows you to convert a compiler listing to a BMC source listing. The listing can reside on a sequential data set or it can be a member of a PDS. The conversion is done by executing the appropriate Common Shared Services post-compile language processor while your user session waits. After the conversion has successfully completed, the original command you entered is automatically executed again.

Convert Program Compiler Listing Screen

Abend-AID Convert Program Compiler Listing ----------------------
COMMAND ===>

Program Information
 Program Name......... CCAADEMO
 Compile Date......... 01AUG2019 Program Language......... COB/Z
 Compile Time......... 12:24:03 Language Release......... V6R1

The conversion to a BMC source listing will be done before proceeding.

Select one of the following options:
 Search known compiler listing data sets, select SEARCH
 Display a list of known compiler listing data sets, select DISPLAY

Or enter the name of the data set that contains the compiler listing:
 Data Set Name:
 Member name: CCAADEMO

Use the cursor point-and-shoot feature and press Enter at one of the following fields:

  • SEARCH field to display a list of partitioned data sets known to the server that contains the compiler listing member.
  • DISPLAY field to display a list of compiler-listing data sets known to the server.

Alternatively, you can enter the data set name of a sequential file or PDS that contains the source listing. After you enter the data set name, the Abend-AID Viewer invokes the appropriate CSS Language Processor postprocessor to analyze the listing and save the analyzed results to the Scratchpad listing file.

Matching Listing Data Set Names Screen

Abend-AID --- Matching Listing Data Set Names ---------------------
COMMAND ===>   SCROLL ===> PAGE

Program Information
 Program Name......... CCAADEMO
 Compile Date......... 01AUG2019 Program Language......... COB/Z
 Compile Time......... 12:24:03 Language Release......... V6R1

The data sets listed below have matching compiler listings for this program.
Type an S next to the desired data set and press the Enter key.

  Compiler Listing Data Set Name  Where Specified
  ********************************************   ********************
****************************** BOTTOM OF DATA *********************************

Known Compiler Listings

Abend-AID ---- Known Compiler Listings ------- Row 000001 of 000009
COMMAND ===>   SCROLL ===> PAGE
  ==>
Program Information
 Program Name......... CCAADEMO
 Compile Date......... 01AUG2019Program Language......... COB z/OS
 Compile Time......... 12:24:03 Language Release......... V6R1

Select the compiler listing data set name below that contains the listing for
this program.
Type an S next to the desired dataset and press the Enter key.

Compiler Listing Data Set Name  Where Specified   Status
******************************************** ******************** ********
CFUSER1.LISTING1  Viewing Server JCL
CFUSER3.LISTING1  Viewing Server JCL
CFUSER3.LISTING2  Viewing Server JCL
CFUSER2.LISTING1  Viewing Server JCL
CFUSER4.LISTING1  Viewing Server JCL
CFUSER2.LISTING2  Viewing Server JCL
 ****************************** BOTTOM OF DATA *********************************

If you use the cursor point-and-shoot feature and press Enter at the CONVERT field on either the Source Mismatch Selection screen or the No Source Selected screen and the listing file has been processed, the original program search is reissued and the Abend-AID Viewer will find the just processed listing. If the new entry is an exact match, it is used automatically, and no further user action is necessary. If it is not an exact match, the Source Mismatch screen is redisplayed. The new contents includes the just processed listing, which you can select. On a subsequent request for the same program, the analyzed listing from the Scratchpad listing file is included in the automatic search for the source. When you use the cursor point-and-shoot and press Enter at the CONVERT field, the Abend-AID Viewer remembers that selection and provides a meaningful message if the converted listing is not subsequently selected by source processing and the no source or source mismatch screen is redisplayed.

After a listing has been processed and placed on the Scratchpad file, it remains there until deleted or overwritten. Security checks depend on the EXTERNAL_SECURITY_DATASET_CHECK setting in the viewing server.

Note

For more information about the Scratchpad listing file, refer to the Abend-AID Advanced Configuration Guide .

The MFDDLIST DD statement (which your site installer optionally included in the viewing server JCL at installation) contains a reference to PDS data sets that you can select as a source for unprocessed IBM compiler listings.

If you use the cursor point-and-shoot and press Enter at the DISPLAY field on the convert_program, the Matching Listing Data Set Names screen will include the MFDDLIST data sets in the data set list. If you use the cursor point-and-shoot and press Enter at the SEARCH field on the convert_program, the MFDDLIST data sets will be searched, as well as your previously specified data sets.

As you enter compiler listing data set names to be processed and used, the data set names are saved in a small (five entries) FIFO table in your user profile. As new entries are added to the table, older entries are pushed down, and if the table is full, the oldest entry is discarded. This table is included on the Matching Listing Data Set Names and Known Compiler Listing screens that you can access from the convert_program. If you use the cursor point-and-shoot and press Enter at the SEARCH field, these data sets will be included in the list to be searched for the listing member name. If you use the cursor point-and-shoot and press Enter at the DISPLAY field, the list of searchable data sets (including these) will be shown.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*