UPDATE

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

读取语法图跳过可视语法图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(data-ref) REASON(data-ref)

描述

此命令根据您指定的属性值更新现有 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 应用程序。

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

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

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

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

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

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

THREAD(cpsm-token)
标识要用于此操作的 API 线程。 用于标识线程的 cpsm-token 值由 CONNECT 命令返回。

条件

以下是可由 UPDATE 命令返回的 RESPONSE 值的列表。 每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。
确定
该命令已成功完成处理。
发生了错误
由于下列其中一个原因，发生了环境错误:
无服务
应用程序存根程序无法装入 API 服务模块。
无存储器
应用程序存根程序无法在正在运行处理线程的地址空间中获取必需的存储器。
未处理
仅对于 CSD 请求，该请求所指向的其中一个 MAS 无法处理该请求。
请求超时
请求所针对的其中一个或多个 CMAS 未响应。
SOCRESOURCE
CMAS 拥有的必需资源不可用。
FAILED
由于下列其中一个原因，该命令失败:
异常终止
命令处理异常结束。
EXCEPTION
命令处理迂到异常情况。
INVALIDATA
由于下列其中一个原因，发生了无效数据错误:
modify
MODIFY 缓冲区中列出的属性值对于指定的属性无效。
NotSupported
MODIFY 缓冲区中列出的属性不可修改。
无效命令
由于以下原因，该命令无效:
LENGTH
命令上所有选项的总长度超过最大限制。
INVALIDPARM
检测到无效参数。 将返回无效的参数作为原因值:
  • 上下文
  • FROM
  • LENGTH
  • modify
  • OBJECT
  • 参数 (parm)
  • 参数
  • RESULT
  • 太棒了
请检查命令描述以获取有效的参数语法。
NOTAVAILABLE
由于下列其中一个原因，发生了不可用的情况:
APITASK
API 控制子任务未处于活动状态。
CMAS
请求所定向到的 CMAS 不可用。
CPSMAPI
处理线程所连接的 CMAS 不可用于 API 处理。
CSDAPI
不支持 CICSPlex SM API 访问 CICS CSD。
MAINTPOINT
当前上下文的维护点不可用。
不允许
由于以下原因发生了不允许的情况:
USRID
与处理线程关联的用户标识没有必需的安全权限。
服务器 GONE
处理线程所连接的 CMAS 不再处于活动状态。
表错误
由于下列其中一个原因，资源表记录无效:
数据错误
与一个或多个资源表属性关联的值无效。 如果发生以下情况，可能会发生此错误:
  • 资源表缺少必需属性，包含一个或多个冲突属性或不存在。
  • CICS 资源定义包含将导致 EXEC CICS CREATE 命令发出警告的属性。
使用 FEEDBACK 命令可检索有关此错误的其他数据。
INVALIDATTR
其中一个资源表属性无效。
无效
CICSPlex SM不支持指定版本的资源表。
版本 INVL
由于下列其中一个原因，发生了版本冲突:
NotSupported
不支持用于此命令的应用程序存根程序的版本。
NOTVSNCONN
用于此命令的应用程序存根程序的版本与用于 CONNECT 命令的版本不同。