SET TERMINAL

描述

SET TERMINAL 命令更改指定终端定义的某些值。 它不能用于 APPC 会话。

只有 PURGETYPE ， PURGE 或 FORCEPURGE 可用于 IRC 会话。

如果终端 TCTTE 在远程系统中可用，那么可以采用模型或代理形式，在远程定义中可以对 TRACOR 或 NEXTTRANSID 进行更改。 此更改不会运回 TOR。 这允许用户进行仅适用于远程 TCTTE 的更改。

SET TERMINAL 命令还可用于更改代理终端的 UCTRANST 选项。 此更改将运回 TOR 和中间系统。 任何更改模型或代理终端的任何其他属性的尝试都会导致 RESP2=24的 INVREQ。

未审计 SET TERMINAL 命令。

选项

ACQSTATUS (cvda) (仅限z/OS® Communications Server )

仅出于兼容性目的保留此选项。 您应该在新应用程序中使用 TERMSTATUS 选项。

ALTPRINTER (data-value)

指定 3270 打印机的名称，以用作在 PRINTER 选项上定义的打印机的替代项。 该名称最多可包含 4 个字符。

注: 不能对未定义主打印机 (在 PRINTER 参数上) 的终端指定 ALTPRINTER。

有关用于定义终端的主打印机和备用打印机的 PRINTER 和 ALTPRINTER 参数的信息，请参阅 TERMINAL 资源 。

注: 对于 z/OS Communications Server 终端，在事务路由环境中，此命令直到指定终端的从 TOR 到 AOR 的链接中的下一个流才会生效。

ALTPRTCOPYST (cvda)

指定备用打印机复制状态。 这指示 CICS® 是否要使用硬件 COPY 功能来满足在 ALTPRINTER 参数上指定的打印机上的打印请求。 CVDA 值包括：

ALTPRTCOPY

CICS 将使用硬件 COPY 功能来满足备用打印机上的打印请求。

NOALTPRTCOPY

CICS 不使用硬件 COPY 功能。

注: 不能对未定义备用打印机的终端指定 ALTPRTCOPY。

请参阅 TERMINAL resources 以获取有关 ALTPRINTCOPY 参数的信息，该参数指定在终端定义上对备用打印机使用硬件复制功能。

ATISTATUS (cvda)

指定终端是否可以由从 CICS 中自动启动的事务使用，或者，如果终端是 ISC 会话，那么是否由将此会话用作与另一系统进行通信的备用设施的事务使用。 CVDA 值包括：

ATI

该终端可由自动启动的事务使用。

诺亚迪

自动启动的事务无法使用该终端。

终端的状态不能同时为 NOATI 和 NOTTI。

CREATESESS (cvda) (仅限z/OS Communications Server )

指定终端是否可由 ATI 事务自动获取。 CVDA 值包括：

创建

终端可以自动获取。

无创建

无法自动获取终端。

离散化 (cvda)

指定 CICS 是否同意来自终端的断开连接请求。 CVDA 值包括：

DISCREQ

CICS 接受 z/OS Communications Server 设备的断开连接请求，并发出 z/OS Communications Server CLSDST 宏指令以终止与该逻辑单元的 z/OS Communications Server 会话。

这也意味着来自终端的 CESF LOGOFF (或 GOODNIGHT) 会导致断开连接。

无离散性

CICS 不接受 z/OS Communications Server 设备的断开连接请求。

EXIT跟踪 (cvda)

指定是否跟踪与终端出口程序相关联的活动。 CVDA 值包括：

出口跟踪

将跟踪出口程序活动。

NOEXITTRACE

不跟踪出口程序活动。

MAPNAME (数据区)

指定要由 CICS 保存 (存储) 的映射的 7 字符名称作为发送到此设备的最后一个映射的名称。 如果此终端是代理，那么在当前正在执行的事务终止时，将以 DETACH 序列将指定的映射名称返回到终端拥有区域，除非映射名称被后续的 SEND MAP 命令取代。 可以使用 MAPNAME 选项来恢复在先前 INQUIRE TERMINAL 命令中返回到应用程序的映射名称。 如果 BMS 不支持该终端 (例如，此终端是会话) ，那么将使用 RESP2 值 60 生成 INVREQ 条件。

MAPSETNAME (数据区)

