DB2I Run panel

The DB2I Run panel lets you start an application program that can contain SQL statements.

You can reach the Run panel only through the DB2I Primary Options Menu. You can accomplish the same task using the Program Preparation: Compile, Link, and Run panel. You should use this panel if you have already prepared the program and simply want to run it. Figure 1 shows the run options.

Figure 1. The Run panel

DSNERP01                       RUN                            SSID: DSN
 COMMAND ===>_
 
 Enter the name of the program you want to run:
  1  DATA SET NAME ===>
  2  PASSWORD..... ===>        (Required if data set is password protected)
 
 Enter the following as desired:
  3  PARAMETERS .. ===>
  4  PLAN NAME ... ===>        (Required if different from program name)
  5  WHERE TO RUN  ===>        (FOREGROUND, BACKGROUND, or EDITJCL)

This panel lets you run existing application programs.

1 DATA SET NAME

Lets you specify the name of the partitioned data set that contains the load module. If the module is in a data set that the operating system can find, you can specify the member name only. There is no default.

If you do not enclose the name in apostrophes, a standard TSO prefix (user ID) and suffix (.LOAD) is added.

2 PASSWORD

Lets you specify the data set password if needed. The RUN processor does not check whether you need a password. If you do not enter a required password, your program does not run.

3 PARAMETERS

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

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 the slash to pass parameters to the application program.

4 PLAN NAME

Lets you specify the name of the plan to which the program is bound. The default is the member name of the program.

5 WHERE TO RUN

Lets you indicate whether to run in the foreground or background. You can also specify EDITJCL, in which case you are able to edit the job control statement before you run the program. Use:

FOREGROUND to immediately run the program in the foreground with the specified values.
BACKGROUND to create and immediately submit to run a file containing a DSNH CLIST using the JOB control statement from either DB2I Defaults Panel 2 or your site's SUBMIT exit. The program runs in the background.
EDITJCL to create and open a file containing a DSNH CLIST in edit mode. You can then submit the CLIST or save it. The program runs in the background.

Running command processors

To run a command processor (CP), use the following commands from the TSO ready prompt or as a TSO TMP:

DSN SYSTEM (Db2-subsystem-name)
RUN CP PLAN (plan-name)

The RUN subcommand prompts you for more input. The end the DSN processor, use the END command.