INGIMS
作用
INGIMS 命令允许您:
- 发出 type-1 和 type-2 IMS 命令，并针对 IMSplex 及其成员发出这些命令。
- 向所有或所选 IMS 用户广播消息。
- 发出已定义事务或命令的列表并查看输出。
- 以全屏或管道方式显示 IMS 事务的输出。
语法
参数
- 资源
- 该资源指定向其发出命令的 IMS 子系统的名称。 格式为子系统 [/APL[/system]] ，其中子系统是所需 IMS 子系统的特定名称，系统是运行 IMS 的系统的名称。注: 如果指定 REQ=XCMD 或 REQ=XINFO ，那么 SA z/OS 将确定 IMS 子系统所属的 IMSplex 名称，并将命令路由到该 IMS。
- REQ
- 指定要向 IMS 子系统发出的请求。 可以是下列之一：
- CMD
- 发出指定的 IMS 命令或事务并显示结果。 该命令将使用其控制台界面转发到 IMS 。
如果命令和参数包含空格，请将命令括在单引号或双引号中。
REQ=CMD 是缺省值。
注: 请勿为 IMS 命令指定前缀字符正斜杠 (/)。 - XCMD
- 这与 CMD 相同，但如果在策略中指定了 IMSPLEX 参数或提供了给定资源的 IMSplex 名称，那么该命令将通过 IMS Operations Manager 转发到 IMS 。 在这种情况下，还支持 IMS 类型 2 命令。 否则，将使用仅支持 type-1 命令的控制台界面。 但是，在任何一种情况下，输出的格式都是相同的。注: 请勿为 IMS 命令指定前缀字符正斜杠 (/)。
- 参考
- 发出一组预定义命令并显示结果。 从由资源名称指定的子系统的策略中的 IMSINFO 消息标识的用户定义的 "关键字-数据" 对获取命令列表。 各个命令与 CMD 一样执行。
- XINFO
- 这与 INFO 相同，但单独的命令与 XCMD 一样执行。
- 广播
- 向所有用户或所选用户发出 IMS 广播。
- DEP
- 显示与控制区域关联的从属区域。
- TCO
- 显示有关 IMS 定时控制操作功能的详细信息。
- IMSPLEX
- 指定 IMSplex 名称。
- MEMBERS
- 标识应该在其中执行命令的成员的列表。 它可以是：
- 星号 (*) ，这将使命令转发到 IMSplex 中的所有已注册的命令处理客户机。
- 百分比符号 (%) ，这将使命令转发到一个具有 MASTER 功能的已注册命令处理客户机。
- 成员名和/或类型标识的列表。 类型标识是类别 IMS 的子类别 (即， DBCTL ， DCCTL ， DBDC 或 FDBR) ，并且必须以星号 (例如， *DCCTL 或 *FDBR) 开头。 *CTL 可用作 "*DBCTL *DCCTL *DBDC" 的速记。
- Resp
- 指定是否应该将输出返回给调用者。 RESP 是可选的，缺省值为 YES
- CMDWAIT
- 指定命令完成的最长等待时间。 CMDWAIT 是可选的，缺省值为 CGLOBAL WAITTIME 的值。
- MSG
- 指定要针对 REQ=BROADCAST 请求向所有或所选 IMS 终端或用户发送的消息。 将消息括在单引号或双引号中。
对于 REQ=CMD ， MSG 参数可用于包含将用于结束处理的词的列表 (如果在输出结果中的任何位置接收到这些词)。 这些词通常是必需的消息标识。 如果未输入任何词，那么将处理 CMD ，直到收到任何结果为止。
- 路由
- 指定用于选择 IMS 终端或用户接收 REQ=BROADCAST 请求的消息的 IMS 路由信息。 ROUTE 参数的内容是要提供给 /BRO 事务以将消息路由到 IMS 终端或用户的参数。 请参阅 /BRO 事务以获取该事务的参数的详细信息。
- 目标
- 有关 TARGET 参数的信息，请参阅 TARGET 参数。
- 输出 DSN
- 有关 OUTDSN 参数的信息，请参阅 OUTDSN 参数。
- 输出方式
- 有关 OUTMODE 参数的信息，请参阅 OUTMODE 参数。
限制和限制
要使用 INGIMS 命令，必须初始化 系统操作 。 必须使用 MCS/E-MCS 控制台对系统控制台命令启用 IMS 子系统。
使用量
INGIMS 命令操作 sysplexwide。 有关概述，请参阅 操作 Sysplexwide 的命令概述。
示例
如果输入 图 1。 INGIMS 命令对话框面板
ingims ，那么将显示类似于 图 1 的面板。 EVIKYCMD SA z/OS - Command Dialogs Line
Domain ID = IPSFM ---------- INGIMS ---------- Date = 06/08/09
Operator ID = NETOP1 Time = 15:08:38
Resource => SREL1 -or- IMSPlex name =>
IMS Members =>
Target => System name, domain ID or sysplex name
Request => XCMD CMD or XCMD, INFO or XINFO, BROADCAST, DEP, TCO
IMS Command =>
Response => YES Yes/No Command wait time => 60 (seconds)
IMS Route =>
IMS Message =>
=>
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve - 资源 字段显示要用于发出请求的 IMS 子系统的名称。 格式为 name/type [/system]。 支持通配符。
- IMSPlex 名称 字段显示 IMSplex 的名称。
- IMS 成员 字段标识应在其中处理命令的成员。 IMS 由其子系统标识或其类型标识命名。 类型标识为 DB ， DC ， FDBR 和 CQS 等。 必须以星号 (*) 作为类型标识的前缀，例如 *DBDC。 可以使用 *CTL 作为 *DB *DC *DBDC 的速记。
- 目标 字段显示应将命令路由至的系统的名称 (系统名称，域标识或综合系统名称)。 仅当资源不在本地综合系统中时，才需要指定此项。
- 请求 字段显示要执行的请求。 可以是 CMD ， BROADCAST ， INFO ， XCMD 或 XINFO。注: 如果指定 XCMD 或 XINFO ，那么必须使用 IMSPlex 名称 和/或 IMS 成员 字段来指定请求的目标。
- IMS 命令 字段显示要在资源字段指定的 IMS 子系统上执行的 IMS 事务。
- 响应 字段指示是否应将输出返回给调用者。
- 命令等待时间 字段指定命令完成的最长等待时间。 缺省值为 WAITTIME 公共全局变量的值。
- 当请求为 BROADCAST 时， IMS Route 字段显示 /BRO 命令的路由参数。
- IMS 消息 字段显示要针对 BROADCAST 请求发送给用户/终端的消息。
IMS 事务的输出显示在 IMS 消息 字段下的空白区域中。
例如，如果指定 图 2。 INGIM REQ=BROADCAST 命令对话框面板
INGIMS EIMSDBRC REQ=BROADCAST ，那么将显示类似于 图 2 的面板。 EVIKYCMD SA z/OS - Command Dialogs Line
Domain ID = IPSFM ---------- INGIMS ---------- Date = 06/08/09
Operator ID = NETOP1 Time = 15:11:23
Resource => EIMSDBRC/APL/AOC8 -or- IMSPlex name =>
IMS Members =>
Target => System name, domain ID or sysplex name
Request => BROADCAST CMD or XCMD, INFO or XINFO, BROADCAST, DEP, TCO
IMS Command => BROADCAST
Response => Yes/No Command wait time => (seconds)
IMS Route => ACTIVE
IMS Message =>
=>
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve 例如，如果指定
INGIMS
REQ=XCMD CMD=’DIS ACT’ 输出，那么将在 NetView 窗口中显示类似于以下内容的输出 (允许您滚动输出): OM=IMSAA1OM Rc=00000000 Rsn=00000000
Master=MAC1 User=STCUSER Cmd=DIS ACT
MbrName MsgData
MAA1 REGID JOBNAME TYPE TRAN/STEP PROGRAM STATUS CLASS
MAA1 4 IMSAA1M1 TP WAITING 1
MAA1 JMPRGN JMP NONE
MAA1 JBPRGN JBP NONE
MAA1 BATCHREG BMP NONE
MAA1 1 IMSAA1F1 FPM NO MSG. DFSIVP4
MAA1 3 IMSAA1F3 FPM NO MSG. DBFSAMP3
MAA1 DBTRGN DBT NONE
MAA1 IMSAA1RC DBRC
MAA1 IMSAA1DL DLS
MAA1 VTAM ACB OPEN -LOGONS ENABLED
MAA1 IMSLU=N/A.N/A APPC STATUS=DISABLED TIMEOUT= 0
MAA1 OTMA GROUP=N/A STATUS=NOTACTIVE
MAA1 APPC/OTMA SHARED QUEUE STATUS - LOCAL=INACTIVE GLOBAL=INACTIVE
MAA1 APPC/OTMA RRS MAX TCBS - 40 ATTACHED TCBS - 1 QUEUED RRSWKS-
MAA1 APPLID=IPXAGIA1 GRSNAME= STATUS=DISABLED
MAA1 LINE ACTIVE-IN - 1 ACTIV-OUT - 0
MAA1 NODE ACTIVE-IN - 0 ACTIV-OUT - 0
MAA1 *09139/155812*INGIMS REQ=XINFO 输出: QUERY CQS DATA--------------------------------------------------------------
OM=IMSAA1OM Rc=00000000 Rsn=00000000
Master=MAC1 User=STCUSER Cmd=DIS CQS
MbrName MsgData
MAA1 DFS4444I DISPLAY FROM ID=MAA1
MAA1 JOBNAME VERS# STATUS
MAA1 IMSAA1SQ 1.5 CONNECTED
MAA1 *09148/174750*
DISPLAY COORDINATOR CONTROLLERS---------------------------------------------
OM=IMSAA1OM Rc=00000000 Rsn=00000000
Master=MAC1 User=STCUSER Cmd=DIS CCTL
MbrName MsgData
MAA1 DFS4444I DISPLAY FROM ID=MAA1
MAA1 CCTL STATUS
MAA1 IMSAA1SQ 1.5 CONNECTED
MAA1 *09148/174715*可以使用 IMSPLEX 参数对 IMSplex 的成员发出命令，例如:
INGIMS IMSPLEX=IMXPLEX_1 MEMBERS=*CTL REQ=XCMD CMD=’QUERY AREA’ OUTMODE=LINE如果要查看 IMS 从属区域，请使用带有 REQ=DEP 的 INGIMS 命令对话框，并显示以下屏幕:
EVIKYDP0 SA z/OS - Command Dialogs Line 1 of 5
Domain ID = IPSFP ---- Dependent Regions ----- Date = 08/03/07
Operator ID = OPER Time = 12:44:37
Control Reg.= IMSCTL/APL/KEY4
CMD: A Update B Start C Stop D INGRELS E INGVOTE F INGINFO
H DISPTRG I INGSCHED N /ASSIGN P /PSTOP / scroll
CMD Name Type System Reg.Id Type Trans/Step Program IMS Status
--- ----------- ---- ------ ------ ---- ---------- -------- ----------------
IMSDBRC APL KEY4 DBRC
IMSDLS APL KEY4 DLS
IMSFP1 APL KEY4 1 FPME NO MSG. DFSIVP4
IMSMP1 APL KEY4 2 TP WAITING
IMSPPI APL KEY4 3 BMP IMS941PP EVIRYPPI
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF10=Previous PF11=Next PF12=Retrieve