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.
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.