Previous Topic: Block Mode and Server Executable LocationsNext Topic: Regeneration After Testing


Application Startup Parameters for Block Mode

For block mode applications, startup parameters supply information to the executable procedure without entering the information on the screen. The executable procedure must be an online procedure that accepts clear screen input. Use the Dialog Flow Diagramming Tool to define clear screen input.

The unformatted input is a transaction code followed by one or more parameters. Separate the parameters with the appropriate string and parameter delimiters. Use the Business System Defaults to define the string and parameter delimiters.

Note: For more information about clear screen input, see the Block Mode Design Guide.

Use keywords to define the parameter list. Keywords are labels that identify the parameter and must be accompanied by the parameter data enclosed in delimiters. The format for parameters is:

tran_code KEYWORD1 data1, KEYWORD2 data2 . . .

where:

tran_code

The transaction code to invoke in the load module.

<space>

The string separator.

KEYWORD1, KEYWORD2

Keywords

<space>

Keyword or data separator.

data1, data2

Data associated with the keyword used by the executable procedure.

<comma>

Parameter delimiter.

If spaces are not selected as the parameter delimiter, they are ignored. The keyword can be the prompt that associates the field on the screen to the procedure step, or a label that associates the field to the procedure step. Keywords must be unique.

When using keywords, the parameters can be in a different order than the parameter list on the screen. For example, the following clear screen inputs are equally acceptable:

tran_code NAME Mary Valdez, NUMBER 123-45-6789
tran_code NUMBER 123-45-6789, NAME Mary Valdez

Keywords are case-sensitive and cannot contain delimiters. You can append symbols. For example, you can append an equal sign (=) to the keyword NAME, and it would appear as NAME=Mary Valdez.

If you do not define parameters with a keyword, you must enter the parameters in the same order as they are defined in the list on the Dialog Flow Diagram.

Two parameters predefined to CA Gen procedures are RESET and RESTART. These parameters apply only to online procedures of block mode applications. You must specify in the Environment Tool if you want your application to also support the RESTART parameter.

The RESTART parameter lets you redisplay an interrupted dialog. RESTART restores all data to the screen that was present when the interruption occurred. RESET allows you to redisplay a screen by starting the dialog at the beginning. Data from the interrupted dialog is not restored to the screen.

Note: For more information on RESET and RESTART, see the Toolset Help.