PLB_IOCANCELCHAR Keyword

9.6A

PLB_IOCANCELCHAR={abortkey}

This keyword defines a default character or function key that will abort/cancel a read operation for a FILE, AFILE and IFILE. When this keyword is specified, the runtime read file operations automatically enable the abort/cancel support for the file variables for read instructions. If this keyword is not specified, the default behavior of the runtimes does not allow read operations to be aborted/canceled. Note, that the SETMODE *IOCANCELCHAR keyword enables the read abort/cancel mode for a specific program that is executing.

Where:

{abortkey}

This parameter can be specified as a single key for a character such as A, B, or C. Also, this parameter can be specified as a key name that identifies a key such as ESC, F1, or F2. The following key names are supported for the {abortkey} parameter:

ESC, ESCAPE,

F1, F2, F3, F4, F5, F6, F7, F8, F9, F10,

F11, F12, F13, F14, F15, F16, F17, F18, F19, F20,

F21, F22, F23, F24, F25, F26, F27, F28, F29, F30,

F31, F32, F33, F34, F35, F36, F37, F38, F39, F40,

UP, DOWN, LEFT, RIGHT,

INS, INSERT, DEL, DELETE,

HOME, PGUP, PAGEUP, PGDN, PAGEDOWN, END

Note:

For the FILE and IFILE abort support, the read abort capability ONLY takes affect when a FILTER is being used for the FILE and IFILE read operations.
This keyword replaces the PLB_AAMCANCELCHAR keyword that is now obsolete.

Examples:

PLB_IOCANCELCHAR=a

PLB_IOCANCELCHAR=F3

PLB_IOCANCELCHAR=ESC

PLB_IOCANCELCHAR=ESCAPE