Foreground processing sequence

This topic describes the main sequence for foreground processing.

If you do not know whether the source data is in packed format, find out by editing the data set and entering the PROFILE command. If the source data is in packed format, the profile shows PACK ON.
If the data is packed, select the Source Data Packed option. If the data is not packed, deselect this option.
Also, you should read Expanding packed data, paying close attention to:
- Information that applies to the foreground processor you plan to use.
- The difference between expanding a sequential data set and expanding members of a partitioned data set.
When you are satisfied that the data set is ready to be processed, continue with the next step.
Select one of the foreground processors listed at the top of the Foreground Selection panel shown in Figure 1.
Note: A region size of 2 megabytes or more will probably be required to run the VS FORTRAN compiler in the foreground.
Select the Source Data Packed option to tell ISPF if it needs to expand the source data.
Note: The Source Data Packed option has no effect on the Member parts list option (4.12). Member parts list can read both packed and unpacked data sets, so no expansion is needed.
When the Session Manager licensed program, 5740-XE2, is installed, you can select the Session Manager mode option on the ISPF Settings panel so that you enter Session Manager mode when you call any of the foreground processors. Once you call Session Manager, it stays in effect for all logical screens until you turn it off. For example, if you call Session Manager and then split the screen, Session Manager will be in effect on both logical screens.
Note: If graphics interface mode is active, Session Manager does not get control of the screen. Graphics interface mode is started when a GRINIT service has been issued, but a GRTERM service has not been issued. See z/OS ISPF Services Guide for more information about these two services.
Press Enter. ISPF displays the data entry panel for the processor you selected. The remainder of this processing sequence applies to all foreground processors except SCRIPT/VS, VS COBOL II interactive debug, COBOL interactive debug, and Member Parts List. For these processors, use the sequence referred to in this list:
Processor

Reference

SCRIPT/VS

SCRIPT/VS processor (option 4.9)

VS COBOL II interactive debug

VS COBOL II interactive debug (option 4.10)

COBOL interactive debug

OS/VS COBOL debug (option 4.10A)

Member parts list

Member parts list (option 4.12)
Enter the appropriate ISPF library and concatenation sequence or data set name. If the input data set is partitioned, you can leave the member name blank or use a pattern to display a member list. If you need help, see:
- The Naming ISPF Libraries and Data Sets section of the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I for help in 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 patterns and displaying member lists
- Input data sets for information about the regular concatenation sequence
- Object data sets for information about object modules
- Linkage editor concatenation sequence for help with the linkage editor concatenation sequence
VS FORTRAN has no LIB option, which some foreground processors use to specify the input data set concatenation sequence. Therefore, the concatenation sequence specified in the Group fields is used to find the member to be compiled.

For FORTRAN interactive debug, the TYPE, or last qualifier, must be either OBJ or LOAD. However, if you specify an OBJ data set as your input data set, you must include a load library or data set in the input search sequence (see step 11).
This step applies to FORTRAN interactive debug only. Use the Source Type field to tell ISPF the Type, or last qualifier, of the data set used to create the input object module or load module.
Use the List ID field to tell ISPF what to name the output listing. See List data sets for more information.
Enter your password in the Password field if your input data set is password-protected. See Password protection for more information.
The Option field, whether ASSEMBLER, COMPILER, LINKAGE EDITOR, or DEBUG, is remembered from one session to another. Therefore, you do not need to change this field unless the options you need are not displayed.
Be careful not to enter any options that ISPF generates automatically. These options are listed on the data entry panel. For more information about the options available for your processor, refer to the documentation supplied with that processor.
Enter any additional input libraries you need. For FORTRAN interactive debug, enter any input LOAD libraries that you need to complete the search sequence. These libraries must be LOAD libraries only. See Input data sets if you need help.
Once all the input fields have been specified, press Enter to call the foreground processor.
If the Session Manager is installed and you selected Session Manager mode on the ISPF Settings panel, the foreground processor and all function keys and PA keys are under the control of the Session Manager. When foreground 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 the Enter key.
Communication with foreground processors is in line-I/O mode. Whenever you see three asterisks, press Enter.
If the foreground processor generated an output listing, the listing is displayed automatically in Browse mode.
Note: If a Foreground 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.

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.
An optional print utility exit routine can be installed by your system programmer. If this exit routine is installed, it may cause the Foreground option's response to differ from the descriptions shown here. See z/OS ISPF Planning and Customizing for more information about the print utility exit.
Another factor that can affect the performance of the Foreground option is whether the TSO/E Information Center Facility is installed. If the TSO/E Information Center Facility is installed, your installation can optionally allow ISPF to display a panel for submitting TSO/E Information Center Facility information with the print request. See Figure 1 for an example of this panel and Using the TSO/E information center facility for information about the fields on this panel. If the TSO/E Information Center Facility is not installed, the Foreground option displays the panel shown in Figure 1 to allow you to print, keep, or delete the output.
Figure 1. Foreground Print Options panel (ISRFPPRT)
```
                          Foreground Print Options

   PK  Print data set and keep          K  Keep data set (without printing)
   PD  Print data set and delete        D  Delete data set (without printing)

   If END command is entered, data set is kept without printing.

 Data set name . :

 Print mode  . . . BATCH              (Batch or Local)

 Batch SYSOUT class . .               
 Local Printer id or
       writer-name. . .                    (For local printer)
 Local SYSOUT class . .                

 Job statement information:           (Required for system printer)
   ===>                                                                        
   ===>                                                                        
   ===>                                                                        
   ===>                                                                        
 Option  ===>                                                                 
  F1=HELP      F2=          F3=END       F4=DATASETS  F5=FIND      F6=CHANGE
  F9=SWAP     F10=LEFT     F11=RIGHT    F12=SUBMIT
```
On this panel, the "Data set name" field shows the name of the list data set that contains the output generated by the processor you selected. In the Option field, enter one of the options shown at the top of the panel. The "Print mode", "Batch SYSOUT class", "Local Printer id or writer name", and Local SYSOUT Class fields on this panel are described under Hardcopy utility (option 3.6). The "Job statement information" field is described under the Job Statement Information section of the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I.

When you press Enter, the processor entry panel is displayed again. A message indicating completion of the process is displayed in the upper-right corner of the screen.
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.