TS 队列服务器参数

参数以 KEYWORD=value 格式指定。您可以选择以混合大小写方式指定关键字，以提高可读性。

如果在 PARM 字段中或在同一 SYSIN 输入行上指定多个参数，那么这些参数必须以逗号分隔。一个或多个空格后的任何文本都将用作描述性注释。假定以星号或空格开头的任何参数行都是整行注释。

您可以输入多个格式的一些参数关键字，例如缩写。每个关键字的标准形式一般是所显示的第一个词的最长形式。

在启动期间，使用的主要参数列示在服务器打印文件上。

以下参数都作为初始化参数 (在 SYSIN 文件或 PARM 字段中) 有效，某些参数可由服务器 SET 命令修改。

您可以使用服务器 DISPLAY 命令显示任何参数。使用 DISPLAY ALLPARMS 显示所有参数的值。

指定以下关键字以提供组合的信息列表:

主参数值的 PARMS
所有可用统计信息的 STATS
INIT ，用于选择通常在初始化完成时显示其值的参数和统计信息

主参数

通常为所有服务器指定这些参数:

POOLNAME=池名称

指定用于构成服务器名称和耦合设施列表结构 DFHXQLS_poolname 的队列池的名称 (1 到 8 个字符)。此参数仅在初始化时有效，并且必须始终指定。

此关键字也可以编码为 POOL。

BUFFERS = {100|number}

指定要为服务器地址空间分配的队列缓冲区数。

队列索引缓冲区包含队列索引条目以及最多 32K 的队列数据 (对于小型队列)。当 READ 或 WRITE 请求完成时，队列索引信息将保留在缓冲区中。如果在缓冲区被重新使用之前，同一个 z/OS® 镜像引用了同一个队列，这样就可以避免重新读取队列索引。如果在请求时没有可用的缓冲区，那么将发出请求以等待一个缓冲区变为可用。

对于可以连接到此 z/OS 映像中的服务器的每个 CICS® 区域，缓冲区数量最好至少为 10 个。这避免了缓冲区等待的风险。通过在存储器中保留最近使用的队列索引条目，可以使用其他缓冲区来减少耦合设施访问次数。特别是，如果队列索引条目的当前版本在读取队列项时处于存储器中，那么请求仅需要一个耦合设施访问权而不是两个耦合设施访问权。如果在将第二个或后续项写入同一队列时，队列索引条目的当前版本处于存储器中，那么请求仅需要一个耦合设施访问权，而不是三个耦合设施访问权。

在可能导致 z/OS 分页的情况下，不值得定义额外的缓冲区，因为重读索引条目比从辅助存储区分页到缓冲区更有效。此参数仅在初始化时有效。

有效范围是从 1 到 999999。

此关键字也可以编码为 BUF。

FUNCTION = {SERVER| UNLOAD | RELOAD}

有关此参数的信息在卸载和重新装入队列池中提供。

STATSOPTIONS = {NONE| SMF | PRINT | BOTH}

指定用于确定是否生成时间间隔统计信息以及是否将统计信息发送至 SMF 和/或打印文件的统计信息选项。

此关键字也可以编码为 STATSOPT。

ENDOFDAY = {00:00|hhmm}

指定要收集和重置每日结束统计信息的时间。如果统计选项指定 NONE ，那么会将每日结束统计信息写入打印文件。有效范围是从 00:00 到 24:00。

此关键字也可以编码为 EOD。

STATSINTERVAL={03 :00|hhmm}

指定 1 分钟到 24 小时范围内的统计时间间隔。如果 STATSOPTIONS=NONE ，那么将忽略该值。

有效范围是从 00:01 到 24:00 (尽管可以以秒为单位指定)。

此关键字也可以编码为 STATSINT。

自动重新启动管理器 (ARM) 参数

在服务器初始化期间，除非使用 UNLOAD 或 RELOAD 函数调用服务器程序，否则服务器将无条件地向 ARM 注册。如果注册失败，那么服务器将不会启动。

使用以下参数来覆盖自动重新启动管理器的缺省处理:

ARMELEMENTNAME=elementname

指定自动重新启动管理器元素名称 (最多 16 个字符) ，以向 ARM 标识服务器以用于自动重新启动。元素名称的允许字符为 A 到 Z 0-9 $# @ 和下划线符号 (_)。

The default identifier is of the form DFHXQ恩_池名称, where XQ represents the server type, 恩 is the &SYSCLONE value for the system (which can be either one or two characters), and 池名称 is the name of the pool served by the server.

此参数仅在服务器初始化时有效。

此关键字可以缩写为 ARMELEMENT 或 ARMELEMNAME。

