HP OpenVMS I/O User's Reference Manual

Control Connection Routines

PDT$SET_EVENT_NOTIFICATION Enable or Disable Terminal Event...

PDT$WRITE -- WriteData to Pseudoterminal  

Format 

PDT$WRITE chan [.astadr] [,astprm] wrtbuf, wrtbuf_len [,echobuf]           [,echobuf_len]

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

AST service routine to be executed when PTD$READ completes.If you specify astadr, the ASTroutine executes at the same access mode as the caller of the PTD$WRITEroutine.

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.

wrtbuf 

OpenVMS usage:
		char_string
type :		character coded text string
access:		write only
mechanism:		by reference

Address of the read I/O status longword. The first characterposition in an I/O buffer to receive all output is this addressplus 4. The wrtbuf argument mustbe in the range specified in the inadr argumentof the PTD$CREATE routine; otherwise, an SS$_ACCVIO status is returned.

wrtbuf_len 

OpenVMS usage:
		word_unsigned
type :		word (unsigned)
access:		read only
mechanism:		by value

Number of characters to be written to the pseudoterminal.These characters appear as input to the terminal side of the pseudoterminal.

echobuf 

OpenVMS usage:
		char_string
type :		character coded text string
access:		write only
mechanism:		by reference

Address of the echo I/O status longword. The first characterposition in an I/O buffer to receive all output is this addressplus 4. The echobuf must be inthe range specified by the inadr argumentof the PTD$CREATE routine; otherwise an SS$_ACCVIO status is returned.

wrtbuf_len 

OpenVMS usage:
		word_unsigned
type :		word (unsigned)
access:		read only
mechanism:		by value

Number of characters that can be read from the pseudoterminal.If an echo buffer is specified, up to echobuf_len characterscan be stored in it.

Description 

PTD$WRITE inputs data to the pseudoterminal and reads anyimmediately echoed characters. PTD$WRITE allows you to specify abuffer to receive any output generated by the write; you do notneed to issue a separate read request to read this data.

ReturnValues 

SS$_NORMAL	Normal successful completion.
SS$_ACCVIO	Unable to read an argument, or invalid read bufferaddress.
SS$_DATALOST	The terminal driver type-ahead buffer is full andcharacter written was lost.
SS$_DATEAOVERUN	The terminal type-ahead buffer is getting full;attempts to send more data might result in loss of characters.
SS$_DEVOFFLINE	Device is off line and request cannot proceed.
SS$_EXASTLM	Insufficient AST quota for notification AST.
SS$_INSFMEM	Insufficient memory.
SS$_IVBUFLEN	Buffer size supplied is illegal.
SS$_IVCHAN	Illegal channel.
SS$_NOPRIV	Insufficient privilege to perform request.

PDT$SET_EVENT_NOTIFICATION Enable or Disable Terminal Event...