CAnn (Command Attention) Keyword for Display Files

Use this file- or record-level keyword to specify that the function key specified in the keyword (CA01 through CA24) is available for use. It is to be used as a command attention (CA) key. No input data is transmitted from the device. Response indicators 01 through 99 are valid.

Refer to Appendix F, System/36 Environment Considerations Using DDS, for special considerations when specifying the CAnn keyword in files that are used in the System/36 environment.

The format of the keyword is:

CAnn[(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. (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 command function (CF) key or a command attention 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 CA and CF keywords within the same display file, but you cannot specify the same key number as both CA and CF keys. For example, CA02 and CF02 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, CA04).

Option indicators are valid for this keyword.