SET SYSTEM

描述

使用 SET SYSTEM 命令可更改控制 CICS 系统运行方式的某些选项的值。

这些值最初由系统初始化参数设置。 与此命令中的那些参数相对应的系统初始化参数具有相同的或类似的名称，除非另有说明。 表 1 列出了精确的对应关系。

选项

AKP (data-value)

以全字二进制值的形式指定活动关键点触发器值，即在获取关键点之间对 CICS 系统日志流输出缓冲区的写请求数。 该数字必须为零，这将关闭关键点，或者在 50-65535 范围内。 如果 CICS 是在没有关键点的情况下初始化的 (即，将 AKPFREQ 系统初始化参数设置为零) ，那么可以覆盖初始值并且可以设置触发器值。

DEBUGTOOL (cvda)

指定 CVDA 值，该值指示是否使用调试概要文件来选择将在调试工具控制下运行的程序。 下列调试工具使用调试概要文件：

• 调试工具，用于编译语言应用程序（用 COBOL, PL/I, C®, C++ 和汇编语言编写的程序）
• 远程调试工具（用于编译型语言应用程序和 Java™ 程序）

其他调试机制 (例如 CICS 执行诊断设施 (CEDF)) 不使用调试概要文件。

CVDA 值如下所示：

DEBUG

指定要使用 CICS 调试概要文件来选择将在调试工具控制下运行的程序。

节点 BUG

指定您不希望使用 CICS 调试概要文件来选择将在调试器工具控制下运行的程序。

有关使用调试概要文件的更多信息，请参阅 调试概要文件。

DSALIMIT (data-value)

以全字二进制值的形式指定最大存储量 (以字节为单位) ， CICS 可以在此存储量内为位于 16 MB 以下 (行下方) 的四个单独动态存储区 (DSA) 分配存储器。 如果 DSALIMIT 指定的值低于当前限制，那么 CICS 可能不会立即实现新限制，但会在一段时间内尝试执行此操作以释放存储器。 DSALIMIT 的范围为 2-16 MB。 有关更多信息，请参阅 DSALIM 系统初始化参数。

注: 当您可以动态更改 DSA 限制时，建议您不要这样做，除非您正在处理紧急情况并尝试避免循环区域。 虽然从 CICS 角度看，您对 DSA 限制的更改可能成功，但增大限制可能会导致其他问题，因为较大的 DSA 将不再是连续的。 MVS 从高位向下和低位向上分配存储空间。 动态增加 DSA 限制会导致 CICS 在 MVS 私有存储区域中间分配一块新的存储空间。 根据 MVS 在这一区域的存储使用情况，您现在可能会因此增加 S878 或 S80A abend 的风险。

同样，动态降低 DSA 限制确实可能会将存储空间还给 MVS 使用，但无法确定还给的存储空间会在哪里，而且很可能不会在 MVS 需要的区域。

定期监视 CICS 统计信息，并主动调整 DSA 限制和 MXT 限制。

DSRTPROGRAM (data-value)

指定分布式路由程序的 8 字符名称。

DTRPROGRAM (data-value)

指定动态路由程序的 8 字符名称。

正在转储 (cvda)

指定 CVDA 值，该值指示是否禁止执行 CICS 系统转储。 CVDA 值如下：

无系统转储

禁止系统转储。

仅表

将禁止系统转储，但那些在转储表中具有允许进行 sdumps 的条目的系统转储除外。

SYSDUMP

不禁止系统转储。

EDSALIMIT (data-value)

以全字二进制值的形式指定最大存储量 (以字节计) ， CICS 可以在此存储量中为驻留在 16 MB 以上但 2 GB 以下 (行上方) 的各个动态存储区分配存储器。 如果 EDSALIMIT 指定的值低于当前限制，那么 CICS 可能不会立即实现新限制，但会在一段时间内尝试执行此操作以释放存储器。 有关更多信息，请参阅 EDSALIM 系统初始化参数。

注: 当您可以动态更改 EDSA 限制时，建议您不要这样做，除非您正在处理紧急情况并尝试避免循环区域。 虽然从 CICS 角度看，您对 EDSA 限制的更改可能会成功，但增大这些限制可能会导致其他问题，因为较大的 EDSA 将不再相邻。 MVS 从高位向下和低位向上分配存储空间。 动态增加 EDSA 限制将导致在 MVS 私有存储区域中间出现一块由 CICS 分配的新存储空间。 根据 MVS 在这一区域的存储使用情况，您现在可能会因此增加 S878 或 S80A abend 的风险。

