UPDATE

更新现有 CICSPlex ® SM 或 CICS® 定义。

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

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

读取语法图跳过可视语法图UPDATEOBJECT(data-value) FROM(data-area)RESULT(cpsm-令牌)MODIFY(data-area)LENGTH(data-value) PARM(data-area)PARMLEN(data-value)CONTEXT(data-value)SCOPE(data-value)THREAD(cpsm-令牌) RESPONSE(数据参考) REASON(数据参考)

描述

此命令根据您指定的属性值更新现有 CICSPlex SM 或 CICS 定义。
  • 更新后的定义将替换 CICSPlex SM 数据存储库中的现有定义。
  • 对于将 CICSplex 作为其上下文 (例如工作负载管理或实时分析定义) 的定义，还会在管理 CICSplex 所涉及的所有 CMAS 的数据存储库中更新该定义。

相关命令

  • CREATE
  • REMOVE

选项

CONTEXT(数据值)
标识此命令的上下文。 上下文必须是 CMAS 或 CICSplex 的 1-to 8 字符名称。

如果未指定 CONTEXT 选项，那么将采用线程的缺省上下文。

FROM(数据区)
标识包含表示要更新的定义的资源表记录的缓冲区。

该记录必须包含在 OBJECT 选项上指定的资源表的所有属性。 对于不想指定的可选属性，请将该字段设置为空 (即零) 值。

LENGTH(数据值)
一个全字值，用于指定 FROM 或 MODIFY 缓冲区的长度。
注: 指定的缓冲区长度不应包含除资源表记录或修改表达式以外的任何数据。
MODIFY(数据区)
标识包含要用于修改 CICS 定义资源表记录的修改表达式的缓冲区。

有关如何构成修改表达式的详细信息，请参阅 CICSPlex SM API 概述。

OBJECT(数据值)
标识表示要更新的定义的资源表。 此值必须是有效 CICSPlex SM 定义或 CICS 定义资源表的 8 字符名称。 有关按类型列出的 CICSPlex SM 资源表的列表，请参阅 CICSPlex SM API 概述。
PARM(数据区)
标识包含要用于更新定义的参数表达式的缓冲区。

有关如何将参数表达式与 UPDATE 命令配合使用的详细信息，请参阅 CICSPlex SM API 概述。 有关对给定资源表有效的参数的描述，请参阅 CICSPlex SM 资源表。

PARMLEN(数据值)
指定 PARM 缓冲区长度的全字值。
REASON(数据引用)
指定变量以接收此命令返回的全字原因值。
RESPONSE(数据引用)
指定一个变量以接收此命令返回的全字响应值。
RESULT (cpsm-token)
标识此操作要处理的 API 结果集。 结果集必须包含 CICS 定义资源表记录。 将根据您在 MODIFY 缓冲区中提供的修改表达式来更新记录。
结果集可以是由以下任何命令生成的结果集:
  • COPY
  • GET
  • GROUP
  • PERFORM OBJECT
SCOPE(数据值)
标识此命令的作用域。

如果当前上下文 (如此命令或先前的 CONNECT 或 QUALIFY 命令所设置) 是 CICSplex ，并且 OBJECT 选项标识 CICS 定义资源，并且 PARM 选项包含 CSD 参数，那么可以指定有效作用域。

作用域可以是 CICSplex 中的 CICS 系统。 如果当前上下文是 CMAS 或 OBJECT 选项标识任何其他类型的资源表，或者未在 CICS 定义资源上指定 CSD 参数，那么此选项没有意义，将被忽略。

如果 SCOPE 应用于命令并且未指定 SCOPE 选项，那么将采用线程的缺省作用域。 如果当前上下文是 CICSplex ，并且未在 CONNECT 或 QUALIFY 命令上设置缺省作用域，那么您将接收到 SCOPE 选项的 INVALIDPARM 响应。

主题 （cpsm-令牌）
标识要用于此操作的 API 线程。 标识线程的 cpsm-token 值由 CONNECT 命令返回。

条件

以下是可由 UPDATE 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
1024 正常
该命令已成功完成处理。
1028 无效参数
检测到无效参数。 将返回无效的参数作为原因值:
  • 1280 线程
  • 1281 对象
  • 1282 上下文
  • 1283 结果
  • 1285 长度
  • 1296 开始
  • 1307 修改
  • 1315 PARM
  • 1316 PARMLEN

请检查命令描述以获取有效的参数语法。

1029 失败
由于下列其中一个原因，该命令失败:
1331 异常终止
命令处理异常结束。
1359 异常
命令处理迂到异常情况。
1030 发生了错误
由于下列其中一个原因，发生了环境错误:
1321 社会资源
CMAS 拥有的必需资源不可用。
1342 请求超时
请求所针对的其中一个或多个 CMAS 未响应。
1357 无存储器
应用程序存根程序无法在正在运行处理线程的地址空间中获取必需的存储器。
1358 无服务
应用程序存根程序无法装入 API 服务模块。
1378 未处理
仅对于 CSD 请求，该请求所指向的其中一个 MAS 无法处理该请求。
1031 不允许
由于以下原因发生了不允许的情况:
1345 USRID
与处理线程关联的用户标识没有必需的安全权限。
1033 服务器 GONE
处理线程所连接的 CMAS 不再处于活动状态。
1034 不可用
由于下列其中一个原因，发生了不可用的情况:
1323 Maintpoint
当前上下文的维护点不可用。
1334 CPSMAPI
处理线程所连接的 CMAS 不可用于 API 处理。
1340 APITASK
API 控制子任务未处于活动状态。
1362 CMAS
请求所定向到的 CMAS 不可用。
1375 CSDAPI
不支持 CICSPlex SM API 访问 CICS CSD。
1035 版本 INVL
由于下列其中一个原因，发生了版本冲突:
1335 不支持
不支持用于此命令的应用程序存根程序的版本。
1336 notvsnconn
用于此命令的应用程序存根程序的版本与用于 CONNECT 命令的版本不同。
1036 无效cmd
由于以下原因，该命令无效:
1285 长度
命令上所有选项的总长度超过最大限制。
1038 表错误
由于下列其中一个原因，资源表记录无效:
1337 invalidattr
其中一个资源表属性无效。
1354 无效
CICSPlex SM不支持指定版本的资源表。
1361 数据错误
与一个或多个资源表属性关联的值无效。 如果发生以下情况，可能会发生此错误:
  • 资源表缺少必需属性，包含一个或多个冲突属性或不存在。
  • CICS 资源定义包含将导致 EXEC CICS CREATE 命令发出警告的属性。

使用 FEEDBACK 命令可检索有关此错误的其他数据。

1041 无效数据
由于下列其中一个原因，发生了无效数据错误:
1307 修改
MODIFY 缓冲区中列出的属性值对于指定的属性无效。
1335 不支持
MODIFY 缓冲区中列出的属性不可修改。