2.1.2 Structure and Connection Disposition
The following section describes how a CF structure reacts to different events,
depending on the type of connection established with the exploiter.
You do not specify the structure and connection disposition attributes; they are
keywords specified by the requester.
2.1.2.1 Structure Disposition
When issuing the connection request through the IXLCONN macro, the requester
must specify several keywords. These define (among other things) the type of
structure (list, cache, or lock), the structure disposition (keep or delete), and the
requirement for a nonvolatile CF.
A structure disposition of keep indicates that even though there are no more
exploiters connected to the structure, because of normal or abnormal
disconnection, the structure is to remain allocated in the CF processor storage.
A structure disposition of delete implies that as soon as the last connected
exploiter disconnects from the structure, the structure is deallocated from the CF
processor storage.
To manually deallocate a structure with a disposition of delete, you have to
disconnect all exploiters from the structure. An example of such a process is
deallocating the XCF signalling structure. This can be achieved by stopping the
PIs (PATHIN) and POs (PATHOUT) in every member of the sysplex; you can do
this using the following SETXCF operator commands:
RO *ALL,SETXCF STOP,PI,STRNM=xcf_strname
RO *ALL,SETXCF STOP,PO,STRNM=xcf_strname
To deallocate a structure with a disposition of keep, you have to force the
structure out of the CF by the SETXCF FORCE command.
Notes:
1. A structure with active or failed-persistent connections cannot be
deallocated. The connections must be put in the undefined state first. See
2.1.2.2, “Connection State and Disposition.”
2. A structure with a related dump still in the CF dump space cannot be
deallocated. The dump has to be deleted first.
3. Because of the risk of data loss, care must be taken when using the SETXCF
FORCE command. All consequences must be well understood before issuing
this command.
2.1.2.2 Connection State and Disposition
A connection is the materialization of a structure exploiter's access to the
structure. The connection is in one of three states:
Undefined
means that the connection is not established.
Active
means that the connection is being currently used.
Failed-persistent
means that the connection has abnormally terminated but is
logically remembered, although it is not physically active.
66
Parallel Sysplex Configuration, Volume 2: Cookbook

Get OS/390 Parallel Sysplex Configuration, Volume 2: Cookbook now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.