Parameter List and External Interrupt Fields
The following paragraphs define the fields of the IUCV parameter lists and
external interrupts. Not every field has meaning for every function. This section
explains, for each field, the functions for which this field is valid, and the meaning
or use of the field.
IPAUDIT (Output from PURGE, TESTCMPL)
(Reflected in the message-complete IUCV external interrupt) IUCV returns the audit trail of the message in this field. If no message
was found, this field is not modified. One output of the TEST COM­ PLETION function, occurs when this field contains any nonzero bits.
In this case, a condition code of 3 is set. This indicates that lUCY has
stored a nonzero audit trail.
The meanings of the bits in the audit trail are:
IPADRPLE
IPADSNPX
IPADSNAX
IPADANPX
IPADANAX
IPADRJCT
IPADPRMD X'8000' X'4000' X'2000' X'lOOO' X'0800' X'0400' X'0200' Reply too long for buffer
Protection exception on send buffer
Addressing exception on send buffer
Protection exception on answer buffer
Addressing exception on answer buffer
Message was rejected
Reply data was specified using DAT A=PRMMSG
and originator did not allow this option.
IPADRCPX
IPADRCAX
IPADRPPX
IPADRPAX
IPADSVRD X'OlOO' X'0080' X'0040' X'0020' X'OOlO' X'0008' X'0004' X'0002' X'OOOl' Reserved
Protection exception on receive buffer
Addressing exception on receive buffer
Protection exception on reply buffer
Addressing exception on reply buffer
Path was severed
Reserved
Reserved
Reserved
IPBFADRI (Input to DCLBFR, RECEIVE, SEND) (Output from RECEIVE)
This field specifies the address of the area to contain the text of the
message or the area to be used for storing IUCV external interrupt
information.
As input to SEND, this field identifies the area from which IUCV
takes the message text.
As input to RECEIVE, this field identifies the area into which IUCV places the message text.
As input to DCLBFR, this field identifies the area into which lUCY stores information concerning an IUCV external interrupt.
Inter-User Communications Vehicle 161

The contents of this field are updated by the RECEIVE function.
When the function is finished, the address has been increased by the
length of the data received.
IPBFADR2 (Input to REPLY, SEND) IPBFLNI IPBFLN2
162 VM/SP System Programmer's Guide (Output from REPLY)
This field specifies the address of the area to contain the reply text of
the message.
As input to SEND, this field identifies the area into which IUCV places the reply text.
As input to REPLY, this field identifies the area from which IUCV takes the reply text.
The REPLY function updates the contents of this field. REPLY
increases the buffer address by the length of the REPLY moved. IPBFLNIF (Input to RECEIVE, SEND) (Output from DESCRIBE, RECEIVE)
(Reflected in the pending-message IUCV external interrupt)
As an input, this field specifies the length of the input buffer (IPBFADRI field). The label IPBFLNI is used by the IUCV macro
whenever a halfword value is desired, and IPBFLNIF is used whenev­
er a fullword value is desired. The high-order halfword of the IPBFLNIF field is cleared to zeros by the IUCV macro when
halfword values are desired. If the macro is not used, it is the user's
responsibility to clear this field when using halfword lengths.
As an output, this field indicates the length of the message as follows:
For DESCRIBE, IUCV stores the actual length of the message in
this field.
For RECEIVE, if the buffer was exactly the correct length, IUCV stores a zero in this field. If the buffer was too long, IUCV stores
the number of bytes remaining in the buffer (that is, the amount
that the buffer exceeded the length of the data) in this field; IUCV sets a return code of O. If the buffer was too short, IUCV stores the residual count in this field (that is, the number of bytes
remaining in the message that would not fit into the buffer) and IUCV sets a nonzero return code.
When an external interrupt occurs, this field contains the actual length
of the message.
IPBFLN2F (Input to REPLY, SEND)