ARMELEMENTTYPE=Elementtype

指定自动重新启动管理器元素类型，最多为 8 个字符，以在 ARM 策略中用作对类似元素进行分类的方法。元素类型允许的字符为 A 到 Z 0-9 $# 和 @。

缺省元素类型为 SYSCICSS。

此参数仅在服务器初始化时有效。

此关键字可以缩写为 ARMELEMTYPE。

列表结构参数

列表结构参数指定仅用于为 TS 池初始分配临时存储器列表结构的属性。首次为 TS 池启动服务器时，将进行初始分配。

MAXQUEUE = {1000|number}

指定分配结构时要保留的最大数据列表数，这将确定可以存储在结构中的最大大队列数。此参数还确定创建结构时定义的列表头数。

指定足够大的数目来处理大型队列，但不指定这么大的数目，以使未使用的预分配列表头使用大量耦合设施存储器。

如果不重新分配结构，那么无法更改此数字。因此，如果在小于其最大大小的情况下分配结构，那么此处的值应基于结构的最大可能大小而不是其初始大小。

此参数对应于 CFSizer 工具中的最大队列数值 (请参阅用于临时存储器数据共享的存储器计算)。

有效范围是从 1 到 999999。

此关键字也可以编码为 MAXQ。

POOLSIZE = {0|number{K | M | G}}

指定要为列表结构分配的最大存储量，以千字节 (nK) ，兆字节 (nM) 或千兆字节 (nG) 表示。

在使用小于耦合设施资源管理 (CRFM) 策略中为列表结构指定的值的指定值创建列表结构时，将使用此参数。

缺省值 0 指定此处不应用最大限制，并且将应用 CFRM 策略中指定的最大限制。

非零值由 z/OS 向上舍入到耦合设施级别 (CFLEVEL) 的下一个存储增量。例如，对于 CFLEVEL 16 ，该值向上舍入为最接近的 1 MB。

有效范围为 0 至 16777215M。但是，在 z/OS 中指定的值必须小于结构的最大大小；否则，将出现 z/OS 错误。有关详细信息，请参阅 z/OS MVS Setting Up a Sysplex 中有关 CFRM 参数的信息。

有关定义临时存储列表结构的信息，请参阅为临时存储数据共享定义临时存储池。

调试跟踪参数

这些参数仅用于密集调试跟踪。

请注意，在生产环境中使用这些选项可能会显着影响性能，并导致打印文件以非常快的速度增长，从而耗尽假脱机空间。

如果生成来自跨内存请求的跟踪消息的速度超过跟踪打印子任务可以打印这些消息的速度，那么可能会丢失这些消息。在这种情况下，跟踪仅指示丢失的消息数。

TRACECF = {OFF| ON}: 指定耦合设施接口调试跟踪选项 OFF 或 ON。此选项在打印文件上生成跟踪消息，指示耦合设施请求接口的主要参数以及 IXLLIST 宏的结果。
此关键字也可以编码为 CFTR 或 CFTRACE。
TRACERQ = {OFF| ON}: 指定队列请求调试跟踪选项 OFF 或 ON。此选项在打印文件上生成跟踪消息，指示进入共享队列请求或共享队列查询接口时的主要参数以及退出时的结果。
此关键字也可以编码为 RQTR 或 RQTRACE。

调整参数

提供这些参数是为了进行调整，但通常可以省略这些参数并让 TS 服务器使用缺省值。

ELEMENTRATIO = {1|number}

这是一个耦合设施资源管理 (CFRM) 参数，用于在首次分配结构时指定条目对元素比率的元素部分。此值确定最初为数据元素留出的结构空间的比例。

条目对元素比率的理想值是每个条目的平均数据大小除以元素大小。但是，服务器会根据实际条目和元素使用情况自动调整比率。

此参数仅在服务器初始化时有效，并且仅在首次分配结构时使用。有效范围是从 1 到 255。

可以将此关键字缩写为 ELEMRATIO。

有关耦合设施中该参数的更多信息，请参阅 z/OS MVS Programming：Sysplex 服务指南》。

ELEMENTSIZE = {256|number}

CFRM 参数，用于指定结构空间的元素大小，必须是 2 的幂。此参数仅用于耦合设施日志流。有效范围是 256 到 4096。对于当前耦合设施实现，没有理由将此参数从缺省值 256 更改为其他值。

此参数仅在服务器初始化时有效，并且仅在首次分配结构时使用。

可以将此关键字缩写为 ELEMSIZE。

ENTRYRATIO = {1|number}

一个 CFRM 参数，用于在首次分配结构时指定条目对元素比率的条目部分。此值确定最初为列表条目控件留出的结构空间的比例。

