DB2 graphic QMF Version 8

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 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.


Go to the previous page Go to the next page

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright IBM Corporation 1982,2004 Copyright IBM Corporation 1982, 2004
timestamp Last updated: March, 2004