设置关联 usercorrdata

覆盖发端任务的用户相关因子数据。

语法

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

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

设置关联 usercorrdata

读取语法图跳过可视语法图SET ASSOCIATION USERCORRDATA( data-value)

条件: INVREQ 和 NOTAUTH

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

此命令是线程安全的。

描述

原始任务可以调用全局用户退出程序,该程序获取用户关联数据(例如,从 HTTP或 MQ 消息中获取),然后发送 SET ASSOCIATION USERCORRDATA 以覆盖原始任务的USERCORRDATA字段。

重要信息: SET ASSOCIATION USERCORRDATA 命令覆盖 USERCORRDATA 字段; 它不会尝试在该字段中保留现有用户相关因子数据。 因此,确保用户相关因子数据的完整性是用户的责任。 建议您在发出 SET ASSOCIATION USERCORRDATA 以覆盖 USERCORRDATA 字段之前,在发端任务的 USERCORRDATA 字段后发出 INQUIRE ASSOCIATION 以进行查询,并在需要时执行必要的操作以保留现有数据 (如果有)。

发出 SET ASSOCIATION USERCORRDATA 的任务必须具有与发端任务相同的任务号; 否则,将发出 RESP2 值为 1 的 INVREQ 响应。

未审计 SET ASSOCIATION USERCORRDATA 命令。

选项

USERCORRDATA (data-value)
指定用户相关因子数据以覆盖发端任务的 USERCORRDATA 字段。
警告:
USERCORRDATA 字段限制为 64 字节。 如果指定的数据值超过限制,那么当复制到 USERCORRDATA 字段时,会将其截断为 64 字节,但不会发出任何消息来指示已发生截断。 因此,确保用户相关因子数据的完整性是用户的责任。

条件

INVREQ
RESP2 值:
1
发出任务不是发端任务。 仅允许发端任务发出 SET ASSOCIATION USERCORRDATA
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。