How to Work with INGSTR

If you enter the INGSTR command without any parameters, a panel with all the coupling facilities of the sysplex is displayed.

The structure display shows all structures regardless of their allocation status or the coupling facility. You can limit the display by specifying a structure name pattern.

  • The P column indicates whether a policy change is pending for the structure. Rebuilding the structure, if possible, will remove the pending status.
  • The D column shows what type of duplexing is supported:
    U
    Indicates that user-managed duplexing is supported.
    S
    System-managed duplexing.
    B
    Both, where user-managed is preferred when possible.
    Note that, for performance reasons, this status does not include a check of the SMDUPLEX flag in the CFRM couple data set. However, this flag is checked when you use command code S.
  • The Old column shows where the structure is allocated or where it was first allocated when it is being duplexed.
  • The New column shows where the duplexed structure is allocated.
  • The Pref. Location(s) column shows the locations where the structure should preferably be allocated. When the structure is allocated to the preferred coupling facility this column is blank. A '*' in front of the coupling facility name (or names) indicates that the structure does not allow XCF to perform a reallocation.
  • The following command codes are available:
    D
    Display details of the selected structure.
    F
    Force the deletion of the selected structure.
    P
    Stop duplexing of the selected structure.
    R
    Rebuild the selected structure.
    S
    Start duplexing of the selected structure.

When the Include unallocated option is set to YES, all structures that are defined in the policy are shown. When the Include condition option is set to YES, the structure's current condition is also shown. Specifying this option increases the response time required to build the display.

Depending on the status of the CFs and the systems in the sysplex you can use the PF10 key to perform the XCF REALLOCATE command to move the allocated structures to their preferred location. When you press PF10 to move the structures, a panel asking you to confirm the action is displayed. Press PF10 to confirm the action, or PF11 to cancel the reallocation.

Note: You must be authorized to perform the FORCE, REBUILD, START, STOP, or REALLOC action.