z/OS Communications Server: SNA Programming
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Application program recovery with multinode persistence enabled

z/OS Communications Server: SNA Programming
SC27-3674-00

Multinode persistent sessions is used to facilitate session recovery after a node failure. It can also be used to move applications to another VTAM® in the event of an application failure or as part of an MNPS takeover. The application can recover on the same VTAM (if that VTAM is restarted) or any other VTAM that is part of the sysplex and that is connected to the MNPS coupling facility structure. Refer to z/OS Communications Server: SNA Network Implementation Guide for complete information about setting up a sysplex that supports multinode persistent sessions.

Note: If both session partners are on the same VTAM prior to node failure, the sessions will not be recovered. If the application recovers on the same VTAM as its session partner, those sessions will be terminated.

For an application to be capable of multinode persistent sessions, PERSIST=MULTI must be coded on the APPL definition statement for this application progam. There are no differences in the programming interface for applications using single-node or multinode persistent sessions, with one exception. For both functions, the application must enable persistence as described in How an application establishes persistence, and for both functions the application can indicate support of forced takeover processing by using the SETLOGON OPTCD=PERSIST macroinstruction. The exception in the interfaces between the two types of persistence is that in order to initiate MNPS forced takeover, an application needs to specify an additional parameter on the ACB macroinstruction, as described in Response to an application failure with MNPS.

If one of the following operator commands is issued prior to a node failure, multinode persistent sessions support is overridden:
  • HALT QUICK
  • Normal HALT
  • VARY INACT, TYPE=FORCE, ID=appl_name, where appl_name is the name of a persistence-enabled application.
A HALT CANCEL command does not override multinode persistent sessions and the session remain recoverable.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014