指定要由 CICS 保存的映射集的 8 字符名称作为在为此终端处理的 SEND MAP 命令中使用的最后一个映射集的名称。 如果此终端是代理，那么当当前正在执行的事务终止时，将在 DETACH 序列中向终端拥有区域返回指定的映射集名称，除非映射集名称被后续的 SEND MAP 命令取代。 可以使用 MAPSETNAME 选项来恢复在先前 INQUIRE TERMINAL 命令中返回到应用程序的映射集名称。 如果 BMS 不支持该终端 (例如，此终端是会话) ，那么将使用 RESP2 值 60 生成 INVREQ 条件。

NEXTTRANSID (data-value)

指定指定终端的下一个事务标识。 标识最长可以为 4 个字符。 如果将 NEXTTRANSID 参数指定为空白 (X'4040404040 ') ，那么 CICS 会将下一个事务标识设置为空，这意味着没有为终端定义 NEXTTRANSID。

允许对远程 TCTTE 进行更改，但不会将更改运回 TOR。

注: 如果已为此终端定义事务，那么无法设置 NEXTTRANSID。

OBFORMATST (cvda)

指定设备是否支持外部格式化。 请参阅 TYPETERM 资源 ，以获取支持外部格式化的设备类型的详细信息。 CVDA 值包括：

NOOBFORMAT

设备不支持外部格式化。

OBFORMAT

该设备支持舷外格式化。

注: 不能为控制台或 3790 指定 OBFORMATST。

OPERID (data-value)

指定要与终端关联的操作员标识代码。 标识代码最长可以为 3 个字符。 操作员标识码将继续与终端相关联，直到它被另一个 SET TERMINAL OPERID 命令更改为止，或者直到在终端注册的用户更改为止 (即直到用户在终端注册或注销为止)。

PAGESTATUS (cvda)

指定如何写入页面。 CVDA 值包括：

可自动分页

在系列中的第一个页面之后，将自动写入终端。

页面电缆

在系列中的第一个页面之后，将根据操作员的请求将页面写入终端。

PRINTER (data-value)

指定要用于响应打印请求 (ISSUE PRINT 命令或来自操作员按程序访问 (PA) 键的 PRINT 请求) 的主打印机 CICS 的名称。 名称最长可以为 4 个字符。 有关指定 3270 类型打印机的信息，请参阅 打印终端 。

注: 对于 z/OS Communications Server 终端，在事务路由环境中，此命令直到指定终端的从 TOR 到 AOR 的链接中的下一个流才会生效。

PRTCOPYST (cvda)

指定 CICS 是否使用硬件 COPY 功能来满足在 PRINTER 参数上指定的打印机上的打印请求。 CVDA 值包括：

无 PRTCOPY

CICS 不使用硬件 COPY 功能。

PRTCOPY

CICS 将使用硬件 COPY 功能来满足主打印机上的打印请求。

注: 不能为未定义打印机的终端指定 PRTCOPY。

请参阅 终端资源 以获取有关 PRINTCOPY 参数的信息，该参数指定在终端定义上对主打印机使用硬件复制功能。

PURGETYPE (cvda)

指定是否可以清除与指定终端一起运行的事务。 CVDA 值包括：

CANCEL

将取消排队等待指定终端的 AID。 将取消表示在本地 CICS 系统中等待指定终端的已调度和已分配请求的 AID。 但是，不会取消具有已启动的关联触发任务的 CRSR AID 和 TD AID。

当发现已取消的已调度请求在远程 CICS 系统中具有前兆时，将异步取消此远程 AID。 将消息 DFHTF0100 写入 CSMT 以指示已删除终端的 AID 数和剩余 AID 数。

FORCEPURGE

将立即清除事务。 这可能会导致不可预测的结果，应该只在出现异常情况时使用。

终止

将终止该任务。 不保证系统和数据完整性。 KILL 选项可扩展 PURGE 和 FORCEPURGE 选项的功能。 只有在已经尝试对任务执行 PURGE 或 FORCEPURGE 操作之后，才使用此命令。 KILL 选项不保证任何完整性，但是在某些情况下，它可以让用户释放已停止的区域，使这个区域能继续处理。 在某些情况下，例如，如果在回退处理过程中终止了任务，CICS 会异常终止。

PURGE

仅当可以维护系统和数据完整性时，才能终止事务。 如果事务的定义指定了 SPURGE=NO ，那么不会清除该事务。

