HP OpenVMS I/O User's Reference Manual

Control Connection Routines

PDT$CREATE Create a Pseudoterminal

PDT$READ Read Data from Pseudoterminal

PDT$DELETE -- Deletea Pseudoterminal  

Format 

PDT$DELETE chan

Returns 

OpenVMS usage:
		longword (unsigned)
type :		write
access:		by value

Argument 

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.

Description 

PTD$DELETE forces the pseudoterminal to be deleted and freesthe channel assigned to the pseudoterminal. When a pseudoterminalis deleted, any process using the pseudoterminal (except the controlprogram) is disconnected. A PTD$DELETE request causes any pendingI/O for the control program to be aborted. It deletes any queuedevent notification ASTs and returns the I/O buffers back to theapplication. It also causes the pseudoterminal unit control block(UCB) to be deleted once the reference count returns to zero.

ReturnValues 

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.

PDT$CREATE Create a Pseudoterminal

PDT$READ Read Data from Pseudoterminal