同样，动态降低 EDSA 限制确实可以将存储空间还给 MVS 使用，但无法确定还给的存储空间会在哪里，而且很可能不会在 MVS 需要的区域。

定期监视 CICS 统计信息，主动调整 EDSA 限制和 MXT 限制。

FORCEQR (cvda)

指定 CICS 是否强制指定为 CONCURRENCY (THREADSAFE) 的所有用户应用程序在 CICS QR TCB 下运行，就像指定为 CONCURRENCY (QUASIRENT) 程序一样。

您可以在测试环境中使用此选项来运行已证明是非线程安全的未完成测试的线程安全应用程序。

FORCEQR 选项适用于未作为任务相关用户出口，全局用户出口或用户可替换模块调用的所有定义为线程安全的程序。

CVDA 值如下：

FORCE

强制所有 CICSAPI 用户应用程序在 QR TCB 下运行，即使它们是使用 CONCURRENCY (THREADSAFE) 属性定义的。 强制不适用于某些程序，例如 OPENAPI 程序，或者使用 XPLINK 编译的 C 或 C++ 程序。 有关详细信息，请参阅 FORCEQR 系统初始化参数。

NOFORCE

CICS 将采用程序资源定义上定义的 CONCURRENCY (THREADSAFE) 属性，并在 QR TCB 或开放式 TCB 下调用这些属性。

您可以使用此选项来动态更改由 FORCEQR 系统初始化参数指定的选项。

对此选项的任何更改都不会应用于当前调用的程序; 它仅适用于在更改为 FORCEQR 状态之后首次调用的程序。

GMMLENGTH (data-value)

以半字二进制值的形式指定 good 晨 消息文本的长度。 此值的范围为 1-246。

GMMTEXT (data-value)

指定最长可为 246 个字符的 早上好 消息文本。

LOG延迟 (data-area)

以半字二进制值的形式指定日志延迟时间间隔。 日志延迟时间间隔是 CICS 日志管理器用来确定在调用 MVS 系统日志记录器之前强制日志写入请求的延迟时间。 该值可以在 0-65535 范围内。 有关 LOGDEFER 参数和关联的 LGDFINT 系统初始化参数的信息，请参阅 LGDFINT 系统初始化参数。

MAXTASKS (data-value)

以全字二进制值的形式指定在此 CICS 系统中的任何时候可以进行分派的最大任务数。 活动任务和暂挂任务都计入此限制，但未达到初始分派点的任务不会计入此限制。 不计算系统任务 (例如，终端和日志控制任务)。 该值可以在 10-2000 范围内。

MROBATCH (data-value)

以全字二进制值的形式指定在显式发布 CICS 以处理事件之前，必须从 CICS 正在等待的 MRO 和 DASD I/O 事件列表中发生的事件数。 该值必须在 1-255 范围内。

NEWMAXTASKS (数据区)

以全字二进制格式返回 MAXTASKS 的新值。

当您使用 SET SYSTEM 命令来设置 MAXTASKS 值时，如果没有足够的存储空间用于您请求的值，那么 CICS 会引发 NOSTG 条件，继续处理该命令，并从您指定的值中减小该值。 NEWMAXTASKS 值显示任何此类调整后的值。

PROGAUTOCTLG (cvda)

指定是否以及何时对自动安装的程序定义进行编目。 在热重新启动或紧急重新启动时复原已编目的定义。 未编目的定义将在关闭时废弃，如果在 CICS的后续执行中使用了这些定义，那么必须重新安装这些定义。

在初始安装时以及每当修改自动安装的定义时，都会根据当时的 PROGAUTOCTLG 值来制定目录决策。 CVDA 值如下：

CTLGALL

定义在安装和修改时进行编目。

CTLGMODIFY

仅当修改定义时，才会对其进行编目。

CTLGNONE

未对定义进行编目。

PROGAUTOEXIT (data-value)

指定 CICS 程序自动安装代码调用以提供模型定义的用户提供的程序的 8 字符名称。

注: 必须先安装此程序 (及其调用的任何程序) ，然后才能在程序自动安装过程中使用这些程序 (通过显式 PROGRAM 定义或在另一个自动安装程序生效时通过自动安装)。 否则，下次使用时，程序自动安装过程将失败，并且 CICS 会使其处于不活动状态。

PROGAUTOINST (cvda)

指定程序的自动安装是处于活动状态还是不活动状态。 当任务请求未定义的程序，映射集或分区集时，如果程序的自动安装处于活动状态，那么 CICS 会尝试自动为其创建定义。 否则， CICS 会引发 PGMIDERR 异常情况。 CVDA 值如下：

