|
Document revision date: 19 July 1999
|
![[Compaq]](../../images/compaq.gif) |
![[Go to the documentation home page]](../../images/buttons/bn_site_home.gif)
![[How to order documentation]](../../images/buttons/bn_order_docs.gif)
![[Help on this site]](../../images/buttons/bn_site_help.gif)
![[How to contact us]](../../images/buttons/bn_comments.gif)
|
![[OpenVMS documentation]](../../images/ovmsdoc_sec_head.gif)
|
OpenVMS I/O User's Reference Manual
C.2 Terminal Sequences and Modes
Table C-2 lists the valid ANSI and DIGITAL private escape sequences
for terminals that have the TT2$M_ANSICRT, TT2$M_DECCRT, TT2$M_AVO,
TT2$M_EDIT, and TT2$M_BLOCK characteristics (see Section 5.2.1.4).
Table C-2 also lists assumed and selectable ANSI modes and
selectable DIGITAL private modes. Only the names of the escape
sequences and modes are listed (for more information see the specific
VT100-, VT200-, or VT300- family user's guide). Unless otherwise noted,
the operation of escape sequences and modes is identical to the
particular VT100-, VT200-, or VT300- family terminals that implement
these features.
Table C-2 Sequences and Modes
| Name |
Valid Parameters |
ANSICRT |
DECCRT |
AVO |
EDIT |
BLOCK1 |
| ANSI-Defined Escape Sequences |
|
CPR
|
All
|
x
|
x
|
|
|
|
|
CUB
|
All
|
x
|
x
|
|
|
|
|
CUD
|
All
|
x
|
x
|
|
|
|
|
CUF
|
All
|
x
|
x
|
|
|
|
|
CUP
|
All
|
x
|
x
|
|
|
|
|
CUU
|
All
|
x
|
x
|
|
|
|
|
DSR
|
0,3,5,6
|
x
|
x
|
|
|
|
|
ED
|
0,1,2
|
x
|
x
|
|
|
|
|
EL
|
0,1,2
|
x
|
x
|
|
|
|
|
HVP
|
All
|
x
|
x
|
|
|
|
|
IND
|
|
x
|
x
|
|
|
|
|
NEL
|
|
x
|
x
|
|
|
|
|
RI
|
|
x
|
x
|
|
|
|
|
RIS
|
|
x
|
x
|
|
|
|
|
SCS
|
UK,ASCII,0
|
x
|
|
|
|
|
|
SCS
|
UK,ASCII
|
x
|
x
|
|
|
|
|
SGR
|
0,4,7
|
x
|
x
|
|
|
|
|
SGR
|
0,1,4,5,7
|
|
|
x
|
|
|
|
DA
|
Terminal specific
|
|
|
x
|
|
|
|
HTS
|
|
|
x
|
|
|
|
|
RM
|
Class specific
|
|
x
|
|
|
|
|
SM
|
Class specific
|
|
x
|
|
|
|
|
TBC
|
0,3
|
|
x
|
|
|
|
|
DCH
|
All
|
|
|
|
x
|
x
|
|
DL
|
All
|
|
|
|
x
|
x
|
|
IL
|
All
|
|
|
|
x
|
x
|
| DIGITAL Private Escape Sequences |
|
DECDHDL
|
2,3
|
|
x
|
|
|
|
|
DECDWL
|
6
|
|
x
|
|
|
|
|
DECKPAM
|
|
|
x
|
|
|
|
|
DECKPNM
|
|
|
x
|
|
|
|
|
DECRC
|
8
|
|
x
|
|
|
|
|
DECSC
|
7
|
|
x
|
|
|
|
|
DECSTBM
|
All
|
|
x
|
|
|
|
|
DECSWL
|
5
|
|
x
|
|
|
|
|
DECPRO
|
0,1,4,5,7,254
|
|
|
|
|
x
|
|
DECTTC
|
0,1
|
|
|
|
|
x
|
|
DECXMIT
|
5
|
|
|
|
|
x
|
| ANSI Selectable Modes (Set with ANSI SM/RM) |
|
IRM
|
4
|
|
|
|
x
|
x
|
|
GATM
|
1
|
|
|
|
x
|
x
|
|
ERM
|
6
|
|
|
|
|
x
|
|
TTM
|
16
|
|
|
|
|
x
|
| DIGITAL Private Selectable Modes (Set with ANSI SM/RM) |
|
DECCKM
|
1
|
|
|
x
|
|
|
|
DECANM
|
2
|
|
|
x
|
|
|
|
DECCOLM
|
3
|
|
|
x
|
|
|
|
DECSCLM
|
4
|
|
|
x
|
|
|
|
DECSCNM
|
5
|
|
|
x
|
|
|
|
DECOM
|
6
|
|
|
x
|
|
|
|
DECAWM
|
7
|
|
|
x
|
|
|
|
DECARM
|
8
|
|
|
x
|
|
|
|
DECEDM
|
10
|
|
|
|
|
x
|
|
DECEKEM
|
16
|
|
|
|
|
x
|
|
DECLTM
|
11
|
|
|
|
|
x
|
|
DECSCFDM
|
13
|
|
|
|
|
x
|
|
DECTEM
|
14
|
|
|
|
|
x
|
| ANSI Assumed Modes |
|
CRM
|
|
Reset
|
Reset
|
|
|
|
|
EBM
|
|
Reset
|
Reset
|
|
|
|
|
ERM
|
|
Set
|
Set
|
|
2
|
|
|
FEAM
|
|
Reset
|
Reset
|
|
|
|
|
FETM
|
|
Reset
|
Reset
|
|
|
|
|
GATM
|
|
N/A
|
N/A
|
|
2
|
|
|
HEM
|
|
N/A
|
N/A
|
|
|
|
|
IRM
|
|
Reset
|
Reset
|
2
|
2
|
|
|
KAM
|
|
Reset
|
Reset
|
|
|
|
|
MATH
|
|
N/A
|
N/A
|
|
|
|
|
PUM
|
|
Reset
|
Reset
|
|
|
|
|
SATM
|
|
N/A
|
N/A
|
|
|
|
|
SRTM
|
|
Reset
|
Reset
|
|
|
|
|
TSM
|
|
Reset
|
Reset
|
|
|
|
|
TTM
|
|
N/A
|
N/A
|
|
2
|
|
|
VEM
|
|
N/A
|
N/A
|
|
|
|
1Terminal characteristics. Prefix is TT2$M_.
2Selectable mode.
Appendix D
Control Connection Routines
This appendix lists and describes the calling conventions for the
pseudoterminal driver control connection routines. The routines appear
in this section in alphabetical order. Table D-1 lists the control
connection routines and their functions.
Table D-1 Control Connection Routines
| Routine Name |
Description |
|
PTD$CANCEL
|
Cancels a queued control connection read request
|
|
PTD$CREATE
|
Creates a pseudoterminal
|
|
PTD$DELETE
|
Deletes a pseudoterminal
|
|
PTD$READ
|
Reads data from the pseudoterminal
|
|
PTD$READW
|
Reads data from the pseudoterminal and waits for read to complete
|
|
PTD$SET_EVENT_NOTIFICATION
|
Enables or disables terminal event notification ASTs
|
|
PTD$WRITE
|
Writes data to the pseudoterminal
|
PTD$CANCEL
Cancels a queued control connection read request.
Format
PTD$CANCEL chan
RETURNS
| OpenVMS usage: |
cond_value |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by value |
Arguments
chan
| OpenVMS usage: |
channel |
| type: |
word (unsigned) |
| access: |
read only |
| mechanism: |
by value |
Number of the I/O channel assigned to the pseudoterminal. This channel
is only intended to be used for PTD$XXX operations.
Return Values
|
SS$_NORMAL
|
Normal successful completion.
|
|
SS$_DEVOFFLINE
|
Device is off line and request cannot proceed.
|
|
SS$_IVCHAN
|
Illegal channel.
|
|
SS$_NOPRIV
|
Insufficient privilege to perform request.
|
PTD$CREATE
Creates a new pseudoterminal with a unique device name.
Format
PTD$CREATE chan [,acmode] [,charbuff] [,buflen] [,astadr] [,astprm]
[,ast_acmode], inadr
RETURNS
| OpenVMS usage: |
cond_value |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by value |
Arguments
chan
| OpenVMS usage: |
channel |
| type: |
word (unsigned) |
| access: |
write only |
| mechanism: |
by reference |
Number of the channel that is assigned to the new pseudoterminal. This
argument is the address of a word into which PTD$CREATE writes the
channel number. This channel is only intended to be used for PTD$XXX
operations.
acmode
| OpenVMS usage: |
access_mode |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
Access mode to be associated with the channel. The most privileged
access mode is the access mode of the caller. I/O operations on the
channel can be performed only from equal and more privileged access
modes.
charbuff
| OpenVMS usage: |
device_characteristics |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by reference |
Address of buffer containing the device characteristics. This
information is used to set up the pseudoterminal's initial
characteristics. This buffer can be 12, 16, or 20 bytes long.
Figure D-1 shows the format of this buffer.
Figure D-1 Device Characteristics Buffer
buflen
| OpenVMS usage: |
word_unsigned |
| type: |
word (unsigned) |
| access: |
read only |
| mechanism: |
by value |
Length of the characteristics buffer (either 12, 16, or 20 bytes). This
argument is required if you supply the charbuff
argument.
astadr
| OpenVMS usage: |
ast_procedure |
| type: |
procedure value |
| access: |
call without stack unwinding |
| mechanism: |
by reference |
AST service routine to be executed when the terminal connection
deassigns the last channel to the pseudoterminal. This argument is the
procedure value of this routine. This is a repeating AST and is active
until the control connection deletes the pseudoterminal.
astprm
| OpenVMS usage: |
user_arg |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
AST parameter to be passed to the AST service routine specified by
astadr.
ast_acmode
| OpenVMS usage: |
access_mode |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
Access mode for which the AST is to be declared. The most privileged
access mode is the access mode of the caller. The resulting mode is the
access mode at which the AST is declared.
inadr
| OpenVMS usage: |
address_range |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by reference |
Address of a two-longword array containing the starting and ending
virtual addresses in the virtual address space of the process (either
P0 or P1 regions) to be used as I/O buffers. The array contains, in
order, the starting and ending virtual addresses. The addresses
supplied to inadr must express an integral number of
CPU-specific pages. The lower address must be on a CPU-specific page
boundary, and the higher address must be one less than a CPU-specific
page boundary. Together these addresses form a range from lowest to
highest bytes. The pages must already exist and must be fully contained
in either P0 or P1 space. All pages in the range must:
- Have identical page protection
- Be writable in the mode of the caller
- Be owned by the same access mode
- Be owned in a mode equal to or less privileged than the caller
- Be of the same page type (process or global)
Description
PTD$CREATE creates a new pseudoterminal with a unique device name. This
device name is in the form FTAn:, where n is the unit
number.
When a pseudoterminal is created, it inherits the current system
terminal default attributes unless you specify an alternate set of
characteristics.
Return Values
|
SS$_NORMAL
|
Normal successful completion.
|
|
SS$_ACCVIO
|
Unable to read one of the arguments.
|
|
SS$_BADPARAM
|
Bad parameter value.
|
|
SS$_EXBYTLM
|
Insufficient BYTLM to create device or map buffers.
|
|
SS$_EXQUOTA
|
Insufficient quota to create device.
|
|
SS$_EXASTLM
|
Insufficient AST quota for notification AST.
|
|
SS$_INSFMEM
|
Insufficient memory to create device.
|
|
SS$_INSFWSL
|
Insufficient working set limit to map buffers.
|
|
SS$_IVSECFLG
|
Invalid process or global section flags.
|
|
SS$_NOPRIV
|
No privilege for attempted operation.
|
|
SS$_PAGOWNVIO
|
Page owner violation.
|
|
SS$_VA_IN_USE
|
Virtual address already in use.
|