Request and response exchanges for typical communication operations

This appendix contains diagrams that show the sequences in which requests and responses are exchanged to perform typical data communication operations using VTAM®. The diagrams can be useful in coding application programs that perform the operations.

Note: A PLU application program is a VTAM application program that acts as the PLU in the session, and an SLU application program is a VTAM application program that acts as the SLU in the session.

Figure 1 through Figure 21 are oriented primarily toward communication between a PLU application program and a device-type logical unit, although some of these diagrams apply also when the SLU is a SLU application program. In Figure 1 through Figure 21, the “reads” and “writes” shown in the “Logical Unit” column represent logic that can be performed by a control program in the logical unit, a user-written program that operates in the logical unit, or both. It is a general representation of the input and output from the logical unit. The PLU application program's side of the exchange is shown in more detail.

Figure 22 through Figure 36 are oriented toward operations between a PLU application program and a SLU application program.

Figure 37 and Figure 38 illustrate a session between the VTAM SSCP and an application program over the CNM interface.

In any diagram showing a negative response being sent to an application program, a SYNAD exit routine might be scheduled with an exception condition return code. SYNAD exit routines are not illustrated in this appendix. See Coding LERAD and SYNAD exit routines for details.
Figure 1. Device-type LU initiates and establishes a session with a PLU application program.
The diagram shows the process of how a device-type LU initiates and establishes a session with a PLU application program.
For initiating and establishing a session from a SLU application program, see Figure 22 and Figure 23.
Figure 2. PLU application program acquires (initiates and establishes) a session with a device-type LU.
The diagram shows the process of how a PLU application program initiates and establishes a session with a device-type LU.
For initiating a session from a PLU to a SLU application program, see Figure 24 and Figure 25.
Figure 3. After a warm start, a PLU application program reestablishes a session and resynchronizes sequence numbers (Part 1 of 2)
These diagrams show the process of how a PLU application program reestablishes a session and resynchronizes sequence numbers after a warm start.
Figure 4. After a warm start, a PLU application program reestablishes a session and resynchronizes sequence numbers (Part 2 of 2)
These diagrams show the process of how a PLU application program reestablishes a session and resynchronizes sequence numbers after a warm start.
Figure 5. PLU application program and a secondary logical unit exchange data (Part 1 of 3)
These diagrams show the process of how a PLU application program and a secondary logical unit exchange data through VTAM and request/response flow.
Figure 6. PLU application program and a secondary logical unit exchange data (Part 2 of 3)
These diagrams show the process of how a PLU application program and a secondary logical unit exchange data through VTAM and request/response flow.
Figure 7. PLU application program and a secondary logical unit exchange data (Part 3 of 3 about sections A, B, C and D)
These diagrams show the process of how a PLU application program and a secondary logical unit exchange data through VTAM and request/response flow.
A
With no responses
B
With negative responses only if an exception occurs
C
With definite response 1 (positive or negative)
D
With definite responses 1 and 2 sent at the same time.
Figure 8. Logical unit sends a chain of data to the PLU application program
These diagrams show the process of how a logical unit sends a chain of data to the PLU application program through VTAM and request/response flow.
A
Without a negative response
B
With a negative response.
Figure 9. Application program and logical unit use quiesce protocol
The diagram shows the process of how an application program and logical unit use quiesce protocal through VTAM and request/response flow.
A
The application program quiesces the logical unit
B
The logical unit quiesces the application program.
Figure 10. Application program and logical unit use bracket protocol (Part 1 of 2)
These diagrams show the process of how an application program and a logical unit use bracket protocol through VTAM and request/response flow.
Figure 11. Application program and logical unit use bracket protocol (Part 2 of 2)
These diagrams show the process of how an application program and a logical unit use bracket protocol through VTAM and request/response flow.
A
Where the logical unit begins the bracket
B
Where the PLU application program begins the bracket
C
Where the PLU application program gets a positive response to its BID and begins the bracket
D
Where BID produces a later Ready-to-Receive request.

For more details on using brackets with a SLU application program, see Figure 28 and Figure 29.

