DDS for display files


CFnn (Command Function) keyword for display files

Use this file- or record-level keyword to specify that the function key specified in the keyword (CF01 through CF24) is available for use. It is to be used as a command function (CF) key to transmit changed data as opposed to a command attention (CA) key, which does not transmit changed data. Response indicators 01 through 99 are valid.

Refer to Appendix B, System/36 environment considerations for display files, for special considerations when specifying the CFnn keyword in files that are used in the System/36 environment.

The format of the keyword is:

CFnn[(response-indicator ['text'])]

If you specify this keyword, and the display station user presses the specified function key, the following happens:

If you specify a response indicator and the key is pressed, the response indicator is set on and returned to your program along with the input data. If no response indicator is specified, the input data is returned to your program. (The text information is associated with the indicator and is used by high-level language compilers to help in program documentation.)

If the display station user presses a function key and you have not specified it as either a CF key or a CA key, the OS/400 program displays a message to the display station user indicating that the key is not valid at that time.

You can use combinations of CF and CA keywords within the same display file, but you cannot specify the same key number as both command attention and command function. For example, CA01 and CF01 are not valid in the same display file.

Note:
File level CA and CF keys are extended to the record level. This must be considered when assigning key numbers. For example, if CA02 is specified at file level and CF02 is specified at record level, CF02 is an error.

If you specify a key in the range 1 through 9, you must supply the leading zero in the keyword (for example, CF03).

Option indicators are valid for this keyword.

Function keys valid for command function keys at processing time:

As a general rule, the last output operation determines which function keys are valid. The following are exceptions to this rule:

Note:
The ROLLUP and ROLLDOWN keywords function like CF keys.

Example:

The following example shows how to specify the CFnn keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A                                      CF01(91 'End of Program')
00020A                                      CF02(92)
00030A                                      CF03
     A


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]