INGCICS

用途

INGCICS 命令允许您:

  • 发出任何启用控制台的 CICS® 事务。
  • 向所有或所选 CICS 用户广播消息。
  • 发出已定义事务的列表并查看输出。
  • 以全屏或可移行方式显示 CICS 事务的输出。

语法

读取语法图跳过可视语法图INGCICS资源 命令规范广播规范信息说明TARGET=系统名称Domain_id树名OUTMODE=LINEAUTONETLOG
命令指定
读取语法图跳过可视语法图REQ=CMDCMD= cics_transactionMSG= 消息标识
广播规范
读取语法图跳过可视语法图REQ=BROADCASTMSG= 消息ROUTE= cics_route_options
信息说明
读取语法图跳过可视语法图REQ=INFO

参数

资源
资源指定将向其发出命令的 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 的命令概述

示例

如果输入 INGCICS REQ=CMD ,那么将显示类似于 图 1 的面板。
图 1。 INGCICS REQ=CMD 命令对话框面板
 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 的面板。
图 2。 INGCICS REQ=BROADCAST 命令对话框面板
 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 参数被解析为相应的面板字段。 请勿覆盖显示的命令,因为不执行更改。

如果指定 INGCICS REQ=INFO ,那么将显示类似于 图 3 的面板。
图 3。 INGCICS REQ=INFO 命令对话框面板
 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