HP OpenVMS I/O User's Reference Manual

Control Connection Routines

PDT$READW Read Data from Pseudoterminal and Wait

PDT$WRITE Write Data to Pseudoterminal

PDT$SET_EVENT_NOTIFICATION -- Enableor Disable Terminal Event Notification ASTs 

Format 

PDT$SET_EVENT_NOTIFICATION chan, astadr [,astprm] [,acmode], type

Returns 

OpenVMS usage:
		longword (unsigned)
type :		write only
access:		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.

astadr 

OpenVMS usage:
		ast_procedure
type :		procedure value
access:		call without stack unwinding
mechanism:		by reference

Address of the notification AST service routine, or zero ifthe AST is to be canceled.

astprm 

OpenVMS usage:
		user_arg
type :		longword (unsigned)
access:		read only
mechanism:		by value

AST parameter to be passed to the AST service routine specifiedby the astadr argument.

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 mostprivileged access mode is the access mode of the caller. The resultingmode is the access mode at which the AST is declared.

type 

OpenVMS usage:
		type_longword
type :		longword (unsigned)
access:		read only
mechanism:		by value

Value that indicates which notification AST to enable. The$PTDDEF macro defines the symbolic names listed in Symbolic Names Defined by $PTDDEF Macro.

Table 2   Symbolic Names Defined by $PTDDEF Macro

Symbolic Name	Description
PTD$C_SEND_XON	Deliver notification ASTwhen the pseudoterminal is ready to accept input. This AST is notdelivered if the pseudoterminal is set to NO HOSTSYNC.
PTD$C_SEND_BELL	Deliver notification ASTwhen the pseudoterminal wants to stop input and signal it with abell character.
PTD$C_SEND_XOFF	Deliver notification ASTwhen the pseudoterminal wants to stop input and signal it with aDC3 character.
PTD$C_STOP_OUTPUT	Deliver notification ASTwhen the pseudoterminal is stopping output.
PTD$C_RESUME_OUTPUT	Deliver notification ASTwhen the pseudoterminal is resuming output.
PTD$C_CHAR_CHANGED	Deliver notification ASTwhen the pseudoterminal has changed some device characteristic.
PTD$C_ABORT_OUTPUT	Deliver notification ASTwhen the pseudoterminal wants to abort output.
PTD$C_START_READ	Deliver notification ASTwhen the pseudoterminal is starting an application's read request.This AST is delivered only if read event notification has been enabled.
PTD$C_MIDDLE_READ	Deliver notification ASTwhen the pseudoterminal has finished sending an application's readrequest prompt string. This AST is delivered only if read eventnotification has been enabled.
PTD$C_END_READ	Deliver notification ASTwhen the pseudoterminal has finished an application's read request.This AST is delivered only if read event notification has been enabled.
PTD$C_ENABLE_READ	Enable terminal read eventAST delivery. If this code is used, you cannot supply the astadr argument.
PTD$C_DISABLE_READ	Disable terminal read event AST delivery.If this code is used, you cannot supply the astadr argument.

Description 

PTD$SET_EVENT_NOTIFICATION enables or disables the repeatingterminal event notification ASTs listed in Symbolic Names Defined by $PTDDEF Macro. After an event notification AST is enabled, itremains in effect until it is disabled or until the device is deleted.

ReturnValues 

SS$_NORMAL	Normal successful completion.
SS$_ACCVIO	Unable to read an argument, or invalid I/O bufferaddress.
SS$_BADPARAM	An astadr, astprm, or acmode argument wasnot zero when enabling or disabling r3ad notification.
SS$_DEVOFFLINE	Device is off line and request cannot proceed.
SS$_EXASTLM	Insufficient AST quota for notification AST.
SS$_INSFMEM	Insufficient memory.
SS$_IVCHAN	Illegal channel.
SS$_NOPRIV	Insufficient privilege to perform request.

PDT$READW Read Data from Pseudoterminal and Wait

PDT$WRITE Write Data to Pseudoterminal