指定此参数并不重要，因为服务器会根据实际使用情况自动调整比率，以提高空间利用率 (如果需要)。

此参数仅在服务器初始化时有效，并且仅在首次分配结构时使用。有效范围是从 1 到 255。

有关耦合设备中该参数的更多信息，请参阅 z/OS MVS Programming：Sysplex 服务指南》。

LASTUSEDINTERVAL = {00:10|hh:mm}

CICS 参数，用于指定最近一次对大队列使用的时间进行更新的频率。

对于小队列，将在每个引用上更新上次使用的时间。对于大型队列，更新最后使用时间需要额外的耦合设施访问，因此只有在队列在当前时间的这个时间间隔内没有被访问过时，才会进行更新。因此， INQUIRE 命令返回的上次使用时间间隔可以大于 true 值，直至此参数的值。上次使用的时间主要用于确定队列是否过时，因此 LASTUSEDINTERVAL 参数的合适值通常为几分钟。

请参阅 INQUIRE TSQUEUE/TSQNAME。

有效范围是从 00:00 到 24:00。此值也可以以秒为单位指定。

可以将此关键字缩写为 LASTUSEDINT。

SMALLQUEUEITEMS = {9999|number}

CICS 参数，用于指定可在队列索引条目数据区中以小队列格式存储的最大项数。此参数可以强制将队列转换为大队列格式 (如果它具有大量小项)。与每次重写整个小队列数据区相比，单独写入项的效率更高。

有效范围是从 1 到 32767。

SMALLQUEUESIZE = {32K|number}

CICS 参数，用于指定小队列的最大数据大小，包括每个数据项上的双字节长度前缀。如果队列超过写入第二项或后续项时的最大大小，那么该队列将转换为大队列格式。

此参数可以强制将队列转换为大小小于 32K的大队列格式。这是为了防止大量数据被写入小队列格式。在异步耦合设施处理导致硬件资源争用的系统上，使用此参数可提高性能。但是，在大多数系统上，延迟转换的效率更高，直到达到最大大小 32K 。

有效范围是从 4096 到 32768。

警告参数

这些参数将修改在结构接近已满时发生警告消息和自动 ALTER 操作的阈值。

ELEMENTWARN = {80|number}

指定应首先触发警告和自动 ALTER 操作的正在使用的元素的百分比。

有效范围是从 1 到 100。

此关键字也可以编码为 ELEMWARN。

ELEMENTWARNINC = {5|number}

指定在应触发下一个警告之前正在使用的元素的百分比增加 (或减少) (当下一个增加将达到 100 时减少到 1)。随着正在使用的元素数的更改，将发出其他消息。当正在使用的元素数至少低于初始警告级别的此百分比时，消息将停止。

有效范围是从 1 到 100。

此关键字也可以编码为 ELEMWARNINC。

ENTRYWARN = {80|number}

指定应首先触发警告和自动 ALTER 操作的正在使用的条目的百分比。

有效范围是从 1 到 100。

ENTRYWARNINC = {5|number}

指定应该触发下一个警告之前正在使用的条目的百分比增加 (或减少) (当下一个增加将达到 100 时，减少到 1)。随着元素数量的变化，将发出其他消息。当正在使用的条目数至少低于初始警告级别的指定百分比时，消息将停止。

有效范围是从 1 到 100。

自动 ALTER 参数

定义以下参数以修改在结构接近已满时服务器尝试自动 ALTER 操作的条件。

有关队列服务器自动 ALTER 过程的详细信息，请参阅队列服务器自动 ALTER 处理。

ALTERELEMMIN = {100|number}

指定要发出自动 ALTER 以将这些元素转换为条目时必须存在的多余元素的最小数目。

有效范围是从 1 到 999999999。

ALTERELEMPC = {1|number}

指定要发出自动 ALTER 以增加条目比例而必须存在的过量元素的最小百分比。

有效范围是从 0 到 100。

ALTERENTRYMIN = {100|number}

指定要发出自动 ALTER 以将这些条目转换为元素，必须存在的多余条目的最小数目。

有效范围是从 0 到 999999999。

ALTERENTRYPC = {1|number}

指定要发出自动 ALTER 以增加元素的比例而必须存在的超额条目的最小百分比。

有效范围是从 0 到 100。

ALTERMININTERVAL = {00:10|hhmm}

指定当结构接近已满 (高于元素或条目警告级别) 时，自动 ALTER 尝试之间要保留的最小时间间隔。

有效范围是从 00:00 到 24:00。

此关键字也可以编码为 ALTERMININT。