HP OpenVMS I/O User's Reference Manual

Control Connection Routines

PDT$CREATE Create a Pseudoterminal

PDT$READ Read Data from Pseudoterminal

PDT$DELETE -- Delete a 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 frees the channel assigned to the pseudoterminal. When a pseudoterminal is deleted, any process using the pseudoterminal (except the control program) is disconnected. A PTD$DELETE request causes any pending I/O for the control program to be aborted. It deletes any queued event notification ASTs and returns the I/O buffers back to the application. It also causes the pseudoterminal unit control block (UCB) to be deleted once the reference count returns to zero.

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.

PDT$CREATE Create a Pseudoterminal

PDT$READ Read Data from Pseudoterminal