FORCEPURGE 替换了 PURGE FORCE ，仅出于兼容性目的保留。 您应该在新应用程序中使用 FORCEPURGE。

不能为非z/OS Communications Server 终端指定 PURGETYPE。

RELREQST (cvda)

指定释放逻辑单元的状态。 CVDA 值包括：

NORELREQ

CICS 不会在另一个 z/OS Communications Server 应用程序请求时释放逻辑单元。

RELREQ

如果逻辑单元当前未忙于运行事务，那么 CICS 将释放逻辑单元。

服务器状态 (cvda)

指定终端是在服务中还是在服务外。 CVDA 值包括：

INSERVICE

CICS 将设置终端在服务中并且可供使用。

OUTSERVICE

CICS 将设置终端服务外，并且不可用于事务。 除非指定 PURGE 或 FORCEPURGE ，否则允许任何当前事务正常终止，但不允许其他事务使用终端。

如果执行诊断工具 (EDF) 正在指定的终端上使用，那么 EDF 将立即停止，因为它是单独事务的序列，而允许在 EDF 下测试的事务完成。

如果将 z/OS Communications Server 终端设置为 OUTSERVICE ，那么该终端也将被释放，并且将立即或在当前事务终止时注销操作程序。 因此，不能将与正在执行的事务关联的终端设置为 OUTSERVICE ，除非它是打印机。

TCAMCONTROL (data-value) (仅限 TCAM/DCB 远程终端)

废弃。 TCAM 终端不受支持。

TERMINAL (data-value)

指定 4 字符的终端名称。

注: 由于 XICTENF 和 XALTENF 全局用户出口的操作， SCHEDULE 请求有可能排队等待尚未定义到本地 CICS 系统的终端。 可以使用 SET TERMINAL (data-value) CANCEL 命令来除去这些请求。

TERMPRIORITY (data-value)

以全字二进制值的形式指定终端相对于其他终端所需的优先级，范围为 0-255。

TERMSTATUS (cvda) (仅限z/OS Communications Server )

指定此终端所表示的逻辑单元的会话状态。 CVDA 值包括：

ACQUIRED

CICS 将获取与此终端所表示的逻辑单元的会话。

COLDACQ

CICS 将获取与此终端表示的逻辑单元的会话，其中不需要再同步。

RELEASED

CICS 将终止会话。 如果还指定了 PURGE 选项，那么会立即发生此情况，否则在当前活动事务完成时将终止会话。

跟踪 (cvda)

指定与终端关联的必需跟踪活动。 CVDA 值包括：

特殊跟踪

将使用特殊跟踪。

节跟踪

将使用标准跟踪。

允许对远程 TCTTE 进行更改，但不会将更改运回 TOR。

TTISTATUS (cvda)

指定此终端是否可由从此终端启动的事务使用。 CVDA 值包括：

诺蒂

此终端不能由从中启动的事务使用。

TTI

此终端可由从中启动的事务使用。

不能同时使用 NOATI 和 NOTTI 定义终端。

UCTRANST (cvda)

指定是否为此终端关联的事务设置大写转换选项。 请注意，概要文件定义上还有一个 UCTRAN 选项。 有关终端上的 UCTRAN 选项与交易配置文件如何交互的信息，请参见表 1。

如果终端 TCTTE 在远程系统中可用，那么可以采用模型或代理形式，在远程定义中可以对 TRACOR 或 NEXTTRANSID 进行更改。 此更改不会运回 TOR。 这允许用户进行仅适用于远程 TCTTE 的更改。 SET TERMINAL 命令还可用于更改代理终端的 UCTRANST 选项。 此更改将运回 TOR 和中间系统。 尝试更改模型或代理终端的任何其他属性会导致 INVREQ 具有 RESP2=24。

如果指定的终端是发出该命令的任务的主体设施，那么可以使用此命令来设置远程终端的大写转换选项。 如果远程终端不是主体设施，那么会使用 RESP2 值 24 生成 INVREQ 条件。 在终端拥有区域和菊花链设置中的任何中间区域中也会更改大写转换选项。 CVDA 值包括：

NOUCTRAN

CICS 不会对此终端的输入执行大写转换 (除非在个别事务的概要文件上另行指定)。

仅 TRANIDONLY

CICS 将仅在来自此终端的输入上对事务标识执行大写转换。

UCTRAN

CICS 将对此终端的输入执行大写转换。

表 1. UTRAN 参数的影响

