CREATE TERMINAL

在本地 CICS® 区域中定义 TERMINAL。

语法

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

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

CREATE TERMINAL

CREATE TERMINAL 属性值

条件: ILLOGIC ， INVREQ ， ENGERR 和 NOTAUTH

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

COBOL 程序员注意: 在上述语法中，必须使用 ATTRIBUTES(data-area) 而不是 ATTRIBUTES(data-value)。

描述

CREATE TERMINAL 命令使用命令中指定的属性来安装 TERMINAL 定义。它不使用存储在 CSD 中的资源定义。您可以使用它们来定义个别终端或终端池。

POOL 属性确定您正在使用的方式。没有它，每个命令都定义一个独立的终端。如果已存在具有您在本地 CICS 区域中指定的名称的终端，那么新定义将替换旧定义; 否则，将添加新定义。

要定义池，请对池中的每个终端发出一个 CREATE TERMINAL ATTRIBUTES 命令，并在 ATTRIBUTES 字符串中指定相同的 POOL 值。定义所有终端后，发出 CREATE TERMINAL COMPLETE; $TAG1 CICS $TAG2 收集但直到完成命令之后才安装 TERMINAL 定义。此时，如果本地 CICS 区域中存在同名池，那么 CICS 将删除其所有终端并安装新定义; 否则，将添加新定义。因此，必须一次性定义所有池终端; 不能将终端添加到现有池或包含与现有非池终端同名的终端。

在构建池期间，不得执行下列操作:

更改或省略池名称
定义任何类型的其他资源，包括当前池外部的终端
发出 SYNCPOINT (或任何暗示一个 SYNCPOINT 的命令)
终止任务 (通常)

但是，如果在构建池的过程中迂到错误或问题，那么可以通过发出 CREATE TERMINAL DISCARD 命令在任何时候终止该进程。如果执行此操作，那么 CICS 将废弃部分池定义，包括其所有终端。

与其他 CREATE 命令一样，同步点在 CREATE TERMINAL 处理中是隐式的，除非在处理初期检测到异常情况。当成功处理定义时，将落实对可恢复资源的未落实更改，如果未落实，或者如果指定 DISCARD ，那么将回滚这些更改。对于非池终端，同步点发生在每个 CREATE 命令上。但是，在构建池时，无论您是指定 COMPLETE 还是 DISCARD ，它都仅在结束池定义的命令上出现。请参阅使用 EXEC CICS CREATE 命令来定义资源，以了解管理 CREATE 命令的其他一般规则。

未审计 CREATE 命令，因为其他消息会记录这些命令的操作。

选项

ATTRIBUTES (data-value)

指定要添加的 TERMINAL 的属性。必须使用 TERMINAL 属性中显示的语法将属性列表编码为单个字符串。请参阅 ATTRIBUTES 选项以获取有关指定属性的常规规则，并参阅 TERMINAL 资源以获取有关特定属性的详细信息。

ATTRLEN (data-value)

指定 ATTRIBUTES 选项中提供的字符串长度 (以字节为单位) 作为半字二进制值。长度不能超过 32767 字节。

完成

指定正在构造的终端池定义已完成。只能在定义池的最后一个终端之后使用。

DISCARD

指定不完成正在构造的终端池定义，并且将废弃自池启动以来发出的所有 TERMINAL 定义，并且不添加这些定义。

LOGMESSAGE( cvda )

指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下：

日志: 资源属性将记录到 CSDL 瞬时数据队列中。
NOLOG: 未记录资源属性。

TERMINAL (data-value)

指定要添加的 TERMINAL 定义的 4 字符名称。

条件

ILLOGIC

RESP2 值：

2: 无法执行该命令，因为尚未完成先前的 CONNECTION 或 TERMINAL 池定义。

INVREQ

RESP2 值：

n: ATTRIBUTES 字符串中存在语法错误，或者在处理的废弃或资源定义阶段发生错误。有关 RESP2 值的信息，请参阅 CREATE 和 CSD 命令的 RESP2 值。
7: LOGMESSAGE cvda 值无效。
200: 该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的，或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。

LENGERR

RESP2 值：

1: ATTRLEN 中指定的长度为负数。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。
102: 与发出 CREATE TERMINAL 命令的任务关联的用户不是 USERID 中指定的用户的授权代理。