(Output from DESCRIBE, RECEIVE, REPLY, TESTCMPL)
(Reflected in these IUCV external interrupts: pending message, mes­
sage complete.)
As an input, this field specifies the length of the input buffer
(IPBFADR2 field). The label IPBFLN2 is used by the IUCV macro
whenever a halfword value is desired, and IPBFLN2F is used whenev­
er a fullword value is desired. The high-order half word of the
IPBFLN2F 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 reply area
in this field.
For RECEIVE, IUCV stores the actual length of the reply area in
this field.
For REPLY, 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 (the amount that the
buffer exceeded the length of the data) in this field and IUCV sets
a return code of O. If the buffer was too short, the 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).
For TEST COMPLETION, 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
(the amount that the buffer exceeded the length of the data) in
this field and IUCV sets a return code of O. If the buffer was too
short, IUCV stores the residual count in this field (the number of
bytes remaining in the message that would not fit into the buffer)
and sets the IP ADRPLE bit in the audit trail. On an external interrupt, this field contains the actual length of the
reply or reply area.
For a complete message external interrupt, 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
(the amount that the buffer exceeded the length of the data) in this
field and IUCV sets a return code of O. If the buffer was too short, IUCV stores a residual count in this field (that is, the number of bytes
remaining in the message that would not fit into the buffer) and sets
the IP ADRPLE bit in the audit trail.
IPFCNCD (Input to CONNECT) (Reflected in the pending-connection IUCV external interrupt.)
As an input, this field indicates which CP system service is invoking
the CONNECT function. Each supported CP service is identified by Inter-User Communications Vehicle 163
a one-byte numerical code. VM/SP presently supports IUCV com­
munication for only one CP service, SNA virtual console communi­
cation services. SNA has a code of zero. On an external interrupt, this field is valid only when the IUCV func­
tion is invoked from CP system code. (The IPVMID field contains 'SYSTEM'.) IPFLAGSI (Input to ACCEPT, CONNECT, PURGE, QUIESCE, RECEIVE,
REJECT, REPLY, RESUME, SEND, SEVER, TESTCMPL) (Output from ACCEPT, CONNECT, DESCRIBE, SEND, RECEIVE, REPLY, PURGE, TESTCMPL) (Reflected in these IUCV external interrupts: pending connection,
connection complete, pending message, message complete.)
As an input, this field specifies options for the function requested. As
output or on an external interrupt, this field returns specific inform a- . tion about the message or connection. Each bit is treated separately.
Bits not defined as input for a particular function are reserved for that
function and should be set to zero.
IPRMDATA (X'80') (Input to ACCEPT, CONNECT, SEND, REPLY) (Output from DESCRIBE, RECEIVE, TESTCMPL) As an input, or a connection-pending or connection-complete external
interrupt, this bit set to 1 indicates the communicator is prepared to
handle messages using the DAT A=PRMMSG option.
When used with a SEND, a REPLY, a message-pending external
interrupt, or message-complete external interrupt, this bit set to 1 indi­
cates that the buffer/parmlist contains the message data in the IPRMMSGx fields.
IPFGMCL (X'OI ')
164 VM/SP System Programmer's Guide
(Input to PURGE, RECEIVE, REJECT, TESTCMPL) (Output from DESCRIBE, RECEIVE)
As an input, .this bit indicates that a message class (source message
class for PURGE and TESTCMPL, target message class for
RECEIVE and REJECT) has been specified in field IPSRCCLS or
IPTRGCLS. This bit is set by the IUCV macro when the SRCCLS= or TRGGCLS= parameter is specified on the macro. IUCV sets this bit to 1 as output from the DESCRIBE function so the
resulting parameter list is valid input to the next function (normally
RECEIVE or REJECT).
Previous Page Next Page