Example of retrieving information for a mode and any restored sessions

The example in this appendix shows how to examine or process information returned by the APPCCMD CONTROL=OPRCNTL, QUALIFY=RESTORE macroinstruction. VTAM® returns this information to the user in the data area provided for it.

The user can retrieve LU-mode table information (NOSESS), LU-mode table and session information (ALL), or no information (NONE). The application program specifies the type of information returned using the LIST keyword in the APPCCMD CONTROL=OPRCNTL, QUALIFY=RESTORE macroinstruction. Use of the LU name and logon mode parameters also affects the modes restored. For more information on restoring a mode, see Restoring modes and any associated persistent LU-LU sessions. For more information about the RESTORE APPCCMD, refer to z/OS Communications Server: SNA Programmer's LU 6.2 Reference. See Retrieving information for a mode and sessions to be restored for a description of the RESTORE control block. Information is returned for each mode and session that is restored, if requested.

The data area can contain information for more than one LU-mode, as determined by the scope of the request and the size of the data area. The RESTORE structure (ISTSREST) for each LU-mode entry contains the following pointers:

SRESLDAD points to the session limits data structure (ISTSLD) for that LU-mode.
SRESESAD points to the session information structure (SRESESS) for the first session being restored for that LU-mode, if any.
SRENXTAD points to the ISTSREST for the next LU-mode to be restored, if any.

Each session information structure points to the information for the next session being restored for that LU-mode, if any (SRESNXTA). Figure 1 shows an example of how this structure might look when LIST=ALL is specified.

Figure 1. Information for three LU-modes

Diagram that shows the information about three LU-modes.

LU-mode 1 has two sessions associated with it, which are restored. LU-mode 2 has no sessions associated with it, and LU-mode 3 has at least one session associated with it. Only one session associated with LU-mode 3 has been restored. LU-mode 3 might have more sessions that need to be restored. If it does, the mode restored flag (SREMDRS) is set OFF.

If the data area does not have enough space to hold the information that is requested, any remaining sessions and modes are not restored until the application program issues another APPCCMD CONTROL=OPRCNTL, QUALIFY=RESTORE macroinstruction. If LIST=NOSESS is specified, the session information is not returned. If LIST=NONE is specified, no information is returned.