HP OpenVMS I/O User’s Reference Manual: OpenVMS Version 8.4 > Appendix D Control Connection Routines

D.3 PTD$DELETE — Delete a Pseudoterminal

Forces the pseudoterminal to be deleted and frees the channel.

D.3.1 Format

PTD$DELETE chan

D.3.2 Returns

OpenVMS usage:

longword (unsigned)

type:

write

access:

by value

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

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

D.3.5 Return Values

SS$_NORMAL

Normal successful completion.
SS$_DEVOFFLINEDevice is off line and request cannot proceed.
SS$_IVCHANIllegal channel.
SS$_NOPRIVInsufficient privilege to perform request.