Figure 12. Application program and logical unit use change-direction protocol
These diagrams show the process of how an application program and a logical unit use change-direction protocol through VTAM and request/response flow.
A
Where only change-direction indicators are used
B
Where in addition, the Signal request (requesting change direction) is used.
Figure 13. PLU application program resynchronizes sequence numbers with the logical unit.
The diagram shows the process of how a PLU application program resynchronizes sequence numbers with the logical unit through VTAM and request/response flow.

For resynchronization of sequence numbers between PLU and SLU application programs, see Figure 26 and Figure 27. For the dialog between the PLU application program and the logical unit to establish sequence numbers, see steps 2–9 in Figure 3 and Figure 4. (Use STSN and any dialog at your own discretion.)

Figure 14. Application program and logical unit use the signal request
The diagram shows the process of how an application program and a logical unit use the signal request through VTAM and request/response flow.
A
Sent by the logical unit
B
Sent by the PLU application program.
Figure 15. Application program and logical unit use the LUSTAT request
The diagram shows the process of how an application program and a logical unit use the LUSTAT request through VTAM and request/response flow.
A
Sent by the logical unit
B
Sent by the application program.
Figure 16. Operations are shut down in an orderly fashion
The diagram shows the process of how operations are shut down in an orderly fashion through VTAM and request/response flow.
A
The logical unit requests shutdown
B
The PLU application program orders shutdown.
Figure 17. Logical unit terminates a session.
The diagram shows the process of how a logical unit terminates a session through VTAM and request/response flow.

For termination requests from a SLU application program, see Figure 30 and Figure 31.

Figure 18. PLU application program terminates a session with the logical unit.
The diagram shows the process of how a PLU application program terminates a session with the logical unit through VTAM and request/response flow.

For session termination of a SLU application program, see Figure 30, Figure 31, Figure 32, and Figure 33.

Figure 19. PLU application program terminates a session with the logical unit with a CLSDST OPTCD=PASS
The diagram shows the process of how a PLU application program terminates a session with the logical unit with a CLSDST OPTCD=PASS through VTAM and request/response flow.
Figure 20. PLU application program and a device-type logical unit use cryptography in a required cryptographic session
The diagram shows the process of how a PLU application program and a device-type logical unit use cryptography in a required cryptographic session through VTAM and request/response flow.
A
Where cryptography is specified on the SEND
B
Where no cryptography is specified on the SEND.
Figure 21. PLU application program and a device-type logical unit use cryptography in a selective cryptographic session
The diagram shows the process of how a PLU application program and a device-type logical unit use cryptography in a selective cryptographic session through VTAM and request/response flow.
A
Where cryptography is specified on the RECEIVE
B
Where no cryptography is specified on the RECEIVE.
Figure 22. SLU application program requests a session with the PLU application program (Part 1 of 2)
The diagram shows the process of how a SLU application program requests a session with the PLU application program through VTAM and request/response flow.
Figure 23. SLU application program requests a session with the PLU application program (Part 2 of 2)
The diagram shows the process of how a SLU application program requests a session with the PLU application program through VTAM and request/response flow.
Figure 24. PLU application program acquires (initiates and establishes) a session with the SLU application program
The diagram shows the process of how a PLU application program acquires (initiates and establishes) a session with the SLU application program through VTAM and request/response flow.
Figure 25. PLU application program issues a SIMLOGON to acquire (initiate a session with) the SLU application program
The diagram shows the process of how a PLU application program issues a SIMLOGON to acquire (initiate a session with) the SLU application program through VTAM and request/response flow.
Figure 26. PLU application program resynchronizes sequence numbers with the SLU application program (Part 1 of 2)
The diagram shows the process of how a PLU application program resynchronizes sequence numbers with the SLU application program through VTAM and request/response flow.
Figure 27. PLU application program resynchronizes sequence numbers with the SLU application program (Part 2 of 2)
The diagram shows the process of how a PLU application program resynchronizes sequence numbers with the SLU application program through VTAM and request/response flow.
Figure 28. PLU application program and SLU application program use bracket protocol
The diagram shows the process of how a PLU application program and an SLU application program use bracket protocol through VTAM and request/response flow
Figure 29. PLU application program and SLU use-bracket protocol: BID by PLU rejected but Ready-to-Receive follows
The diagram shows the process of how a PLU application program and an SLU use-bracket protocol: BID by PLU rejected but Ready-to-Receive follows through VTAM and request/response flow.
Figure 30. SLU application program sends a conditional request for session termination
The diagram shows the process of how an SLU application program sends a conditional request for session termination through VTAM and request/response flow.
Figure 31. SLU application program sends an unconditional request for session termination
The diagram shows the process of how an SLU application program sends an unconditional request for session termination through VTAM and request/response flow.
Figure 32. SLU application program sends a Request Shutdown request
The diagram shows the process of how an SLU application program sends a Request Shutdown request through VTAM and request/response flow.
Figure 33. PLU application program shuts down the SLU application program
The diagram shows the process of how a PLU application program shuts down the SLU application program through VTAM and request/response flow.
Figure 34. PLU application program and the SLU application program use cryptography in a required cryptographic session
The diagram shows the process of how a PLU application program and an SLU application program use cryptography in a required cryptographic session through VTAM and request/response flow.
Figure 35. PLU application program and the SLU application program use cryptography in a selective cryptographic session
The diagram shows the process of how a PLU application program and an SLU application program use cryptography in a selective cryptographic session through VTAM and request/response flow.
Figure 36. PLU application program stops bracket initiation
The diagram shows the process of how a PLU application program stops bracket initiation through VTAM and request/response flow.
Figure 37. Application program receives a load request during physical unit activation (Part 1 of 2)
The diagram shows the process of how an application program receives a load request during physical unit activation through VTAM and request/response flow.
Figure 38. Application program receives a load request during physical unit activation (Part 2 of 2)
The diagram shows the process of how an application program receives a load request during physical unit activation through VTAM and request/response flow.
Figure 39. PLU application program acquires (initiates and establishes) a session with an XRF backup-session service-type LU.
The diagram shows the process of how a PLU application program acquires (initiates and establishes) a session with an XRF backup-session service-type LU through VTAM and request/response flow.

