Connecting to a Structure During User-Managed Rebuild

The user-managed rebuild process causes the structure to be reallocated in another location, but with the same structure name. The rebuild process also allows you to change the attributes of the original structure. Connectors to the structure being rebuilt can move data from the old structure to the new structure. When the rebuild process is complete, the system deallocates the old structure and connectors continue normal processing using the new structure. See Structure Rebuild Processing for a description of the rebuild process.

Depending on the phase of the rebuild process, you might or might not be allowed to connect to the structure that is being rebuilt. IXLCONN sets the following return codes when you request a connection to a structure that is being rebuilt:

IXLCONN sets a return and a reason code (IXLRSNCODESPECIALCONN) to indicate that additional status information is available. Two bits in the CONAFLAGS field in IXLYCONA indicate whether the structure is in rebuild or rebuild stop processing. Both of these states require that the connector must participate in the user-managed rebuild process. If you do not want to participate in the process, you should issue IXLDISC to disconnect from the structure. You also have the option of causing the structure to stop being rebuilt unless rebuild stop is already in progress. See Handling New Connections During a User-Managed Rebuild Process for additional information about the IXLRSNCODESPECIALCONN reason code.
IXLCONN also might set a return and a reason code (IXLRSNCODECONNPREVENTED) to indicate that a new connection is not permitted at this time because rebuild is in progress. In this situation, you should use ENF event code 35 to determine when the rebuild process is complete. The ENF signal parameter list contains the name of the structure that has been rebuilt. See Using ENF Event Code 35 for information about using ENF event code 35.