Previous Topic: SUBATTR [sub_char] [ON|OFF]Next Topic: SUBSYS ssid


SUBUNPT [sub_char] [ON|OFF]

Use this command to affect the way the RDSCREEN and RDSCRROW commands return information.

If you specify a single character operand (sub_char), the SUBUNPT command sets the substitute character to be used for unprintable characters. The argument can be a single character or a numeric value in the range of 0 through 255 that corresponds to an EBCDIC value. The program return code indicates the setting value before the command was issued. A subroutine can be used to temporarily alter the value, and then restore the environment to its former state.

If you specify OFF, unprintable characters are not translated. If you specify ON, unprintable characters are translated. This reverses the effect of a previously issued SUBUNPT OFF command.

Default: OFF

The SUBUNPT command only affects the output returned from the RDSCREEN and RDSCRROW commands. Unprintable characters are not actually modified on the screen of the virtual terminal by this command.

The following example sets the value of SUBUNPT to a slash:

SUBUNPT / ON

Return codes represent the EBCDIC equivalents of the previous SUBUNPT value.