查询秘密

检索用于确定在启动新任务时是否生成安全请求记录的匹配控制块条目。

语法

警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。

查询秘密

读取语法图跳过可视语法图INQUIRE SECRECORDING( data-value)optionsMAXIMUM(data-area)CURRENT(data-area)
选项
读取语法图跳过可视语法图ODADPTRID( data-value)ODADPTRDATA1( data-value)ODADPTRDATA2( data-value)ODADPTRDATA3( data-value)ODAPPLID( data-value)ODCLNTIPADDR( data-value)ODCLNTIPADDR( data-value)ODCLNTPORT( data-value)ODFACILNAME( data-value)ODFACILTYPE( data-value)ODIPFAMILY( data-value)ODLUNAME( data-value)ODNETID( data-value)ODNETWORKID( data-value)ODSERVERPORT( data-value)ODTCPIPS( data-value)ODTRANSID( data-value)ODUSERID( data-value)

条件: NOTAUTH , NOTFND , ILLOGIC 和 END

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

返回所请求的有关指定匹配项的信息。 不会对匹配的条目进行编目,并且在区域重新启动时不会恢复这些条目。

浏览

您还可以使用 INQUIRE SECRE呢命令上的浏览选项 (START , NEXT 和 END) 来浏览系统上的所有匹配条目。 请参阅 浏览资源定义 ,以获取有关浏览的常规信息,包括语法,异常条件和示例。

选项

CURRENT (区域值)
返回当前匹配数的全字。
MAXIMUM (数据区)
返回最大匹配值的全字。

值为零表示匹配条目处于不活动状态。

-1 值表示匹配条目处于活动状态,匹配将继续进行,直到发出 SECRECORDING SPI 命令停止与该条目匹配。

大于 1 的值指示匹配条目处于活动状态,并且将继续匹配,直到达到最大匹配数为止。

ODADPTRID(数据值)
在 64 个字符的区域中返回适配器标识匹配值。 如果未将此字段添加到匹配项,那么 ODADPTRID 将返回空白。
ODADPTRDATA1 (数据值)
在 64 个字符的区域中,返回适配器数据标识匹配值。 如果未将此字段添加到匹配项 ODADPTRDATA1 中,那么将返回空白。
ODADPTRDATA2 (数据值)
在 64 个字符的区域中,返回适配器数据标识匹配值。 如果未将此字段添加到匹配项 ODADPTRDATA2 中,那么将返回空白。
ODADPTRDATA3 (数据值)
在 64 个字符的区域中,返回适配器数据标识匹配值。 如果未将此字段添加到匹配项 ODADPTRDATA3 中,那么将返回空白。
ODAPPLID(数据区域)
返回 8 字符 APPLID 匹配值。 如果未将此字段添加到匹配项 ODAPPLID ,那么将返回空白。
ODCLNTIPADDR (数据值)
将 TCP/IP 客户机匹配值的 IP 地址返回到 39 个字符的区域中。 如果未将此字段添加到匹配项 ODCLNTAPADDR ,那么将返回空白。
ODCLNTPORT (数据值)
以全字二进制格式返回与值匹配的客户机端口。 如果未将此字段添加到匹配的条目 ODCLNTPORT ,那么返回零。
ODFACILNAME (数据值)
将与值匹配的设施名称返回到 8 字符区域中。 如果未将此字段添加到匹配项 ODFACILNAME ,那么将返回空白。
ODFACILTYPE (cvda)
返回用于标识匹配设施类型的 CVDA 值。 如果未将此字段添加到匹配的条目 ODFACILTYPE 返回 UNKNOWN。 可能的 CVDA 值为:
APPC
LU 6.2 (APPC) 连接
ASRUNTRAN
异步运行事务
BRIDGE
3270 网桥设施虚拟终端
EVENT
事件处理通道
IIOP
因特网 ORB 间协议
IPECI
IP ECI 客户机对话会话
IPIC
IP 互连会话 (IP interConnectivity session , IPCONN)
JVMSERVER
JVM 服务器
LU61
LU 6.1 会话
MRO
MRO 会话
NODEJSAPP
NODE.JS APPLICATION
NONE
没有与此任务关联的设施
RRSUR
恢复管理器恢复单元
RZINSTOR
请求流 (RZ) instore 传输客户机
SCHEDULER
调度程序计时器请求条目
SOCKET
套接字域会话条目
START
与非终端相关的 START 元素
STARTTERM
与终端相关的 START 元素
TERMINAL
终端项
传输数据
瞬时数据目标条目
WEB
CICS® Web Support 会话
XMRUNTRAN
CICS 业务事务服务 (BTS) 活动
家庭组织(cvda)
返回一个值,该值指示与该值匹配的 IP 系列。 如果未将此字段添加到匹配的条目 ODIPFAMILY 返回 UNKNOWN。 可能的 CVDA 值为:
IPV4
该地址以 IPv4 点分十进制地址格式指定。
IPV6
该地址以 IPv6 冒号十六进制地址格式指定。
UNKNOWN
未设置 ODIPFAMILY 匹配值。
ODLUNAME (数据值)
返回与值匹配的 8 字符网络逻辑单元名称。 如果未将此字段添加到匹配项ODL联阿援助团返回空白。
ODNETID (数据值)
返回 8 字符网络标识匹配值。 如果未将此字段添加到匹配项 ODNETID ,那么将返回空白。
ODNETWORKID (数据区)
返回与值匹配的 8 字符网络限定符。 如果未将此字段添加到匹配项 ODNETWORKID ,那么将返回空白。
ODSERVERPORT (数据值)
以全字二进制格式返回与值匹配的侦听 IP 端口号。 如果未将此字段添加到匹配的条目 ODSERVERPORT ,那么返回零。
ODTCPIPS (数据值)
返回与值匹配的 TCPIPSERVICE 资源的 8 字符名称。 如果未将此字段添加到匹配项 ODTCPIPS ,那么将返回空白。
ODTRANSID (数据值)
返回与值匹配的 4 字符事务名称。 如果未将此字段添加到匹配项 ODTRANSID ,那么将返回空白。
ODUSERID (数据值)
返回与该值匹配的 8 字符用户标识。 如果未将此字段添加到匹配项 ODUSERID 返回空白。
SECRE录制 (数据值)
指定用于标识匹配条目的 8 字符名称。 有效字符包括 A-Z , a-z , 0-9 ,短划线 (-) 和下划线 (_)。

条件

END
RESP2 值:
2
没有更多此类型的匹配条目可用。
ILLOGIC
RESP2 值:
1
当此资源类型的浏览已在进行时,发出了 START 命令,或者当此资源类型的浏览未在进行时,发出了 NEXT 或 END 命令。
NOTAUTH
RESP2 值:
100
与发出任务关联的用户无权使用此命令。
NOTFND
RESP2 值:
1
指定的条目不在匹配的表中。