INGCICS
用途
INGCICS 命令允许您:
- 发出任何启用控制台的 CICS® 事务。
- 向所有或所选 CICS 用户广播消息。
- 发出已定义事务的列表并查看输出。
- 以全屏或可移行方式显示 CICS 事务的输出。
语法
参数
- 资源
- 资源指定将向其发出命令的 CICS 子系统的名称。 格式为子系统 [/APL[/system]] ,其中子系统是所需 CICS 子系统的特定名称,系统是运行 CICS 的系统的名称。注: 您无需指定资源的标准名称。 但是,该命令需要足够的信息以针对唯一的 CICS 子系统执行请求。 此命令不支持同时向多个 CICS 子系统发出请求。
- REQ
- 指定要向 CICS 子系统发出的请求。 可以是下列之一:
- CMD
- 发出 CICS 事务并显示结果。
- 广播
- 向所有用户或所选用户发出 CICS 广播。
- 注意
- 发出一组预定义命令并显示结果。 从由资源名称指定的子系统的 CICSINFO 用户消息策略中获取命令列表。
- CMD
- 指定要对 REQ=CMD 类型请求执行的 CICS 事务及其参数。 如果命令和参数包含空格,请使用引号 (单引号或双引号) 将命令括起来。 对于 CEMT 事务, INGCICS 等待时间最多为系统等待时间参数为结果定义的时间段的两倍。
- MSG
- 指定要发送到 REQ=BROADCAST 请求的所有或所选 CICS 终端或用户的消息。
对于 REQ=CMD ,可以使用 MSG 命令来包含将用于结束处理的词的列表 (如果在输出结果中的任何位置接收到这些词)。 这些字通常是必需的消息标识,当输入 INGCICS 时,将等待系统等待时间参数为结果定义的时间段。 如果未输入任何词,那么将处理 CMD ,直到收到任何结果为止。
- 路由
- 指定用于选择 CICS 终端或用户接收 REQ=BROADCAST 请求的消息的 CICS 路由信息。 ROUTE= 参数的内容是要提供给 CMSG 事务以将消息路由到 CICS 终端或用户的参数。 请参阅 CMSG 事务以获取该事务的参数的详细信息。
- 目标
- 有关 TARGET 参数的信息,请参阅 TARGET 参数。
- 输出方式
- 有关 OUTMODE 参数的信息,请参阅 OUTMODE 参数。
限制和限制
要使用 INGCICS 命令,必须初始化 系统操作 。 CICS 必须使用 MVS MODIFY 命令为系统控制台命令启用子系统。
用途
INGCICS 命令操作 sysplexwide。 有关概述,请参阅 操作 Sysplexwide 的命令概述。
示例
如果输入 图 1。 INGCICS REQ=CMD 命令对话框面板
图 2。 INGCICS REQ=BROADCAST 命令对话框面板
INGCICS
REQ=CMD ,那么将显示类似于 图 1 的面板。 EVEKYCMD SA z/OS - Command Dialogs Line 1 of 28
Domain ID = IPSFM ---------- INGCICS ---------- Date = 03/05/02
Operator ID = SAUSER Time = 08:23:31
Resource => EYUMAS1A/APL/KEY1 Format: name/type/system
Target => System name, domain ID or sysplex name
Request => CMD CMD, BROADCAST or INFO
CICS Transaction => CEMT I TA
CICS Route =>
CICS Message =>
=>
Tas(0000024) Tra(CONL) Sus Tas Pri( 255 )
Sta(U ) Use(STCUSER ) Uow(B747C4105BD4E305)
Tas(0000026) Tra(COI0) Sus Tas Pri( 255 )
Sta(U ) Use(STCUSER ) Uow(B747C413B3F7A908)
Tas(0000027) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430B48804)
Tas(0000028) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430C33084)
Tas(0000029) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430CFD804)
Tas(0000030) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430DB0684)
Tas(0000031) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430E8D844)
Tas(0000032) Tra(CONM) Sus Tas Pri( 240 )
Sta(U ) Use(STCUSER ) Uow(B747C41430F56504)
Command ===>
PF1=Help PF2=End PF3=Return PF4=DISPINFO PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve
- 资源 字段显示要用于发出请求的 CICS 子系统的名称。 格式为 name/type [/system]。 支持通配符。
- 目标 字段显示应将命令路由至的系统的名称 (系统名称,域标识或综合系统名称)。 仅当资源不是本地综合系统的一部分时,才需要指定此项。
- 请求 字段显示要执行的请求。 可以是 CMD , BROADCAST 或 INFO。
- CICS 事务 字段显示要在资源字段指定的 CICS 子系统上执行的 CICS 事务。
- 当请求为 BROADCAST 时, CICS 路由 字段显示 CMSG 事务的路由参数。
- CICS 消息 字段显示要针对 BROADCAST 请求发送给用户或终端的消息。
- CICS 事务的输出将显示在 CICS 消息 字段之后的空白区域中。
INGCICS REQ=BROADCAST ,那么将显示类似于 图 2 的面板。 EVEKYCMD SA z/OS - Command Dialogs Line 1 of 28
Domain ID = IPSFM ---------- INGCICS ---------- Date = 03/05/02
Operator ID = SAUSER Time = 08:36:12
Resource => EYUMAS1A/APL/KEY1 Format: name/type/system
Target => System name, domain ID or sysplex name
Request => BROADCAST CMD, BROADCAST or INFO
CICS Transaction => CMSG R=&ROUTE,'&MESSAGE',S
CICS Route => ALL
CICS Message => test1
=>
Command ===>
PF1=Help PF2=End PF3=Return PF4=DISPINFO PF6=Roll
PF9=Refresh PF12=Retrieve
发出的 CICS 命令将显示在 CICS 事务 字段中。 &ROUTE 和 &MESSAGE 参数被解析为相应的面板字段。 请勿覆盖显示的命令,因为不执行更改。
如果指定 图 3。 INGCICS REQ=INFO 命令对话框面板
INGCICS REQ=INFO ,那么将显示类似于 图 3 的面板。 EVEKYCMD SA z/OS - Command Dialogs Line 1 of 67
Domain ID = IPSFM ---------- INGCICS ---------- Date = 03/05/02
Operator ID = SAUSER Time = 08:40:30
Resource => EYUMAS1A/APL/KEY1 Format: name/type/system
System => System name, domain ID or sysplex name
Request => INFO CMD, BROADCAST or INFO
CICS Transaction =>
CICS Route =>
CICS Message =>
=>
SYSTEM INFORMATION
Aging( 00500 )
Akp( 04000 )
Cdsasize(00786432)
Cicstslevel(010200)
Cmdprotect(Cmdprot)
Db2conn(SG12)
Dfltuser(STCUSER)
Dsalimit( 05242880 )
Dtrprogram( DFHDYP )
Dumping( Nosysdump )
Ecdsasize(0006291456)
Edsalimit( 0041943040 )
Erdsasize(0013631488)
Esdsasize(0000000000)
Command ===>
PF1=Help PF2=End PF3=Return PF4=DISPINFO PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve
