PWRIT

Transfers data from a master program to a slave program.

PWRIT(pcb,err,buf,len,tag)

pcb

PTOP control block.

(input/output)

 

err

16-bit integer. Error return.

buf

Data buffer. An array of a size equal to or greater than the

 

value of the len parameter.

len

16-bit integer. Data length in words. A positive decimal

 

value that declares the actual length of data being transferred to

 

the slave for the PWRIT request. This value is passed to the il

 

parameter in the slave's GET call as an indication of how much

 

data to expect from the master. A maximum of 4096 words may

 

be transferred between an HP 1000 and another HP 1000, or

 

between an HP 1000 master program and an HP 3000 slave

 

program.

 

The maximum number of words transferred between an

 

HP 3000 master program and an HP 1000 slave program

 

depends on which size buffer module was appended to the

 

request and reply converts (RQCNV and RPCNV). Maximum is

 

4096 words.

 

Between the 1000 and the 3000, a negative length may be used

 

to indicate the length is in bytes. When an odd number of bytes

 

are to be transferred, an extra byte is appended to the end of

 

the data.

tag

Tag field.

(input/output)

 

PCONT

Provides for the exchange of a tag field between a master and a slave program.

PCONT(pcb,err,tag)

pcb

PTOP control block.

(input/output)

 

err

16-bit integer. Error return.

tag

Tag field.

(input/output)

 

PCLOS

Called from a master program to terminate a slave program. If the slave resides on an HP 1000 node, logical communication is also terminated.

PCLOS(pcb,err)

pcb

PTOP control block.

(input/output)

 

err

16-bit integer. Error return.

124 ProgramtoProgram Communication (PTOP)