Program Preparation: Compile, Link, and Run panel

The Compile, Link, and Run panel lets you perform the last two steps in the program preparation process (compile and link-edit). This panel also lets you perform the PL/I MACRO PHASE for programs that require this option.

For TSO programs, the panel also lets you run programs.

Figure 1. The Program Preparation: Compile, Link, and Run panel

DSNEPP02    PROGRAM PREP: COMPILE, PRELINK, LINK, AND RUN     SSID: DSN
 COMMAND ===>_
 
 Enter compiler or assembler options:
  1  INCLUDE LIBRARY ===> SRCLIB.DATA
  2  INCLUDE LIBRARY ===>
  3  OPTIONS ....... ===> NUM, OPTIMIZE, ADV
 
 Enter linkage editor options:
  4  INCLUDE LIBRARY ===> SAMPLIB.COBOL
  5  INCLUDE LIBRARY ===>
  6  INCLUDE LIBRARY ===>
  7  LOAD LIBRARY .. ===> RUNLIB.LOAD
  8  PRELINK OPTIONS ===>
  9  LINK OPTIONS... ===>
 Enter run options:
 10  PARAMETERS .... ===> D01, D02, D03/
 11  SYSIN DATA SET  ===> TERM
 12  SYSPRINT DS ... ===> TERM

1,2 INCLUDE LIBRARY

Lets you specify up to two libraries containing members for the compiler to include. The members can also be output from DCLGEN. You can leave these fields blank. There is no default.

3 OPTIONS

Lets you specify compiler, assembler, or PL/I macro processor options. You can also enter a list of compiler or assembler options by separating entries with commas, blanks, or both. You can leave these fields blank. There is no default.

4,5,6 INCLUDE LIBRARY

Lets you enter the names of up to three libraries containing members for the linkage editor to include. You can leave these fields blank. There is no default.

7 LOAD LIBRARY

Lets you specify the name of the library to hold the load module. The default value is RUNLIB.LOAD.

If the load library specified is a PDS, and the input data set is a PDS, the member name specified in INPUT DATA SET NAME field of the Program Preparation panel is the load module name. If the input data set is sequential, the second qualifier of the input data set is the load module name.

You must complete this field if you request LINK or RUN on the Program Preparation panel.

8 PRELINK OPTIONS

Lets you enter a list of prelinker options. Separate items in the list with commas, blanks, or both. You can leave this field blank. There is no default.

The prelink utility applies only to programs using C, C++, and Enterprise COBOL for z/OS®.

9 LINK OPTIONS

Lets you enter a list of link-edit options. Separate items in the list with commas, blanks, or both.

To prepare a program that uses 31-bit addressing and runs above the 16-megabyte line, specify the following link-edit options: AMODE=31, RMODE=ANY.

10 PARAMETERS

Lets you specify a list of parameters you want to pass either to your host language run time processor, or to your application. Separate items in the list with commas, blanks, or both. You can leave this field blank.

If you are preparing an IMS or CICS® program, you must leave this field blank; you cannot use DB2I to run IMS and CICS programs.

Use a slash (/) to separate the options for your run time processor from those for your program.

For PL/I and Fortran, run time processor parameters must appear on the left of the slash, and the application parameters must appear on the right.
```
run time processor parameters / application parameters
```
For COBOL, reverse this order. run time processor parameters must appear on the right of the slash, and the application parameters must appear on the left.
For assembler and C, there is no supported run time environment, and you need not use a slash to pass parameters to the application program.

11 SYSIN DATA SET

Lets you specify the name of a SYSIN (or in Fortran, FT05F001) data set for your application program, if it needs one. If you do not enclose the data set name in apostrophes, a standard TSO prefix (user ID) and suffix is added to it. The default for this field is TERM.

If you are preparing an IMS or CICS program, you must leave this field blank; you cannot use DB2I to run IMS and CICS programs.

12 SYSPRINT DS

Lets you specify the names of a SYSPRINT (or in Fortran, FT06F001) data set for your application program, if it needs one. If you do not enclose the data set name in apostrophes, a standard TSO prefix (user ID) and suffix is added to it. The default for this field is TERM.

If you are preparing an IMS or CICS program, you must leave this field blank; you cannot use DB2I to run IMS and CICS programs.

Your application could need other data sets besides SYSIN and SYSPRINT. If so, remember to catalog and allocate them before you run your program.

When you press ENTER after entering values in this panel, Db2 compiles and link-edits the application. If you specified in the Db2 Program Preparation panel that you want to run the application, Db2 also runs the application.