CALL name

where the delimiter after the name can be either a left parenthesis, a blank, or a valid statement delimiter. In COBOL, the CALL statement is valid only in the PROCEDURE DIVISION, and the CALL PGMA and CALL 'PGMA' statements both result in a reference to the member name PGMA.

When you select the Foreground Member parts list option (4.12), the panel shown in Figure 1 is displayed.

   Menu  RefList  Utilities  Help
 ───────────────────────────────────────────────────────────────────────────────
                          Foreground Member Parts List

 1 Browse/Print member parts
 2 Write member parts data set

 ISPF Library:
    Project . . .         
    Group . . . .          . . .          . . .          . . .         
    Type  . . . .         
    Member  . . .           (Blank or pattern for member selection list)

 Language . . . .           (Defaults to Type value)

 Groups for Primary members . . . 1  (1, 2, 3, or 4)

 Output Data Set:          (option 2 only)
    Data Set Name  . .                                                         


 Option ===>                                                                   
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=Actions  F12=Cancel

The member parts list does not use the Source Data Packed option on the Foreground Selection panel; both packed and unpacked data sets can be read.

Fill in the fields on the Foreground Member Parts List panel as follows:

1. Select one of the options listed at the top of the panel by typing its number in the Option field.
2. Enter the appropriate ISPF library and concatenation sequence or data set names. A blank member name results in a member list being displayed. You can select only one member from this list. A pattern results in the processing of all member names matching the pattern; an asterisk results in all members being processed.

   See the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I if you need help entering library or data set names, the Displaying Member Lists section of the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I for information about using patterns and displaying member lists, and Input data sets for more information about the concatenation sequence.

3. The Language field is optional. It is used to specify the language in which the source code is written. If you leave this field blank, ISPF uses the value in the Type field as the default. However, the language must be one of these:
   • Assembler
   • COBOL
   • FORTRAN
   • Pascal
   • PLI
   • SCRIPT.
4. In the "Groups For Primary members" field, enter a number from 1 to 4. This number tells ISPF how many libraries in the concatenation sequence are to be used in locating primary members. For example, if you enter 2, the first and second libraries specified in the Group field are used to find primary members.
5. If you selected option 2 (write member parts data set), use the Data Set Name field to tell ISPF where to write the output data set. The name you enter:
   • Can be a sequential data set or a member of a partitioned data set
   • Must follow standard TSO data set naming conventions.

   If you enter the name of a data set that does not exist, ISPF allocates it for you.

6. Once all the input parameters have been specified, press Enter to call the Foreground Member Parts List processor.

   If the Session Manager is installed and if you specified Session Manager mode on the Foreground Selection panel, the Foreground Member Parts List processor and all function keys and PA keys are under control of the Session Manager. When processing is complete, you are prompted to enter a null line to return to ISPF control.

   If the Session Manager is not called, the PA and function keys have their usual TSO-defined meanings; generally, the function keys are treated the same as Enter.

7. Communication with the Foreground Member Parts List processor is in line-I/O mode. Each time you see three asterisks, press Enter. These asterisks, which usually appear at the bottom of the screen, show that TSO is waiting for you to clear the screen before it can proceed.
8. The option you chose in step 1 determines what happens next.
   Note: If the Foreground Member Parts List processing program ends abnormally, ISPF displays a message in the upper-right corner of the screen and does not enter Browse mode. The list data set is retained, but the Foreground Print Options panel (see step 15) is not displayed.

   Option 1 (Browse/print member parts) creates the member parts list and displays it in Browse mode. This figure shows an example.

   Figure 2. Member parts list display (ISRFP12B)

    BROWSE - Parts List for ISPFPROJ.ABL.PLI(*) ----------------------------------
   
     From   Via         From   Via     Member       To    Via          To    Via
    ------- ---       -------- ---    --------   -------- ---       -------- ---
   ********************************* Top of Data **********************************
                                     (MEMBERA )
                                     (MEMBERB )  MEMBERC  C
                      MEMBERB  C     (MEMBERC )  MEMBERD  C         MEMBERE  I
                                                 MEMBERG  C*
                      MEMBERC  C     (MEMBERD )  MEMBERE  I
    MEMBERC  I        MEMBERD  I     (MEMBERE )
                                     (MEMBERF )
   ******************************** Bottom of Data ********************************
   
   
   
   
   
   
   
    Command ===>                                                  Scroll ===> PAGE
     F1=Help    F2=Split   F3=Exit    F5=Rfind   F7=Up      F8=Down    F9=Swap
    F10=Left   F11=Right  F12=Cancel

   The figure shows that:

   • Library ISPFPROJ.ABL.PLI contains these members:

     MEMBERA

     Has no calls or includes.

     MEMBERB

     Calls MEMBERC.

     MEMBERC

     Calls MEMBERD and MEMBERG, and includes MEMBERE. The asterisk (*) beside the C in the third VIA column means that MEMBERG was not found in the input library.

     MEMBERD

     Includes MEMBERE.

     MEMBERE

     Has no calls or includes.

     MEMBERF

     Has no calls or includes.

   • A parts list is requested for all members in the first data set.

   You can scroll the output up or down using the scroll commands. All the Browse commands are available to you. When you finish browsing the listing, enter the END command and continue with step 15.

   Option 2 (Write member parts data set) produces an intermediate sequential member parts list in the data set you named in step 5. This data set can be either a sequential data set or a member of a partitioned data set.

   If the data set has not been allocated, option 2 allocates it with a logical record length (LRECL) of 17, a block size (BLKSIZE) of 3009, and a record format (RECFM) of FB. The format of the records is shown in Table 1:

   Table 1. Foreground member parts list record formats

   Field Name	Format	Description
   Member name	CHAR(8)	Subject member.
   Called by or calls member name	CHAR(8)	Referenced member.
   Call flag	BIT(1)	Found on a CALL statement.
   Include flag	BIT(1)	Found by INCLUDE or COPY.
   Not found flag	BIT(1)	Referenced member not found.
   From flag	BIT(1)	Subject member called from referenced member.
   To flag	BIT(1)	Referenced member called from subject member.
   COBOL flag	BIT(1)	Member referenced outside valid COBOL division.
   Reserved	BIT(2)	Field that is reserved.

9. You can perform one of these actions:
   • Enter other parameters and call the same processor.
   • Enter the END command to return to the Foreground Selection panel and select another processor.
   • Enter the RETURN command to go to the ISPF Primary Option Menu.
   • Use the jump function (=) to choose any primary option.