For initiating a session from a PLU to a SLU application program, see Figure 24 and Figure 25.

Figure 40. PLU application program acquires (initiates and establishes) a session with an XRF backup-session device-type LU.
The diagram shows the process of how a PLU application program acquires (initiates and establishes) a session with an XRF backup-session device-type LU through VTAM and request/response flow.

For initiating a session from a PLU to a SLU application program, see Figure 24 and Figure 25.

Figure 41. PLU application program issues SIMLOGON to acquire (initiate and establish) an XRF session with a device-type LU.
The diagram shows the process of how a PLU application program issues SIMLOGON to acquire (initiate and establish) an XRF session with a device-type LU through VTAM and request/response flow.

For initiating a session from a PLU to a SLU application program, see Figure 24 and Figure 25.

Figure 42. PLU application program issues SIMLOGON to acquire (initiate and establish) an XRF session with a device-type LU.
The diagram shows the process of how a PLU application program issues SIMLOGON to acquire (initiate and establish) an XRF session with a device-type LU through VTAM and request/response flow.

For initiating a session from a PLU to a SLU application program, see Figure 24 and Figure 25.

Figure 43. Device-type LU initiates and establishes a session with an XRF primary-PLU application program.
The diagram shows the process of how a device-type LU initiates and establishes a session with an XRF primary-PLU application program through VTAM and request/response flow.

For initiating and establishing a session from a SLU application program, see Figure 22 and Figure 23.

Figure 44. Switch without XRF primary failing first
The diagram shows the process of how an XRF primary application program is switched to an XRF backup application program without XRF primary failing firstthrough VTAM and request/response flow.
Figure 45. Switch after XRF primary fails
The diagram shows the process of how an XRF primary application program is switched to an XRF backup application program after XRF primary fails through VTAM and request/response flow.
Figure 46. Normal XRF primary end of session
The diagram shows the process of a normal XRF primary end of session through VTAM and request/response flow .
Figure 47. Normal XRF backup end of session with XRF primary
The diagram shows the process of a Normal XRF backup end of session with XRF primary through VTAM and request/response flow.