INGSTR
用途
INGSTR 命令允许您显示和处理在活动策略中定义的所有结构以及综合系统中的所有已分配结构。 您可以重建或删除所选结构，或者启动和停止结构的双工 (如果适用)。
该命令支持完全方式和线路方式，但在线路方式下，只有显示功能可用。 因此，从 NCCF 控制台发出 INGSTR 时，无法启动操作。
授权
您可以使用 INGSTR 启动的操作取决于您的授权。 您可以在面板上看到您的授权类型。 请注意，授权类型会看到当前函数，而对于不同的函数，您的授权类型可能有所不同。
存在以下授权类型:
- 显示
- 您无法启动任何影响综合系统配置的操作。
- 全部
- 您可以从相应的面板启动所有操作。
注: 仅当您有权执行操作时，才会显示可用来启动其中一个操作的代码或 PF 键。
语法
参数
- strname [*]
- 指定用于限制显示的名称模式。 缺省值是显示与 "ALL" 条件匹配的所有结构。
- 条件
- 定义是否确定和显示每个结构的重建条件。
- 全部
- 定义是显示已分配和未分配的结构，还是仅显示已分配的结构。
- 类型
- 定义要显示的结构类型:
- C
- 高速缓存
- K
- 锁
- L
- 列表
- S
- 序列化列表
- 目标
- 有关 TARGET 参数的信息，请参阅 TARGET 参数 IBM System Automation for z/OS 操作员命令。
- 输出方式
- 有关 OUTMODE 参数的信息，请参阅 OUTMODE 参数 IBM System Automation for z/OS 操作员命令。
结构条件
已分配结构的条件可以是:
- 不支持重建。
- 结构既不能重建，也不能强制删除。
该结构具有至少一个不支持用户管理的重建的活动连接器，以及至少一个不支持系统管理的重建的活动连接器。
- 系统管理的进程不受支持。
- 不能重建结构，也不能强制删除结构。
由于以下原因，无法进行系统管理的重建 (这是系统管理的进程):
- 尚未格式化 CFRM 耦合数据集以支持系统管理的进程 (未指定
ITEM NAME(SMREBLD) NUMBER(1))。
注: 在某些罕见情况下，系统管理的进程不受支持，尽管漏出面板上显示的情况似乎表明相反。 然后，将启动重建，但将失败并显示消息 IXC367I ，指示该结构不支持系统管理的进程。 - 尚未格式化 CFRM 耦合数据集以支持系统管理的进程 (未指定
- 没有定义或可用的备用耦合设施。
- 结构既不能重建，也不能强制删除。
该结构具有活动连接器并支持重建，但未在其首选项列表中定义备用耦合设施，或者首选项列表中定义的备用耦合设施当前不可用。
- 检测到用于重建的空间不足。
- 无法或无法重建该结构。 不能强制删除该文件。
没有备用耦合设施具有足够的空间来重建结构。
- 首选项列表为空。
- 无法重建结构，因为其首选项列表当前为空。 可能的原因是暂挂策略更改; 对于暂挂策略更改，请参阅 P 列。 如果在 CFRM 策略切换时分配了一个结构，但 XES 无法使该结构的切换生效，则该结构的策略变更处于待定状态。 政策变更悬而未决的原因之一是新旧政策对结构的定义不同，例如，偏好列表不同。
- 结构正在暂挂释放。
- XES 接受强制删除结构，但稍后执行实际释放。注意： 只有在未安装 MVS APAR OW39404 时才会出现这种状态。
- 正在重建结构。
- 正在将该结构重建到另一个耦合设施。
- 正在停止双工重建。
- 在不同的耦合设施上保留了该结构的两个实例。 正在将应用程序与目标耦合设施上分配的实例断开连接。 断开连接后，将删除实例。
- 不存在任何连接。
- 无法重建结构，但您可以强制将其删除。
该结构没有任何连接，无法通过系统管理的重建进行重建。
- 没有用于没有连接的结构的备用耦合设施。
- 无法重建结构，但您可以强制将其删除。
该结构没有任何连接。 可以使用系统管理的重新构建对其进行重建，但在其首选项列表中未定义任何备用耦合设施，也未定义任何备用耦合设施。
- 对于没有活动连接的结构，没有备用耦合设施。
- 无法重建结构，但您可以强制将其删除。
该结构仅具有正在断开连接，失败连接或 FAILED-PERSISTENT 连接。 可以使用系统管理的重新构建对其进行重建，但在其首选项列表中未定义任何备用耦合设施，也未定义任何备用耦合设施。
- 结构的初始大小小于其实际大小。
- SIZE 值大于 INITSIZE 值的两倍。 可以重建结构，但大于 INITSIZE 两倍的 SIZE 值可能会导致以下情况:
- 可能无法分配大小为 INITSIZE 的结构，因为支持 SIZE 值所需的控制存储量实际上可能大于 INITSIZE。
- 如果分配成功，那么可能会导致结构将其存储量按比例分配给结构控件，从而使相关联的应用程序无法有效利用太少的结构对象。
例如，如果您请求的最大大小远远大于初始大小，那么系统将尝试按比例使用大量已分配的存储器用于其控制。 结果可能是已分配的存储器包含用于将来最大结构大小的控制结构，并且可能没有足够的存储器可供应用程序初始使用。
- 不存在活动连接。
- 无法重建结构，但您可以强制将其删除。该结构仅具有正在断开连接，失败连接或 FAILED-PERSISTENT 连接，并且无法使用系统管理的重建进行重建。注: INGCF STRUCTURE 接受具有此条件的结构的重建请求，但取消分配这些结构。
- 没有连接。 支持系统管理的重建。
- 可以重建结构。
该结构没有任何连接，但可以通过系统管理的重建进行重建。
- 无活动连接。 支持系统管理的重建。
- 可以使用系统管理的重建来重建结构。
无法对结构进行用户管理的重建，因为它只有断开连接，失败连接或失败-持久连接。
- 支持系统管理的重建
- 可以重建结构。
该结构具有活动连接器。 至少一个活动连接器不支持用户管理的重建，但所有活动连接器都支持系统管理的重建。
- 双工重建处于活动状态。
- 应用程序连接到不同耦合设施上相同结构的两个实例。
- [无条件]
- 如果未显示任何条件，那么可以重建结构。
该结构具有至少一个活动连接，并且其所有活动连接器都支持用户管理的重建。
- "无条件"
- 如果未显示任何条件，那么可以重建结构。
该结构具有至少一个活动连接，并且其所有活动连接器都支持用户管理的重建。
- 结构正在等待重建。
- 已选择要重建的结构，但尚未处理该结构。
- 当前在 cf_name上分配了结构。
- 可以使用 ENABLE 函数的填充操作在目标耦合设施上重建该结构。 它当前在 cf_name 耦合设施上分配，但目标耦合设施在结构的首选项列表中位于 cf_name 之前。 此条件仅显示在 ENABLE 命令对话框中。
- 无法将 cf_name 中分配的结构重建到此 CF。
- 可能无法使用 ENABLE 函数的填充操作在目标 CF 上重建结构。 它当前在 cf_name CF 中分配，但目标 CF 在结构的首选项列表中的 cf_name 之前。 并且，该结构的实际大小大于目标 CF 的可用空间。 此条件仅显示在 ENABLE 命令对话框中。
示例
如果输入不带任何参数的 ingstr ，那么将显示一个面板，其中包含综合系统的所有耦合设施，如 图 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 结构显示显示所有结构，而不考虑它们的分配状态或耦合设施。 您可以通过指定结构名称模式来限制显示。
- P 列指示是否对该结构暂挂策略更改。 如果可能，重建结构将除去暂挂状态。
- D 列显示支持的 duplexing 类型:
- U
- 指示支持用户管理的 duplexing。
- S
- 系统管理的双工。
- B
- 两者都是首选用户管理的情况 (如果可能)。
- 旧 列显示结构的分配位置或在对其进行双工时首次分配的位置。
- 新建 列显示分配双工结构的位置。
- Pref。 位置 列显示了最好应该在其中分配结构的位置。 当将结构分配给首选耦合设施时，此列为空白。 耦合设施名称 (或名称) 前面的 "*" 指示结构不允许 XCF 执行重新分配。
- 以下命令代码可用:
- D
- 显示所选结构的详细信息。
- F
- 强制删除所选结构。
- P
- 停止所选结构的双工。
- R
- 重建所选结构。
- S
- 启动所选结构的双工。
当 包括未分配的 选项设置为 YES 时，将显示策略中定义的所有结构。 当 包含条件 选项设置为 YES 时，还会显示结构的当前条件。 指定此选项将增加构建显示所需的响应时间。 将显示类似于 图 2 中所示的面板。
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 根据 CF 的状态以及综合系统中的系统，您可以使用 PF10 键来执行 XCF REALLOCATE 命令，以将分配的结构移至其首选位置。 按 PF10 以移动结构时，将显示要求您确认操作的面板，如 图 3中所示。 按 PF10 以确认操作，或按 PF11 以取消重新分配。
注: 您必须有权执行 FORCE ， REBUILD ， START ， STOP 或 REALLOC 操作。
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 例如，如果输入命令 INGSTR D* COND=Y ALL=Y OUTMODE=LINE ，那么将生成行命令输出，如 图 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 ***