DECRPSS—Report Selection or Setting

The terminal sends the host this sequence in response to a request selection or setting (DECRQSS) sequence. The terminal sends DECRPSS to report the setting of a particular control function.

Programming Tip
Applications can use the information in the DECRPSS report to save the current selections or settings of some control functions. Later, the application can restore the control functions to their saved state.

This operation is useful for applications that need to temporarily change the settings of some of the terminal's control functions. When the application is finished, it can restore the control functions to their previous state.

Format

DCS
9/0
Ps
3/n
$
2/4
r
7/2
D ... D
...
ST
9/12

Parameters

Ps
indicates whether or not the request from the host is valid.

Ps Host Request
0 Host's request is valid.
1 Host's request is invalid.

D ... D
indicates the current setting of a valid control function that the host asked about. D...D consists of all the characters in the control function, except the CSI (9/11) or ESC [ (1/11, 5/11) introducer characters.

Examples

The host requests the setting of the select graphic rendition (SGR) function. If the current graphic rendition is underline, blinking, and reverse, then the terminal responds with the following DECRPSS sequence:

DCS 0 $ r 0 ; 4 ; 5 ; 7 m ST

0 ; 4 ; 5 ; 7 m are all the characters in the SGR sequence, except CSI.

The host requests the setting of the set top and bottom margin function (DECSTBM). If the current top and bottom margins are set to include the complete screen area (24 lines/screen), then the terminal responds with the following DECRPSS sequence:

DCS 0 $ r 1 ; 24 r ST

1 ; 24 r are all the characters in the DECSTBM sequence, except CSI.

The host requests the setting of a function that the terminal does not recognize. The terminal responds with the following DECRPSS sequence:

DCS 1 $ r ST

The terminal does not send a data string (D...D) to the host when the terminal receives an invalid request.

DECRPSS (and DECRQSS) support the following settings or selections:

Setting Mnemonic Final Character(s)
Select Active Status Display DECSASD $ }
Select Attribute Change Extent DECSACE * x
Set Character Attribute DECSCA " q
Set Conformance Level DECSCL " p
Set Columns Per Page DECSCPP $ |
Set Lines Per Page DECSLPP t
Set Number of Lines per Screen DECSNLS * |
Set Status Line Type DECSSDT $ ~
Set Left and Right Margins DECSLRM s
Set Top and Bottom Margins DECSTBM r
Set Graphic Rendition SGR m
Select Set-Up Language DECSSL p
Select Printer Type DECSPRTT $ s
Select Refresh Rate DECSRFR " t
Select Digital Printed Data Type DECSDPT ( p
Select ProPrinter Character Set DECSPPCS * p
Select Communication Speed DECSCS * r
Select Communication Port DECSCP * u
Set Scroll Speed DECSSCLS SP p
Set Cursor Style DECSCUSR SP q
Set Key Click Volume DECSKCV SP r
Set Warning Bell Volume DECSWBV SP t
Set Margin Bell Volume DECSMBV SP u
Set Lock Key Style DECSLCK SP v
Select Flow Control Type DECSFC * s
Select Disconnect Delay Time DECSDDT $ q
Set Transmit Rate Limit DECSTRL " u
Set Port Parameter DECSPP + w