INGSTR
Purpose
The INGSTR command allows you to display and manipulate all the structures that are defined in your active policy and all allocated structures in the sysplex. You can rebuild or delete a selected structure or start and stop the duplexing of a structure, if applicable.
The command supports full mode and line mode but in line mode only the display function is available. Therefore, you cannot start an action when you issue INGSTR from an NCCF console.
Authorizations
The actions that you can initiate with INGSTR depend on your authorizations. You can see your authorization type on the panel. Note that the authorization types see the current function, and that your authorization type can be different for different functions.
- DISPLAY
- You cannot initiate any action that affects the sysplex configuration.
- ALL
- You can initiate all actions from the corresponding panel.
Syntax
Parameters
- strname[*]
- Specifies a name pattern that limits the display. The default is to show all structures that match the 'ALL' condition.
- CONDition
- Defines whether or not the rebuild condition of each structure is to be determined and displayed.
- ALL
- Defines whether allocated and unallocated structures or just allocated structures are displayed.
- TYPE
- Defines what type of structures are to be displayed:
- C
- cache
- K
- lock
- L
- list
- S
- serialized list
- TARGET
- For information on the TARGET parameter, see TARGET Parameter.
- OUTMODE
- For information on the OUTMODE parameter, see OUTMODE Parameter.
Structure Conditions
The condition of an allocated structure can be:
- Rebuild is not supported.
- The structure can neither be rebuilt, nor can its deletion be
forced.
The structure has at least one active connector that does not support user-managed rebuild, and at least one active connector that does not support system-managed rebuild.
- System-managed processes not supported.
- The structure cannot be rebuilt, nor can its deletion be forced.
System-managed rebuild, which is a system-managed process, is not possible for the following reason:
- The CFRM couple data sets have not been formatted to support system-managed
processes (
ITEM NAME(SMREBLD) NUMBER(1)was not specified).
Note: In certain rare cases system-managed processes are not supported although the condition that is displayed on the DRAIN panel seems to indicate the contrary. Then, the rebuild will be initiated, but will fail with message IXC367I indicating that system-managed processes are not supported for the structure. - The CFRM couple data sets have not been formatted to support system-managed
processes (
- No alternate coupling facility defined or available.
- The structure can neither be rebuilt, nor can its deletion be
forced.
The structure has an active connector and supports rebuild but does not have an alternate coupling facility defined in its preference list, or the alternate coupling facilities that are defined in the preference list are currently unavailable.
- Insufficient space detected for rebuild.
- The structure cannot or could not be rebuilt. Its deletion cannot
be forced.
No alternate coupling facility has enough space to rebuild the structure.
- Preference list is empty.
- The structure cannot be rebuilt because its preference list is currently empty. A possible reason for this is a pending policy change; for pending policy changes, see P column.
- Structure is pending deallocation.
- XES accepted a forced deletion of the structure but does the real
deallocation later. Note: This status can only occur when MVS APAR OW39404 has not been installed.
- Structure is being rebuilt.
- The structure is being rebuilt to another coupling facility.
- Duplex rebuild is being stopped.
- Two instances of the structure were maintained on different coupling facilities. The application is being disconnected from that instance that is allocated on the target coupling facility. After disconnecting, the instance is deleted.
- No connection exists.
- The structure cannot be rebuilt, but you can force its deletion.
The structure does not have any connections and cannot be rebuilt with system-managed rebuild.
- No alternate coupling facility for structure with no connections.
- The structure cannot be rebuilt, but you can force its deletion.
The structure does not have any connections. It could be rebuilt with system-managed rebuild, but no alternate coupling facility is defined in its preference list or available.
- No alternate coupling facility for structure with no active connections.
- The structure cannot be rebuilt, but you can force its deletion.
The structure has only DISCONNECTING, FAILED, or FAILED-PERSISTENT connections. It could be rebuilt with system-managed rebuild, but no alternate coupling facility is defined in its preference list or available.
- The structure’s initial size is less than its actual size.
- The SIZE value is greater than twice the INITSIZE value. The structure
can be rebuilt, but a SIZE value that is greater than twice the INITSIZE
might cause the following:
- It might be impossible to allocate a structure at a size of INITSIZE, because the amount of control storage that is required to support the SIZE value might actually be larger than INITSIZE.
- If the allocation succeeds, it might result in a structure with a proportionally large amount of its storage allotted to structure controls, leaving too few structure objects to be exploited usefully by the associated application.
For example, if you have requested a maximum size that is very much larger than the initial size, the system will attempt to use a proportionally large amount of the allocated storage for its controls. The result could be that the allocated storage contains control structures for the future maximum size of the structure and insufficient storage might remain for the application's initial use.
- No active connection exists.
- The structure cannot be rebuilt, but you can force its deletion. The structure has only DISCONNECTING, FAILED, or FAILED-PERSISTENT connections and cannot be rebuilt with system-managed rebuild.Note: INGCF STRUCTURE accepts a rebuild request for structures with this condition, but deallocates them.
- No connections. System-managed rebuild supported.
- The structure can be rebuilt.
The structure does not have any connections, but can be rebuilt with system-managed rebuild.
- No active connections. System-managed rebuild supported.
- The structure can be rebuilt with system-managed rebuild.
User-managed rebuild is not possible for the structure because it has only DISCONNECTING, FAILED, or FAILED-PERSISTENT connections.
- System-managed rebuild is supported
- The structure can be rebuilt.
The structure has active connectors. At least one active connector does not support user-managed rebuild, but all active connectors support system-managed rebuild.
- Duplex rebuild is active.
- The application is connected to two instances of the same structure on different coupling facilities.
- [No condition]
- When no condition is displayed, the structure can be rebuilt.
The structure has at least one active connection, and all its active connectors support user-managed rebuild.
- Structure is awaiting rebuild.
- The structure has been selected for rebuild but has not been processed yet.
- Structure is currently allocated on cf_name.
- The structure can be rebuilt on the target coupling facility with the POPULATE action of the ENABLE function. It is currently allocated on the cf_name coupling facility, but the target coupling facility precedes cf_name in the structure's preference list. This condition is displayed only in the ENABLE command dialog.
- Structure allocated in cf_name cannot be rebuilt to this CF.
- The structure can probably not be rebuilt on the target CF with the POPULATE action of the ENABLE function. It is currently allocated in the cf_name CF, but the target CF precedes cf_name in the structure's preference list. And, the actual size of the structure is greater than the free space of the target CF. This condition is displayed only in the ENABLE command dialog.
Examples
If you enter ingstr without
any parameters, a panel with all coupling facilities of the sysplex
is displayed, as shown in Figure 1.
INGLX906 SA z/OS - Command Dialogs Line 6 of 52
Domain ID = IPXFI --------- INGSTR ---------- Date = 11/23/04
Operator ID = NETOPER1 Time = 11:17:27
Structure names . . ==> Status . . . . . . : NORMAL
Sysplex . . . . . . ==> KEYAPLEX Permission . . . . : ALL
Include condition . ==> NO (Yes/No - Condition retrieval takes longer)
Include unallocated ==> NO (Yes/No)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Cmds: D display details / F force / P stop duplex / R rebuild / S start duplex
Structure P D Old New Pref. Location(s)
---------------- - - -------- -------- -----------------
DSNA_GBP0 U CFA CFB
DSNA_GBP1 S CFA CFB
DSNA_GBP2 U CFA CFB
DSNA_GBP32K CFA
DSNA_LOCK1 S CFA CFA CFA CFB
DSNA_SCA S CFB CFB CFA
GRPXCSQ_ADMIN CFB
Command ===>
F1=Help F2=End F3=Return F6=Roll
F8=Forward F9=Refresh F10=ReAlloc F12=Retrieve 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.
- 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. A panel similar to that shown in Figure 2 is displayed.
INGLX906 SA z/OS - Command Dialogs Line 11 of 104
Domain ID = IPXFI --------- INGSTR ---------- Date = 11/23/04
Operator ID = NETOPER1 Time = 11:18:28
Structure names . . ==> Status . . . . . . : NORMAL
Sysplex . . . . . . ==> KEYAPLEX Permission . . . . : ALL
Include condition . ==> YES (Yes/No - Condition retrieval takes longer)
Include unallocated ==> YES (Yes/No)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Cmds: D display details / F force / P stop duplex / R rebuild / S start duplex
Structure P D Old New Pref. Location(s)
---------------- - - -------- -------- -----------------
DSNA_GBP0 U CFA CFB
Condition ...: Duplex rebuild is active.
DSNA_GBP1 S CFA CFB
Condition ...: *Structure is not allocated.
DSNA_GBP2 U CFA CFB
Condition ...:
DSNA_GBP32K CFA
Condition ...: *Structure is not allocated.
DSNA_LOCK1 S CFB CFA CFA CFB
Condition ...: Duplex rebuild is active.
DSNA_SCA S CFA CFB CFA
Condition ...: System-managed rebuild is supported.
GRPXCSQ_ADMIN CFB
Condition ...: System-managed rebuild is supported.
GRPXHSAQUEUE CFB
Condition ...: System-managed rebuild is supported.
HSA_LOG CFB CFA
Condition ...:
IEFAUTOS CFA
Condition ...: *Structure is not allocated.
IMSOSAMCACHE *CFB
Condition ...: *Structure is not allocated.
IMSVSAMCACHE *CFB
Condition ...: *Structure is not allocated.
ING_HEALTHCHKLOG CFA CFB
Condition ...:
Command ===>
F1=Help F2=End F3=Return F6=Roll
F8=Forward F9=Refresh F10=ReAlloc F12=Retrieve 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, as shown in Figure 3. Press PF10 to confirm the action, or PF11 to cancel the reallocation.
INGLX92X SA z/OS - Command Dialogs
Domain Id = IPXFI --------- INGSTR ---------- Date = 11/23/04
Operator Id = NETOP1 Time = 12:32:58
Sysplex . . . . . . : KEYAPLEX
R E A L L O C A T E Confirmation
The XCF REALLOCATE process runs asynchronously on the next system in the
sysplex that has access to the CFRM couple data set. XCF processes all
structures in sequence. Once started use the refresh PF key for getting the
current status of the process. When the process has completed but not all
structures have been moved to their preferred location look for IXC544I
messages in the netlog. This message provides an explanation of the reason why
a structure wasn't adjusted.
Command ===>
F2=End F3=Return F6=Roll
F10=Go F11=Cancel F12=Retrieve If you enter, for example, the command INGSTR D* COND=Y ALL=Y OUTMODE=LINE, this produces line command output, as shown in Figure 4.
Structures: D*
Sysplex...: KEYAPLEX
Structure P D Old New Pref. Location(s) Condition
----------- - -------- -------- ----------------- ----------------------------
DSNA_GBP0 U CFA CFB Duplex rebuild is active.
DSNA_GBP1 S CFA CFB *Structure is not allocated.
DSNA_GBP2 U CFA CFB
DSNA_GBP32K CFA *Structure is not allocated.
DSNA_LOCK1 S CFB CFA CFA CFB Duplex rebuild is active.
DSNA_SCA S CFA CFB CFB CFA Duplex rebuild is active.
*** End of Display ***