IBM Support

MustGather: Collect Trouble Shooting Data for Read First/Fix List for Persistent Sessions for z/OS Communications Server

Troubleshooting


Problem

This technote was created to document all known maintenance required for users of persistent sessions, including Multi-Node Persistent Sessions (MNPS). This document replaces Information APARs II07798 and II10370.

Resolving The Problem

Table Of Contents


Section 1: General Persistent Sessions Information Section 2: Multinode Persistent Sessions (MNPS) Specific Information

Section 1: General Persistent Sessions Information
Single node persistent sessions applies to application failures only. If an application program fails or is brought down, VTAM can retain active sessions, allowing the same or another application to reconnect to the sessions, avoiding the need to re-establish the sessions. If an application fails, it can reconnect to the retained sessions when it recovers. Also another application program can take over the sessions.

Multi-node persistent sessions extends the support to allow a VTAM application to move to another VTAM. This move may be after a VTAM, operation system or hardware failure or the move may be a planned activity. The application can be restarted on an alternate VTAM and the application's sessions restored after a VTAM failure. The application can also restart on the same VTAM once VTAM has been restarted.

Persistent session problems have varied external symptoms such as : PSS hangs, ABEND0C4's because of a reference to a freed PST, or invalid data via data tracking in the CV29. If a user is utilizing VTAM's persistent session function, the following maintenance is recommended.

Back to top

Section 1.1: Recommended Maintenance
For any z/OS release, apply the highest level of ISTOCCPC available for the release.

Back to top

Section 2: Multinode Persistent Sessions (MNPS) Specific Information

For MNPS problems, the following documentation needs to be obtained:
I) VIT,MODE=EXT,OPTIONS=(CFS,HPR,PIU,MSG,SMS,NRM,SSCP,PSS)
II) Dump which includes VTAM and application address space, MNPS dataspace and all MNPS coupling facility structures being used.

NOTE: The coupling facility structures are included in the dump by specifying:
STRLIST=(STRNAME=IST.......,ACC=NOLIMIT,(LNUM=ALL,EDATA=SER,
ADJ=CAP))

To find the correct dataspace,enter D A,VTAM440 (or whatever your VTAM job name is) right after the recovery open. The recovery dataspace is the one at the top of the list.

Back to top

Section 2.1: Recommended Maintenance
For any z/OS release, apply the highest level of ISTOCCMO available for the release.

Back to top

[{"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"All","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"1.11;1.12;1.13;2.1;2.2;2.3","Edition":"All Editions","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Historical Number

II07798
II10370
II07772

Product Synonym

z/OS Communications Server

Document Information

Modified date:
22 June 2018

UID

swg21313305