概要文件		终端 (TYPETERM)
	UCTRAN (是)	UCTRAN (NO)	氨曲南
UCTRAN (是)	Tranid: 是数据: 是	Tranid: 无数据: 是	Tranid: 是数据: 是
UCTRAN (NO)	Tranid: 是数据: 是	Tranid: 无数据: 无	Tranid: 是数据: 否

注: 此表显示根据 PROFILE 和 TYPETERM 资源定义上的 UCTRAN 设置转换的终端输入部分 (事务标识和/或数据)。

ZCP跟踪 (cvda)

指定与 CICS的 z/OS Communications Server 控制组件关联的必需跟踪活动。 CVDA 值包括：

NOZCPTRACE

将不执行 z/OS Communications Server ZCP 跟踪。

ZCPTRACE

将执行 z/OS Communications Server ZCP 跟踪。

条件

INVREQ

RESP2 值：

1

为 IRC 会话或非z/OS Communications Server 终端指定了 TERMSTATUS 或 ACQSTATUS。

2

TERMSTATUS 或 ACQSTATUS 具有无效的 CVDA 值。

4

ATISTATUS 具有无效的 CVDA 值。

5

ATISTATUS 更改将导致 NOATI 和 NOTTI。

6

为非z/OS Communications Server 终端指定了 CREATESESS。

7

CREATESESS 具有无效的 CVDA 值。

9

PAGESTATUS 具有无效的 CVDA 值。

11

正在尝试放置发出终端 OUTSERVICE。

13

SERVSTATUS 具有无效的 CVDA 值。

15

TERMPRIORITY 值不在范围 0-255 内。

17 日

不能为发出终端指定 NOTTI。

18

TTISTATUS 具有无效的 CVDA 值。

21

PURGETYPE 具有无效的 CVDA 值。

22

TRACING 具有无效的 CVDA 值。

24

为远程终端请求的选项无效。

25

已指定既已获取，但终端未在服务中。

26 日

指定了 PURGE ，但目标任务在其关联事务定义上具有 SPURGE=NO。

27

EXIT跟踪具有无效的 CVDA 值。

28 日

ZCP跟踪具有无效的 CVDA 值。

29 日

为非z/OS Communications Server 终端 (或未安装 z/OS Communications Server ) 指定的EXIT跟踪或ZCP跟踪。

31 日

这是没有关联代理的远程终端。

33

SET TERMINAL 对于 LU6.2 (APPC) 会话无效。

34

已为此终端定义永久事务 (TERMINAL 定义中的 TRANSACTION 操作数)。

35

尝试在非 TCAM 终端上更改 TCAM CONTROL。

36

为 TCAM CONTROL 提供的值无效。

37

预设登录失败，终端仍为 OUTSERVICE。

38

OBFORMATST 具有无效的 CVDA 值。

39

RELREQST 具有无效的 CVDA 值。

40

离散化具有无效的 CVDA 值。

41

ALTPRTCOPYST 具有无效的 CVDA 值。

42

PRTCOPYST 具有无效的 CVDA 值。

43

UCTRANST 具有无效的 CVDA 值。

44

选项将导致在未定义备用打印机的情况下设置备用打印机复制状态的无效组合。

45

选项将导致在未定义主打印机的情况下定义备用打印机的无效组合。

46

为控制台或 3790 指定了 OBFORMATST。

48

选项将导致在未定义主打印机的情况下设置打印机复制状态的无效组合。

50

z/OS Communications Server 不可用于 z/OS Communications Server 终端。

51

为非 z/OS Communications Server 3270 或 3270 兼容性方式的终端指定了 PRINTER 和 ALTPRINTER 选项。

52

为非 z/OS Communications Server 3270 或 3270 兼容性方式的终端指定了 PRTCOPYST 或 ALTPRTCOPST 选项。

54

为 IRC 会话指定了除 PURGETYPE 以外的选项。

57

CANCEL 选项随附了其他 SET 参数。

61

先前未尝试阻止其设施为终端的任务。

正常

RESP2 值：

53

已延迟清除。

58

AID 已成功取消。

59

未取消任何 AID。

60

指定了 MAPNAME 或 MAPSETNAME ，但终端不是 BMS 支持的类型。

NOTAUTH

RESP2 值：

100

未授权与发出任务关联的用户使用此命令。

TERMIDERR

RESP2 值：

23

找不到指定的终端。