The structure definition information section represents an entry
for each WLM structure that is supported by the Coupling Facility
Manager. The following appears under this header:
- Global Information
- The global information area represents global data that is common
to all structure definitions.
- Size Of Structure Definition Header
- Size of the header area for the structure definitions (IWMCFSD
header size)
- Size Of Whole Structure Definition
- Size of the whole structure definition area (IWMCFSD) that includes
the header area and each structure entry.
- Version
- Version number of the structure definition. The version is 1.
- Number Of Structures
- The number of structure entries that exist. The number is 1.
- Level Information
- A structure area (CFSD) version number that contains information
defining the functionality level of the current Coupling Facility
Manager support. Currently only 1 byte is used and the other 7 bytes
are reserved.
- Version Number
- Represents the current Coupling Facility Manager functionality
level. The level cfsd_functionality_level_jbb6609 is assigned, which
is a value of 8.
- Structure
- Defines the structure name. The following structure names are
supported by the Coupling Facility Manager:
- SYSZWLM_WORKUNIT legacy products or later)
- SYSZWLM_xxxxxxxx (z/OS® Release 1 or later)
- Type
- Defines the type of structure. The type can be:
- CACHE
- LIST (none exists at current levels)
- Connect/Disconnect Flags
- Defines connect (IXLCONN) and disconnect (IXLDISC) indicators
that are used as footprints to indicate what was done by connect or
disconnect processing:
- Connected
- Connect Failed
- Disconnected
- Disconnect Failed
Note that the CONTOKEN field in the structure definition of
the DETAIL report defines if a structure is really connected or not.
These indicators exist to show what IWMC3CST or IWMC3DST may have
done during connect processing. For example, if it connected correctly
and then disconnected (due to some IWMC3CST validation problem) and
the disconnect failed then the Disconnect Failed indicator
is set. The CONTOKEN field in the structure definition will show
a CONTOKEN of zero indicating that it is disconnected.
- Connect Information
- Header line indicating that the following information represents
connect information for a structure:
- CONTOKEN
- Represents the CONTOKEN value from the IXLCONN invocation. (From
IXLYCONA.CONACONTOKEN.)
- Connect Version
- Represents the connect version value from the IXLCONN invocation.
(From IXLYCONA.CONACONNECTIONVERSION.)
- Structure Version
- Represents the structure version value from the IXLCONN invocation.
(From IXLYCONA.CONASTRUCTUREVERSION.)
- CONID
- Represents the CONID value from the IXLCONN invocation. (From
IXLYCONA.CONACONID.)
- Connect Name
- Represents the connection name for the IXLCONN connection. The
name starts with a ‘#’ sign and is followed by the system name.
- Control Information
- Header line indicating that the following information represents
control information for a structure:
- CONDATA
- Represents the CONDATA information that WLM supplies via the IXLCONN
service. (From CFSD.cfsd_entry_condata.)
- Functionality Level
- Represents the functionality level portion of the CONDATA. For z/OS V1R1 or later the functionality
level is cfsd_functionality_level_jbb6609 (8) which should be the
same as the Version Number in the Global Information section.
- Vector Token
- For a CACHE structure defines the vector token.
- Vector Length
- For a CACHE structure defines the number of vectors that exist.
- DISCDATA
- Header that indicates the following information is disconnect
data that is presented to all connectors when a disconnect occurs.
- Functionality Level
- The functionality level of the disconnector.
- Reason
- Identifies where in the Coupling Facility Manager the disconnect
occurred:
- 4 - IWMC3CST disconnecting from RECEXIT
- 8 - IWMC3CST found an invalid structure
- 12 - IWMC3EVP disconnecting from RECEXIT
- 16 - IWMC3EVP disconnecting due to lost connectivity
- 20 - IWMC3EVP disconnecting due to structure failure
- 24 - IWMC3TSK disconnecting from RECEXIT
- Specific Information
- Service information that can be set for the specific disconnect
The following lists what can appear according to the REASON type (see
above):
- For REASON=4 no DISCDATA service information.
- For REASON=8 contains low order 2 bytes of validation reason.
- For REASON=12 no DISCDATA service information.
- For REASON=16 contains eeplfailedconnflags in first byte and eeplexistingconnflags
in second byte.
- For REASON=20 contains eeplfailedconnflags in first byte and eeplexistingconnflags
in second byte.
- For REASON=24 no DISCDATA service information.
- Service Information
- Header line indicating that the following information represents
service information concerning connection/disconnection of a structure.
- Connect Information
- Header line for connect service information.
- Connect Return Code
- Return code returned from last IXLCONN request.
- Connect Reason Code
- Reason code returned from last IXLCONN request.
- Connect Return/Reason Code Who
- This defines who set the connect return/reason codes. The value
can be either WLM, XES if the values are valid or N/A for
not applicable if the values have not been set.
- Disconnect Information
- Header line for disconnect service information.
- Disconnect Return Code
- Return code returned from last IXLDISC request.
- Disconnect Reason Code
- Reason code returned from last IXLDISC request.
- LPAR Information
- Header line indicating that the following information represents
specific LPAR clustering information.
- LPAR Anchors
- Header that indicates the following information represents LPAR
anchors.
- CF Cache Identifier Table
- Pointer to the IWMCFCIT table.
- Head Of External CFRB Queue
- Pointer to the head of the external CFRB queue. This is where
SRM places a CFRB for IWMC3LMP.
- First CFRB On Internal Work Queue
- Pointer to the first CFRB on an internal work queue used by module
IWMC3LMP.
- Last CFRB On Internal Work Queue
- Pointer to the last CFRB on an internal work queue used by module
IWMC3LMP.
- LPAR Sizes
- Header that indicates the following information represents LPAR
size fields.
- LDE Structure Size
- Size used when readind a LDE cache entry.
- CDE Structure Size
- Size used when readind a CDE cache entry.
- XDE Structure Size
- Size used when readind a XDE cache
entry.
- IWM053 DOMID
- DOM ID that exists if message IWM053 was issued.