Source Selection List

The Source Listing Facility › Source Selection List

Source Selection List

To display the Source menu

Select Option 6 Source from the CA SymDump for CICS Primary Option menu. The Source menu appears.

‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ CA SymDump for CICS V9.0 SOURCE MENU ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ OPTION ===> Select a member list type, specifying optional criteria below. 1 Source listings ‑ Display/select program source listings 2 Symbolic files ‑ Display/select program source SYMBOLIC files Type specific or generic program/file name(s): (Valid mask characters are * and/or +) c*______ ________ ________ ________ ________ ________ ________ ________ PF1 Help 2 3 End 4 Return 5 6 PF7 8 9 10 11 12

From this menu you can display either a:

Listing or a list of listings by typing 1 on the Option line.
Symbolic file or a list of Symbolic files by typing 2 on the Option line. You can then select a Symbolic file to display the Program Listings for that file.

Specify either the listing name or the Symbolic File name in the unlabeled text fields to enter additional criteria. You can use masks to filter the selection list for items matching the filter criteria:
- Use * in place of a string of any length. For example, c* filters for all listings beginning with the letter c.
- Use + for a single character. For example, a mask of COBD++O filters for any seven-letter item that begins with the letters COBD, has an O in the last position, and has any valid character in the fifth and sixth positions. For instance, COBDEMO, COBDXXO, and COBDABO all meet the mask criteria, but COBDEML or COBDEM do not.
- Leave the fields blank to display all symbolic files or listings.

Press Enter after you specify a listing, file, or mask. The Source Listing Selection menu appears.

The Source Listing Selection menu shows all of the files or listings that meet the criteria you specified on the Source menu. The following is a sample Source Listing Selection menu screen.

‑‑‑‑‑‑‑‑‑‑‑‑‑‑ CA SymDump for CICS V9.0 SOURCE LISTING SELECTION ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ COMMAND ===> Name File Created Size Attributes _ CICSCOBA PRTSYM1 09/20/94 16:38 29 COBOL II, no purge _ CICSCOBB PRTSYM1 09/20/94 16:13 21 COBOL II, no purge _ COBDEML PROTSYM 07/07/94 09:32 17 COBOL, no purge, composite _ COBDEMO PROTSYM 07/07/94 09:25 70 COBOL, no purge _ COB2DEML PROTSYM 07/07/94 09:33 25 COBOL II, no purge, composite _ COB2DEMO PROTSYM 07/21/94 10:34 158 COBOL II, no purge _ COB2DMLX PRTSYM1 09/21/94 16:10 26 COBOL II, no purge, composite _ COB2INSP PRTSYM1 02/01/94 09:11 155 COBOL II, no purge _ COB2IN25 PROTSYM 07/07/94 09:31 11 COBOL II, no purge _ COB2XCTL PRTSYM1 09/22/94 13:38 159 COBOL II, no purge _ CSBIN25 PROTSYM 07/07/94 09:29 8 COBOL, no purge _ C370DEML PROTSYM 07/07/94 09:33 27 COBOL/370, no purge, composite _ C370DEMO PROTDGG 12/12/94 12:51 161 COBOL/370, no purge _ C370DEMO PROTWSD 12/12/94 12:51 161 COBOL/370, no purge _ C370DEMO PROTSYM 07/21/94 16:35 161 COBOL/370, no purge _ C370IN25 PROTSYM 07/07/94 09:32 12 COBOL/370, no purge *** End of data *** PF1 Help 2 Refresh 3 End 4 Return 5 6 PF7 Backward 8 Forward 9 10 11 12

Type an S next to the file or listing you want and press Enter to display that file or listing in the Source Listing Display.

The following is a sample Source Listing Display screen containing a COBOL source listing.

