Compile programs option
Select option
3 from the Program Generator Menu to display the Compile Programs
panel. You can also invoke this panel by issuing the following TSO command:
CALL 'QMFHPO.SRAALOAD(RAAMAIN)' 'CO 3'
Specify basic information about the program to prepare. This
information is used to invoke the preparation process.
Table 18. Compile Programs
DB2P / DB2PLOCATION -- Compile Programs ------------------------------ 8.1.0
Command ===>
Press ENTER to compile program.
Type CAN or CANCEL or press PF3 to bypass this compilation.
1. Compile Type........ ===> (P=Prompted, N=Non-prompted, B=Batch)
2. Source Data Set..... ===>
3. Source Member....... ===>
4. Environment......... ===> (B=Batch, T=TSO, C=CICS)
5. COBOL Dialect....... ===> (1=OS/VS, 2=VS-II, 370, or MVS)
6. Attachment Facility. ===> (C=CAF, T=TSO, R=RRSAF)
7. CAF Module Usage.... ===> (H=HPO, D=DB2)
8. Compile Options..... ===>
9. DBRM Library........ ===>
10. Bind Type........... ===> (1=Package, 2=Plan, 3=Both, 4=No bind)
11. Collection ID....... ===>
12. Plan Name........... ===>
13. Bind OWNER.......... ===>
14. Bind Validate....... ===> (BIND or RUN)
14. Target Load Library. ===>
15. Link Edit Options... ===>
16. DSNH PRINT Parameter ===> (Prompted and Non-prompted only) |
If you press Enter, all input fields will
be validated. If any errors are detected during input validation,
the panel will be redisplayed with an error message. Otherwise,
the specified compilation will be invoked online, or the Batch Job Information
panel will be displayed, after which the JCL to compile the program will
be edited or submitted.
Depending on how you reached this panel, two things can happen
after the compilation:
- If this panel was displayed by selecting the Compile Programs
option from the Program Generator Menu, it will be redisplayed after
the compilation.
- If it was displayed due to a request to compile a program after
generation (on the Generation Options panel), the next panel in
the generation process will be displayed.
If you press PF3, all input fields will
be ignored and you will return to the Program Generator Menu or
proceed with the generation process. No compilation will take place.
If you type ABORT and press Enter, all input fields will
be ignored and you will return to the Program Generator Menu or
the Report List panel. No compilation will take place.
The fields on the panel are:
- Compile Type
- Enter P to invoke a prompted compilation, via the Program Preparation option
of DB2 Interactive (DB2I). Enter N to invoke a non-prompted compilation by invoking the DSNH
command. Enter B to tailor JCL to compile the program in batch.
- Source Data Set
- Enter the data set containing the source program to compile.
The data set must exist. If the name is enclosed in single quotes,
it is taken to be a fully qualified TSO data set name. Otherwise,
your current TSO profile prefix is used to qualify the name.
- Source Member
- If the specified Source Data Set is
a PDS, this is the member containing the source program to compile.
Leave this field blank if the Source Data Set is
not a PDS.
- Environment
- Enter B if the program to be compiled is an MVS batch program, T if it is an online TSO program, or C if it is an online CICS program.
- COBOL Dialect
- Enter 1 if the program to be compiled is an OS/VS COBOL
program, 2 if it is a VS COBOL II program, 3 if it is a COBOL for MVS program, or 4 if it is a COBOL for OS/390 program.
- Attachment Facility
- Enter T if the program to be compiled uses the TSO attachment facility, C if it uses the call attachment facility (CAF), or R if it uses the RRS attachment facility (RRSAF). This option
is ignored for a CICS program.
- CAF Module Usage
- Enter D if the program to be compiled uses the DB2 call attachment module
(DSNALI), or H if it uses the HPO call attachment module (AACAF).
- Compile Options
- Enter compile options. Additional options required by Program Generator
will be appended to whatever is specified in this field.
- DBRM Library
- Enter the library for the DBRM output of the DB2 precompiler.
If the data set does not exist, the Allocate Data Set pop-up window
will be displayed, allowing you to allocate it. The data set must
be a PDS. If the name is enclosed in single quotes, it is taken
to be a fully qualified TSO data set name. Otherwise, your current
TSO profile prefix is used to qualify the name.
- Bind Type
- If compiling a report program enter 1 to bind a package, 2 to bind a plan, 3 to bind both, or 4 to bind neither. If compiling a stored procedure program,
you must set this option to 1 or 4. If compiling a proc program, enter 1 to bind a plan with a PKLIST specifying all report program packages, 2 to bind a plan including all report program DBRMs, 3 to bind a plan using a mix of report program packages and
DBRMs, or 4 to not bind a plan.
- Collection ID
- Enter the name of the collection ID to be used if Bind Type is 1 or 3. The name must conform to Collection ID naming rules.
- Plan Name
- Enter the name of the plan to be created by the bind process
for this program. The name entered must conform to plan and program
ID naming rules.
- Bind OWNER
- Enter the OWNER parameter to be used by the bind process.
If you leave this field blank, no OWNER will be specified for the
bind, and your primary authorization ID will be used.
- Bind VALIDATE
- Enter the VALIDATE parameter to be used by the bind process.
Enter BIND to validate SQL authorization and determine access path selection during
the BIND process. Specify RUN to defer this processing until the plan is executed. You
must specify RUN if this program uses static SQL that refers to nonexistent
tables (for example, SAVE DATA tables).
- Target Load Library
- Enter the data set in which to create the load module for
this program. If the data set does not exist, the Allocate Data
Set pop-up window will be displayed, allowing you to allocate it.
The data set must be a PDS. If the name is enclosed in single quotes,
it is taken to be a fully qualified TSO data set name. Otherwise,
your current TSO profile prefix will be used to qualify the name.
- Link Edit Options
- Enter link edit options. Additional options required by Program Generator
will be appended to that which is specified in this field.
- DSNH PRINT Parameter
- Enter the value to use for the DSNH PRINT parameter. This
field is used for prompted and non-prompted compiles (which invoke
DSNH).
Setting batch job parameters
Before
a batch compile is invoked (or a batch run, as discussed in "Running Programs"),
the Batch Job Information panel is displayed to obtain more information
about the job to submit. After specifying these additional batch parameters,
JCL is generated, and submitted or edited.
Table 19. Batch Job Information
DB2P / DB2PLOCATION -- Batch Job Information ------------------------- 8.1.0
Command ===>
Press ENTER to generate JCL.
Type CAN or CANCEL or press PF3 to cancel this run.
1. Job Cards...
===>
===>
===>
===>
2. Report DCB Parameters...
SYSOUT class.............. ===>
LRECL..................... ===>
DEST...................... ===>
COPIES.................... ===>
3. Enter Host Variable Values? ===> (Y=Yes, N=No)
4. Write JCL To...
Data Set ===>
Member.. ===>
5. Edit or Submit JCL?........ ===> (E=Edit, S=Submit) |
If you press Enter, all input fields will
be validated. If any errors are detected during input validation,
the panel will be redisplayed with an error message. Otherwise,
JCL will be generated and it will be edited or submitted, depending on
the value of the Edit or Submit JCL? flag
on this panel.
If you press PF3, all input fields will
be ignored and you will return to the previous panel or proceed
with the generation process. No JCL generation will take place.
The fields on the panel are:
- Job Cards
- Enter valid job cards for the job. At least one line must
be entered. Any lines specified will be used exactly as entered
in the generated JCL.
- Report DCB Parameters
- If this job will run a generated program, the following four
fields, SYSOUT class, LRECL, DEST,
and COPIES, are enabled and are used to specify
the characteristics of the REPORTnn DDs. If this job will compile
a generated program, these fields are disabled and ignored.
- SYSOUT class
- Specify the SYSOUT class for the REPORTnn DDs. If you leave
this field blank, a system default value will be used.
- LRECL
- Specify the LRECL for the REPORTnn DDs. If you leave this
field blank, 133 will be used.
- DEST
- Specify the DEST for the REPORTnn DDs. If you leave this field
blank, a system default value will be used. If no system default
value exists, the DEST parameter will be omitted.
- COPIES
- Specify the COPIES for the REPORTnn DDs. This number must
be between 1 and 254. If you leave this field blank, the COPIES
parameter will be omitted.
- Enter Host Variable Values?
- If this job will run a generated program, enter Y to display the Enter Host Variable Values pop-up window on
which you can specify values to be generated for the HOSTVARS or
PROCVARS DD. Enter N if the program does not require any input host variable values.
This field is disabled and ignored if this job will compile a generated
program.
- Data Set
- Enter the data set to which the generated JCL should be written.
If the data set does not exist, the Allocate Data Set pop-up window
will be displayed, allowing you to allocate it. If the name is enclosed
in single quotes, it is taken to be a fully qualified TSO data set
name. Otherwise, your current TSO profile prefix is used to qualify
the name. If it is a PDS, do not specify a member name here; instead,
use the Member field. You can also enter *TEMP to specify that a temporary data set should be created for
the JCL.
- Member
- If the specified Data Set is a PDS,
enter the name of the member to which the generated JCL should be
written. Leave this field blank if the Data Set is
not a PDS or is *TEMP.
- Edit or Submit JCL?
- Enter E to edit the generated JCL or S to automatically submit it after it is generated.
