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 |