CA InterTest ‑ PROTDEM FILE SOURCE LISTING DISPLAY 1 COMMAND ==> Program= COBDEMO Option # Stmt # Margin= 01 Nested= Search= 2 OPTS 1 Proc div 2 Work-stor 3 Link sect 4 D-map 5 Clst/Pmap More: + 6 Data xref 7 Proc xref 8 Err msgs 9 Srch fwd 10 Srch bwd 3 PFKS 1 Help 2 3 End 4 Profile 5 6 Menu 7 Backward 8 Forward 9 10 11 12 ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ _ 00001 ID DIVISION. _ 00002 PROGRAM‑ID. COBDEMO. _ 00003 ENVIRONMENT DIVISION. 4 00004 DATA DIVISION. _ 00005 WORKING‑STORAGE SECTION. _ 00006 77 S999‑FIELD1 PIC S9(3). 5 _ 00007 77 S999‑FIELD2 PIC S9(3) VALUE +50. _ 00008 77 999‑FIELD1 PIC 9(3). _ 00009 77 999‑FIELD2 PIC 9(3) VALUE 50. _ 00010 77 FIRST‑SCREEN‑LEN PIC S9(4) COMP VALUE +1696. _ 00011 77 MSG‑SCREEN‑LEN PIC S9(4) COMP VALUE +1040. _ 00012 77 THIRD‑SCREEN‑LEN PIC S9(4) COMP VALUE +960. _ 00013 77 FOURTH‑SCREEN‑LEN PIC S9(4) COMP VALUE +1761. _ 00014 77 ERROR‑SCREEN‑LEN PIC S9(4) COMP VALUE +960. 00015*77 COMMAREA‑LEN PIC S9(4) COMP VALUE +39.

The Source Listing Display screen is divided into five major sections. The sections and the fields they contain are explained next:

1—This section contains fields in which you can enter commands and information. The following list describes each field in this section.

COMMAND ===>

Enter a transaction, transaction‑based command, or a Source Listing Display command.

Program=

Changes the program whose code is displayed.

Option #

Enter an option listed on OPTS lines by number.

Stmt #

Displays a specific statement.

Nested=

Indicates the displayed COBOL nested program or the program to be searched. This field is empty if the program does not contain any nested programs.

Margin=

Adjusts the display margins to view code past column 80.

Search=

Searches for a data name or string.
2—The OPTS section lists entries for the Option # field. The numbers in the following table are used in the Option # field to display specific sections of the source listing or to search for data. Using these options makes it easy to locate specific sections of your program.
For COBOL and PL/I programs, all of the OPTS labels cannot display at once.
1. Tab to More + and
2. Press Enter to view OPTS 5 to the end.
3. Tab to More ‑ and
4. Press Enter to view OPTS 1 to 10.

Option	COBOL	PL/I	Assembler
1	* Procedure Division	Data Cross Reference	First CSECT
2	* Working‑Storage	Aggregate Length Table	–
3	* Linkage Section	Storage Requirements	–
4	Data Division Map	Static Storage Map	–
5	CLIST/Pmap	Variable Storage Map	Macro and Copy Source Catalog for high level output
6	Data Cross Reference	Table of Offsets	Data Cross Reference
7	Procedure Cross Reference	Generated Code (Assembler‑like)	Literals Cross Reference
8	Error Messages	Error Messages	Error Messages
9	Search Forward	Search Forward	Search Forward
10	Search Backward	Search Backward	Search Backward
13	Local-Storage	Procedure Cross Reference	–
14	–	Labels Cross Reference	–

* These options can be used with NESTED= entries to request a display of these sections for a specific nested program.

If you have CA InterTest for CICS, you can also use the following options:

Option	COBOL	PL/I	Assembler
11	Indirect Commands	Indirect Commands
12	Conditional Breakpoint Options	Unconditional/Conditional Breakpoint	Unconditional/Conditional Breakpoint Options

Note: The sections available for display depend on which version of the post‑processor LISTER parameter was used to compile or assemble the program. For more information, see the CA Application Quality and Testing Tools Symbolic Guide.

3—The PFKS section lists the PF key functions that are available for this screen.
4—Column 1 (represented by the underscore _) of each line is reserved for entering single‑letter commands.

If you have CA InterTest for CICS, this column is also reserved for breakpoint‑related functions. When a breakpoint takes effect during execution, it is identified in column 1 with one of the following letters:

A: Automatic (CA InterTest for CICS generated)
U: Unconditional
C: Conditional
V: Variable‑change (COBOL and Assembler)
R: Request

5—This section displays the source code from the program named in the Program= field. The numbers at the left side of each line are the COBOL or PL/I statement numbers from the compiled listing or the Assembler hexadecimal location number from the assembled listing.
Note: The display screen's format varies by terminal type. For 132‑column terminals, lines of code display as is and can be viewed in full. For 80‑column terminals, the compiler output is automatically reformatted so that most of the code is viewed in columns 1 to 80. To view code beyond column 80, change the display margins.

Tell Technical Publications how we can improve this information