RETRIEVE BUFFER - Use the RETRIEVE BUFFER function to terminate
all outstanding messages and communications paths, and to endIUCV comĀ
munications.CP system code (outside IUCV support) cannot use the
RETRIEVE BUFFER function.
Virtual Machine to Virtual Machine Communication
Figure 16 illustrates the sequence of functions invoked when a virtual machine
communicates with another virtual machine. The functions include initialization,
connection to another virtual machine, sending and receiving messages, replying to
and waiting for messages, severing communications with the other virtual machine,
and termination.
Virtual Machine X Communicating to Virtual MachineY (VIRTUAL MACHINE X)
1 DECLARE BUFFER
2CONNECT to Y
5 Get External Interrupt
6 SEND to Y
8 TESTCOMPLETION 11 Get External Interrupt fori TEST COMPLETION 12 SEVER
15 RETRIEVE BUFFER
Figure 16. Sequence of Functions
(VIRTUAL MACHINEY) 1 DECLARE BUFFER
3 Get External Interrupt
4 ACCEPT
7 Get External Interruptfori DESCRIBE
9 RECEIVE10 REPLY 13 Get External Interrupt
14 SEVER
15 RETRIEVE BUFFER
1. Virtual machine X wishes to communicate with virtual machine Y. Both virtual
machines must independently invoke the DECLARE BUFFER function. The
buffer is used to provide the virtual machine with information about incoming
external interrupts concerningIUCV functions.
2. Virtual machine X invokes theCONNECT function, indicating Y as the target. IUCV checks the directory to determine if this connection is authorized. If it
is,IUCV queues an external interrupt for Y indicating that there is a pending
connection for it.IUCV returns control to X at the next instruction after the CONNECT; a return code indicates that a partial connection has been estabĀ
lished.
Inter-User Communications Vehicle 123
all outstanding messages and communications paths, and to end
munications.
RETRIEVE BUFFER function.
Virtual Machine to Virtual Machine Communication
Figure 16 illustrates the sequence of functions invoked when a virtual machine
communicates with another virtual machine. The functions include initialization,
connection to another virtual machine, sending and receiving messages, replying to
and waiting for messages, severing communications with the other virtual machine,
and termination.
Virtual Machine X Communicating to Virtual Machine
1 DECLARE BUFFER
2
5 Get External Interrupt
6 SEND to Y
8 TEST
15 RETRIEVE BUFFER
Figure 16. Sequence of Functions
(VIRTUAL MACHINE
3 Get External Interrupt
4 ACCEPT
7 Get External Interrupt
9 RECEIVE
14 SEVER
15 RETRIEVE BUFFER
1. Virtual machine X wishes to communicate with virtual machine Y. Both virtual
machines must independently invoke the DECLARE BUFFER function. The
buffer is used to provide the virtual machine with information about incoming
external interrupts concerning
2. Virtual machine X invokes the
is,
connection for it.
lished.
Inter-User Communications Vehicle 123