自动活动

程序的自动安装处于活动状态。

自动不活动

程序的自动安装处于不活动状态。

PRTYAGING (data-value)

以全字二进制值的形式指定 CICS 增加等待分派任务的优先级的速率。 在没有分派的等待时间的每个毫秒数 (由 PRTYAGING 值设置) 之后， CICS 会将任务优先级提高 1。 该值必须在 0-65535 范围内。

RUNAWAY (data-value)

以全字二进制值形式指定失控任务时间的缺省值 (以毫秒为单位)。 此值用于执行具有未指定失控任务时间的概要文件的事务的任何任务 (请参阅 INQUIRE TRANSACTION 命令的 RUNAWAY 选项: INQUIRE TRANSACTION options-RUNAWAY)。

该值必须为零，这意味着使用缺省值的任务不需要失控任务检测，或者在 250-2700000 范围内。 您提供的值向下舍入为最接近的 250 的倍数。

SCANDELAY (data-value)

以全字二进制值的形式指定 CICS 区域的终端扫描延迟值 (以毫秒为单位) ，该值最初由 ICVTSD 系统初始化参数设置。 缺省设置是零。 该值必须在 0-5000 范围内。 在早期版本中，终端扫描延迟功能用于限制 CICS 处理应用程序发出的某些类型的终端输出请求的速度，以分散处理请求的开销。 在 CICS 系统使用非 SNA 网络时，指定非零值有时是适当的。 但是，对于 SNA 和 IPIC 网络，将 ICVTSD 设置为 0 可提供更好的响应时间和最佳虚拟存储器使用情况。

SDTMEMLIMIT (data-value)

作为双字二进制值，指定 CICS 使共享数据表可用于控制信息 (条目描述符，回退元素和索引节点) 的界线之上的最大存储量。 该值必须在 1048576 字节 (1 MB)-549755813888 字节 (524288 MB 或 512 GB) 范围内。 以字节为单位输入的值将向下舍入为最接近的兆字节。

注：

• 只能增大当前 SDTMEMLIMIT 设置; 不能将其降低。
• 如果指定值小于当前值，或大于 z/OS® 参数 MEMLIMIT 值的 40%，则请求失败， SDTMEMLIMIT 保持不变。

时间 (data-value)

以全字二进制值的形式指定在没有任务可供分派时， CICS 向操作系统提供控制权的最大时间间隔 (以毫秒为单位)。 此值最初由 ICV 系统初始化选项设置，有时称为 区域退出时间间隔。 TIME 值必须在 100-3600000 范围内，并且不得小于 SCANDELAY 值。 要确定当前 SCANDELAY 值，可以使用 INQUIRE SYSTEM SCANDELAY 命令。

条件

INVREQ

RESP2 值：

1

MAXTASKS 值超出范围。

3

AKP 值超出范围。

5

TIME 值不在范围 100-3600000 中。

6

RUNAWAY 值超出范围。

7

MROBATCH 值不在 1-255 范围内。

9

转储具有无效的 CVDA 值。

12

指定了 AKP ，但 CICS 已初始化而没有键指向。

13

TIME 小于 SCANDELAY。

14

PRTYAGING 值不在 0-65535 范围内。

15

SCANDELAY 值不在 0-5000 范围内。

20

DSALIMIT 值不在范围 2-16 MB 内。

21

EDSALIMIT 值不在 48MB - 2047MB范围内。

22

MVS 存储空间不足以分配 DSALIMIT。

23

MVS 存储空间不足以分配 EDSALIMIT。

29 日

LOG延迟值超出范围。

30

MAXSOCKETS 值不在范围 1-65535 内。

31 日

SSDTMEMLIMIT 值不在范围 1-524288 MB (512 GB) 内。

32

STMEMLIMIT 值不得大于 MEMLIMIT 值的 40%。

33

指定的 SDTMEMLIMIT 值小于当前值。

LENGERR

RESP2 值：

20

GMMLENGTH 值超出范围。

NOSTG

RESP2 值：

16

由于存储约束， CICS 降低了您为 MAXTASKS 请求的值; 请参阅 NEWMAXTASKS 选项。

NOTAUTH

RESP2 值：

100

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

非超级用户

RESP2 值:

15

CICS 无法将 MAXSOCKETS 设置为您请求的值，因为运行 CICS 作业的用户标识没有超级用户权限。 CICS 已将限制设置为 SYS1.PARMLIB 成员 BPXPRMxx。