External Product Interface › EPI Host Command Descriptions › Special EPI Host Commands › SUBATTR [sub_char] [ON|OFF]

SUBATTR [sub_char] [ON|OFF]

This command affects the way the RDSCREEN and RDSCRROW commands return information.

If you specify a single character operand (sub_char), the SUBATTR command sets the substitute character to be used for all host attribute byte characters. The argument can be a single character or a numeric value in the range 0 through 255 corresponding to the EBCDIC value of the desired character. The program return code indicates the value the setting 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, attribute characters are not translated.

If you specify ON, attribute characters are translated. This reverses the effect of a previously issued SUBATTR OFF command.

Default: OFF

Note: The SUBATTR command only affects the output returned from the RDSCREEN and RDSCRROW commands. Attribute bytes are not actually modified on the screen of the virtual terminal by this command.

The following example sets the value to a percent sign:

SUBATTR %

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