Rebuild the structure

Rebuild the structure that has the hung connectors by issuing the following command: SETXCF START,REBUILD,STRNAME=strname (See z/OS MVS System Commands for additional information.) If the structure does not support rebuild, go to Collect documentation.

After the REBUILD command is issued, display the structure information by issuing the following command: DISPLAY XCF,STRUCTURE,STRNAME=strname

Examine the output of the command (IXC360I) and locate information about the REBUILD phase and the state of the structure connections. Figure 1 shows an example.

Figure 1. Example: Output from DISPLAY XCF, STRUCTURE, STRNAME command

IXC360I   12.23.28   DISPLAY XCF xxx
STRNAME: IRLMLOCK1
  STATUS: REASON SPECIFIED WITH REBUILD START:
              OPERATOR INITIATED
              REBUILD PHASE: QUIESCE
               '
               '
               '
               /  (only relevant portions of message IXC360I are
               /    shown here)
               '
               '
               ' 

* ASTERISK DENOTES CONNECTOR WITH OUTSTANDING REBUILD RESPONSE

  CONNECTION NAME    ID   VERSION   SYSNAME  JOBNAME   ASID   STATE
  -----------------  --   --------  -------- --------  ----   ------
* IRLMGRP1$IRLA001   03   0003002F   SYS1     IRLMA    001D   ACTIVE
  IRLMGRP1$IRLB002   02   0002008C   SYS2     IRLMB    0058   ACTIVE
  IRLMGRP1$IRLC003   01   00010099   SYS3     IRLMC    003F   FAILING 
  IRLMGRP1#IRLC004   04   0004001A   SYS3     IRLMC    0180   DISCONNECTING

Determine if the REBUILD is “hung” by displaying the structure information again. Examine the REBUILD phase of the structure and the state of the connections. If the structure REBUILD is not progressing (for example, the structure is stuck in the REBUILD QUIESCE phase), look for connectors that have an outstanding REBUILD response (denoted by a * to the left of the connection name).

Note: Allow some time between issuing the display commands to ensure that the ACTIVE connectors have had a chance to process the REBUILD request. Structure REBUILD may take a few minutes. Display the structure a few times to verify that the REBUILD phase and the outstanding connector responses (*) are not changing. The REBUILD phase is displayed in message IXC360I. IXL040E is issued to identify a response that a connector has not provided in a timely manner.

If the REBUILD is not progressing and one or more of the ACTIVE connectors has an outstanding REBUILD response, the job associated with the connectors that are not responding to REBUILD (IRLMA in the above example), requires recovery actions. Continue with Collect documentation.