设置秘密
此命令管理安全请求记录工具所使用的匹配信息。 此信息保存在匹配项中。 匹配的条目用于确定是否记录与应用程序相关联的安全请求。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件： NOTAUTH, NOTFND, INVREQ, DUPREC
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
描述
SET SECRECORDING 命令添加，修改或除去由安全性请求记录工具使用的匹配条目。 保存在匹配条目中的匹配信息用于确定是否记录与事务关联的安全性请求。 如果事务源数据与活动匹配项匹配，那么将启动安全性请求的记录。 对于由具有相同原始数据的记录事务启动的任何事务，也会启动记录。 以后可以使用记录的安全性请求来诊断安全性配置问题。 匹配的条目不会写入 CICS® 目录，因此在 CICS 重新启动时不会保留这些条目。
不支持使用通配符。
选项
- 操作 (cvda)
- ADD
- 添加匹配的条目。
- modify
- 修改匹配的条目。要修改的条目必须处于不活动状态，或者 modify 命令必须将该条目设置为不活动状态。注意： 不能使用修改命令从现有匹配条目中删除原点数据选项。 必须删除匹配条目，并使用修改后的原点数据选项集创建新条目。
- 移除
- 除去匹配的条目。
- MAXIMUM (数据区)
- 使用 ADD 操作时，此字段是必填字段。 该字段包含一个全字值，该值指定匹配条目在进入不活动状态之前与事务原始数据匹配的次数。
值为零将使条目处于不活动状态。
-1的值表示匹配保持激活状态，直到另一条 SECRECORDING SPI 命令停止记录。
该值必须大于或等于 -1 。
- ODADPTRID（数据值）
- 与同名的原始数据字段匹配的 64 个字符的值。
- ODADPTRDATA1 (数据值)
- 与同名的原始数据字段匹配的 64 个字符的值。
- ODADPTRDATA2 (数据值)
- 与同名的原始数据字段匹配的 64 个字符的值。
- ODADPTRDATA3 (数据值)
- 与同名的原始数据字段匹配的 64 个字符的值。
- ODAPPLID（数据区域）
- 与同名的原始数据字段匹配的 8 字符值。
- ODCLNTIPADDR (数据值)
- 与同名的原始数据字段匹配的 39 个字符的值。
- ODCLNTPORT (数据值)
- 与同名的原始数据字段匹配的全字二进制值。
- ODFACILNAME (数据值)
- 与同名的原始数据字段匹配的 8 字符值。
- ODFACILTYPE (cvda)
- 与同名的原始数据字段匹配的 CVDA 值。 可能的 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）
- 与同名的原始数据字段匹配的 CVDA 值。 可能的 CVDA 值为:
- IPV4
- 该地址以 IPv4 点分十进制地址格式指定。
- IPV6
- 该地址以 IPv6 冒号十六进制地址格式指定。
- ODLUNAME (数据值)
- 与同名的原始数据字段匹配的 8 字符值。
- ODNETID (数据值)
- 与同名的原始数据字段匹配的 8 字符值。
- ODNETWORKID (数据区)
- 与同名的原始数据字段匹配的 8 字符值。
- ODSERVERPORT (数据值)
- 与同名的原始数据字段匹配的全字二进制值。
- ODTCPIPS (数据值)
- 与同名的原始数据字段匹配的 8 字符值。
- ODTRANSID (数据值)
- 与同名的原始数据字段匹配的 4 字符值。
- ODUSERID (数据值)
- 与同名的原始数据字段匹配的 8 字符值。
- SECRE录制 (数据值)
- 指定用于标识匹配条目的 8 字符名称。
有效字符如下：
0-9 A-Z a-z - _
条件
- 转储
- RESP2 值：
- 1
- 请求添加新的匹配条目失败，因为该匹配条目已存在。
- INVREQ
- RESP2 值：
- 1
- 操作无效。
- 2
- ODFACILTYPE 无效。
- 3
- ODIPFAMILY 无效。
- 4
- 最大值小于 -1.
- 5
- 正在修改的条目处于活动状态，并且未在 MODIFY 命令中指定最大值 0。
- 6
指定的匹配条目名称包含无效字符。
作为匹配条目名称的第一个字符的下划线 (
_) 保留给 CICS 提供的程序。- 7
- 未指定必需选项 MAXIMUM。
- NOTAUTH
- RESP2 值：
- 100
- 用户无权使用 SET SECRE呢编码命令。
- NOTFND
- RESP2 值：
- 1
- 指定的条目不存在。