指定视图

构建给定资源表的定制视图。

描述

此命令用于构建给定资源表的定制视图。

只能为具有 CICS ® 资源类型的资源表构建视图。
视图与构建它们的特定处理线程相关联; 它们不能由其他处理线程共享。
终止处理线程时，将删除由其构建的任何视图。
分配给视图的名称优先于任何现有资源表名称。您可以重新定义现有资源表名称以表示该资源表的定制视图。
建议您对尚未分配给其他定制视图或 CICSPlex ® SM提供的资源表的定制视图使用名称。如果使用已分配的名称，那么您应该知道您的处理可能会受到影响。有关更多详细信息，请参阅开发 CICSPlex SM 应用程序。
升级到更高版本的 CICSPlex SM时，应检查任何新的资源表是否与任何定制视图具有相同的名称。有关更多详细信息，请参阅开发 CICSPlex SM 应用程序。

FIELDS(数据区): 标识包含要用于此操作的顺序表达式的缓冲区。
有关如何将订单表达式与指定 VIEW 命令配合使用的详细信息，请参阅开发 CICSPlex SM 应用程序。

注: 不能在订单表达式中指定 EYU_CICSNAME 或 EYU_CICSREL 属性。
LENGTH(数据值): 指定 FIELDS 缓冲区长度的全字值。
注: 您指定的缓冲区长度不应包含除顺序表达式以外的任何数据。
OBJECT(数据值): 标识要为其创建视图的资源表。此值必须是有效 CICS 资源表的 1-to 8 字符名称。有关按类型列出的 CICSPlex SM 资源表的列表，请参阅开发 CICSPlex SM 应用程序。
REASON(数据引用): 指定变量以接收此命令返回的全字原因值。
RESPONSE(数据引用): 指定一个变量以接收此命令返回的全字响应值。
THREAD(cpsm-token): 标识要用于此操作的 API 线程。用于标识线程的 cpsm-token 值由 CONNECT 命令返回。
VIEW(数据值): 定义要构建的视图的 1-to 8 字符名称。

以下是可由指定 VIEW 命令返回的 RESPONSE 值的列表。每个 RESPONSE 的描述都包含关联的 REASON 值的列表 (如果适用)。

确定

该命令已成功完成处理。

转储

由于以下原因，发生了重复情况:

发生了错误

由于下列其中一个原因，发生了环境错误:

FAILED

由于下列其中一个原因，该命令失败:

无效命令

由于以下原因，该命令无效:

INVALIDPARM

在命令字符串或 FIELDS 缓冲区中检测到无效参数。将返回无效的参数作为原因值:

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

NOTAVAILABLE

由于下列其中一个原因，发生了不可用的情况:

未找到

由于以下原因发生了 "找不到" 情况:

服务器 GONE

处理线程所连接的 CMAS 不再处于活动状态。

表错误

由于下列其中一个原因，资源表记录无效:

数据错误: 与一个或多个资源表属性关联的值无效。如果资源表缺少必需属性，包含一个或多个冲突属性或不存在，那么可能会发生此错误。使用 FEEDBACK 命令可检索有关此错误的其他数据。
无效: CICSPlex SM不支持指定版本的资源表。

版本 INVL

由于下列其中一个原因，发生了版本冲突: