IFCID 250 - Connect/Rebuild Connect/Disconnect Group Bpool

This topic shows detailed information about Record Trace - IFCID 250 - Connect/Rebuild Connect/Disconnect Group Bpool.

This record is written for a group buffer pool (coupling facility cache structure) connect, rebuild, or disconnect event.

The DESCRIPTION column indicates what event occurred. The format of this record and data shown depends on the event being reported.

Record trace - IFCID 250 - Connect/Rebuild Connect/Disconnect Group Bpool

The field labels shown in the following sample layout of Record Trace - IFCID 250 - Connect/Rebuild Connect/Disconnect Group Bpool are described in the following section.


|-------------------------------------------------------------------------------------------------------------------------
|STRUCTURE NAME: DSNCAT_GBP0       GROUP BP NAME: GBP0       RETURN CODE:          0  REASON CODE: X'00000000'
|.........................................................................................................................
|STRUCTURE SIZE:        384  DIRECTORY ENTRIES :       1468  ALLOCATION  : NO              MAX NUMBER CASTOUT    :  1024
|DATA ELEMENTS :        293  MAX STRUCTURE SIZE:        384  CONNECT TYPE: NEW CONNECTION  EXCLUSION LIST HONORED: YES
|QW0250F1  B'00000000000000000000000000000000'
|-------------------------------------------------------------------------------------------------------------------------

IFCID 250 - Connect & Rebuild Connect
Failure (Authorization)  Record
|-------------------------------------------------------------------------------------------------------------------------
|STRUCTURE NAME: DSNCAT_GBP0       GROUP BP NAME: GBP0       RETURN CODE:          0  REASON CODE: X'00000000'
|.........................................................................................................................
|SAF RETURN CODE: 9999999999  SAF REASON CODE: X'HHHHHHHH'
|-------------------------------------------------------------------------------------------------------------------------

IFCID 250 - Connect & Rebuild Connect
Failure (No Suitable Coupling Facility)  Record

|-------------------------------------------------------------------------------------------------------------------------
|STRUCTURE NAME: DSNCAT_GBP0       GROUP BP NAME: GBP0       RETURN CODE:          0  REASON CODE: X'00000000'
|........................................................................................................................
|COUPLING FACILITY NAME: XXXXXXXX  COUPLING FACILITY REASON: STRUCTURE ATTRIBUTES INCONSISTENT
|MIN CONTROL SPACE : 9999999999  TOTAL SPACE : 9999999999  TOTAL CONTROL SPACE: 9999999999  TOTAL FREE SPACE: 9999999999
|FREE CONTROL SPACE: 9999999999  STORAGE SIZE:      99999  MAXIMUM ELEMENT    :        999  MAXIMUM CASTOUT :      99999
|-------------------------------------------------------------------------------------------------------------------------

IFCID 250 - Disconnect

|-------------------------------------------------------------------------------------------------------------------------
|STRUCTURE NAME: DSNCAT_GBP0       GROUP BP NAME: GBP0       RETURN CODE:          0  REASON CODE: X'00000000'
|.........................................................................................................................
|DISCONNECT TYPE: FAILED-PERSISTENT
|-------------------------------------------------------------------------------------------------------------------------
STRUCTURE NAME

The name of the coupling facility structure.

Field Name: QW0250SN

GROUP BP NAME

The group buffer pool name.

Field Name: QW0250GN

RETURN CODE

The return code.

The reason code.

Field Name: QW0250RC

STRUCTURE SIZE

The structure size, that is, the number of 4 KB blocks. The actual size might be less than the requested size due to insufficient space in the preference list facilities.

Field Name: QW0250SZ

DIRECTORY ENTRIES

The number of allocated directory entries.

Field Name: QW0250DR

ALLOCATION

Indicates whether this connect caused a structure allocation.

Field Name: QW0250CA

MAX NUMBER CASTOUT

The maximum number of castout classes.

Field Name: QW0250CO

DATA ELEMENTS

The number of data elements allocated. For Db2 group buffer pools, the size of the data elements is 4 KB. Each data entry consists of one or more data elements.

Field Name: QW0250DT

MAX STRUCTURE SIZE

The maximum structure size saved at the time the structure was allocated. The maximum structure size is obtained from the active policy at the time the structure is allocated.

Field Name: QW0250SM

CONNECT TYPE

The type of connection.

Field Name: QW0250CD

EXCLUSION LIST HONORED

Indicates whether the exclusion list was honored.

This field is only applicable if the value in ALLOCATION is YES . Otherwise, N/A is printed in this field.

Field Name: QW0250F2

SAF RETURN CODE

The system authorization facility (SAF) return code.

Field Name: QW0250X1

SAF REASON CODE

The SAF reason code.

Field Name: QW0250X2

COUPLING FACILITY NAME

The coupling facility name.

Field Name: QW0250ZN

COUPLING FACILITY REASON

The reason why the coupling facility was not suitable.

Field Name: QW0250ZR

MIN CONTROL SPACE

The minimum control space required (in 4 KB blocks) to allocate the structure for which connect was requested.

Field Name: QW0250ZM

TOTAL SPACE

The total space in the coupling facility in 4 KB blocks, including control and noncontrol space.

Field Name: QW0250ZG

TOTAL CONTROL SPACE

The total control space in the coupling facility in 4 KB blocks.

Field Name: QW0250ZH

TOTAL FREE SPACE

The total free space in 4 KB blocks, including control and noncontrol space.

Field Name: QW0250ZI

FREE CONTROL SPACE

The free control space in 4 KB blocks.

Field Name: QW0250ZJ

STORAGE SIZE

The storage increment size in 4 KB blocks.

Field Name: QW0250ZK

MAXIMUM ELEMENT

The maximum element characteristic. Db2 always requests a 4 KB element size. Therefore, this field should always equal 4.

Field Name: QW0250ZL

MAXIMUM CASTOUT

The maximum number of castout classes for a structure using this coupling facility.

Field Name: QW0250ZO

DISCONNECT TYPE

The type of disconnect.

Field Name: QW0250DD