SESSIONS 属性

描述 SESSIONS 资源的语法和属性。

APPC 会话的属性

MRO 和 LU61 会话的属性

EXCI 会话的属性

AUTOCONNECT({NO|YES|ALL})

指定建立连接的方式。下面讨论了必须为 LU6.1 和 APPC 会话指定的内容:

APPC 会话

对于在连接定义上具有 AUTOCONNECT (YES) 或 (ALL) 的 z/OS® Communications Server连接的系统:

否: 建立连接时， CICS® 不会尝试绑定任何会话。但是，可以将一个或多个用户会话作为正在进行的任何获取 CONNECTION 处理的一部分进行分配。
是或全部: 在 CICS 初始化期间，或者在使用 CEMT SET VTAM ® OPEN 命令启动与 z/OS Communications Server 的通信时，将建立争用胜方会话 (即，执行 BIND)。如果此时由于远程系统不可用而无法建立连接，那么必须随后使用 CEMT SET CONNECTION (sysid) INSERVICE 既得命令获取链路，除非远程系统在此期间变为可用并且自身启动通信。
不应为与其他 CICS 系统的会话指定 AUTOCONNECT (ALL) ，因为这可能导致绑定争用。

对于在 CONNECTION 定义上具有 AUTOCONNECT (NO) 的 z/OS Communications Server连接的系统:

ALL: 通过发出 CEMT SET CONNECTION (name) 获取连接时，将建立所有会话，而不仅仅是争用获胜者既得，或当远程系统本身发起通信时。
否: 建立连接时， CICS 不会尝试绑定任何会话。但是，可以将一个或多个用户会话作为正在进行的任何有所获取 CONNECTION 处理的一部分进行分配。
YES: 通过发出 CEMT SET CONNECTION (sysid) 获取连接时，将建立争用胜方会话既得，或当远程系统本身发起通信时。

LU6.1 会话

如果希望在初始化或 CEDA 安装时建立连接，请在 SESSIONS 上指定 AUTOCONNECT (YES)。

如果您不希望在初始化或 CEDA 安装时建立连接，请在 SESSIONS 上指定 AUTOCONNECT (NO)。

BUILDCHAIN({YES|NO})

指定 CICS 是否在将输入数据传递到应用程序之前执行链组合件。

否: 应用程序从此逻辑单元接收到的任何 TIOA 都包含一个请求单元 (RU)。
是: 应用程序从此逻辑单元接收的任何终端输入/输出区域 (TIOA) 都包含完整的链。

CONNECTION(连接)

指定要用于此会话定义的连接定义的名称。该名称的最大长度为 4 个字符。

可接受的字符：

A-Z 0-9 $ @ #

除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

请注意， CONNECTION 定义必须与 SESSIONS 定义位于同一组中。

DESCRIPTION(文本)

您可以提供在此字段中定义的资源的描述。描述文本的长度最多可以为 58 个字符。您可以使用的字符没有任何限制。但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。如果使用 CREATE 命令，那么对于文本中的每个单撇号，请对两个单撇号进行编码。

DISCREQ({NO|YES})

指定是否接受断开连接请求。酌情适用于 LUTYPE6.1 ISC 会话，但不适用于 CICS 不处理 z/OS Communications Server 设备的 MRO 会话。

离散不适用于 APPC (LUTYPE6.2) 会话。当使用 APPC 时，将根据事务需要获取个别会话，然后释放这些会话。因为可以在 APPC 逻辑单元之间进行多个会话，所以不应该出现一个请求占用另一个请求的问题。无法断开个别 APPC 会话的连接; 而是可以发出 CEMT SET CONNECTION RELEASED 命令。

否: CICS 不接受 z/OS Communications Server 设备的断开连接请求。
YES: CICS 将接受针对 z/OS Communications Server 设备的断开连接请求，并发出 z/OS Communications Server CLSDST 宏指令以终止与该逻辑单元的 z/OS Communications Server 会话。
如果指定离散化 (YES) ，那么从终端发出的 CSF LOGOFF 或 GOODNIGHT 命令也会导致断开连接。

GROUP(groupname)

每个资源定义都必须具有 GROUP 名称。资源定义成为组的成员，并在安装组时安装在 CICS 系统中。

可接受的字符：

A-Z 0-9 $ @ #

输入的任何小写字符都将转换为大写。

GROUP 名称的长度最多可以为 8 个字符。小写字符被视为大写字符。

INSERVICE

该属性已过时，但仍受支持，用于提供与 CICS 较早发行版的兼容性。

IOAREALEN({0|value1} ， {0|value2})

指定要用于处理在 MRO 链路上传输的消息的终端输入/输出区域的长度 (以字节计)。

value1: value1 指定发出 RECEIVE 命令时要传递到应用程序的终端输入/输出区域的最小大小。
value2: 如果未指定 value2 ，或者值小于 value1，那么缺省值为 value1。
可以将 value2 指定为大于或等于 value1。在这种情况下，当输入消息的大小超过 value1时， CICS 将使用终端输入/输出区域 (TIOA) value2 字节长。在 MRO 链路上连接事务时， CICS 会使用足够长的 TIOA 来包含初始输入消息。否则，如果输入消息大小也超过 value2，那么节点异常条件程序会向终端发送异常响应。

通过指定对于 MRO 链路上传输的大多数消息过大的 IOAREALEN 值，可以同时浪费实存储器和虚拟存储器。另一方面，如果指定的 IOAREALEN 值为零或小于大多数消息，那么可能会发生过多的 FREEMAIN 和 GETMAIN 活动。这将导致额外的处理器需求。

MAXIMUM({1|value1} ， {0|value2}) (仅限 APPC)

指定要支持方式集的最大会话数。 Value1 必须大于或等于 value2。

1|值 1: 组中会话的最大数量。该值的范围可以是 1 到 999。缺省值为 1。
0|值 2: 受支持的争用胜方会话的最大数。该值的范围可以是 0 到 999。缺省值是 0。请注意，此操作数对于单个会话连接没有意义。

SNA 允许在网络中将某些资源 (例如交换线路) 定义为 有限资源。在绑定时， z/OS Communications Server 向 CICS 指示绑定是否在有限资源上。当 CICS 任务释放跨有限资源的会话时，如果没有其他任务要使用该会话，那么 CICS 将取消绑定该会话。

如果会话要使用有限资源，请指定 MAXIMUM(value1,0)。这将导致重置任何未绑定的会话，以便在需要下一个会话时，任何一方都可以将其绑定为获胜者。

有关 MAXIMUM 选项的影响以及有限资源的使用的更多信息，请参阅 SESSIONS 资源的 MAXIMUM 选项的影响

MODENAME(modename) (仅限 APPC)

指定用于标识在 APPC 连接上使用的一组会话的名称。该名称的长度最多可以为 8 个字符，并且必须是对 z/OS Communications Server定义的 z/OS Communications Server LOGMODE 条目的名称。它不能是保留名称 SNASVCMG。如果省略 modename ，那么缺省为空白。有关 z/OS Communications Server modenames 的更多信息，请参阅定义 APPC 会话组。

对于为任何一个系统间链路定义的每组会话， MODENAME 必须是唯一的。即， MODENAME 在与一个 CONNECTION 定义相关的 SESSIONS 定义中必须唯一。它作为 LOGMODE 名称传递到 z/OS Communications Server 。

NEPCLASS({0|tranclass})

指定节点错误程序的事务类。此值充当缺省值。

0: 这将生成指向缺省节点错误程序模块的链接。
tranclass: (非缺省) 节点错误程序模块的事务类。该值的范围可以是 1 到 255。有关节点错误程序的编程信息，请参阅编写节点错误程序。

对于 SNASVCMGR 会话，将忽略 NEPCLASS 属性。

NETNAMEQ(netnameq)

指定远程 IMS 系统用于识别此特定会话的名称。这用于 CICS-IMS 会话。该名称的最大长度为 8 个字符。 The acceptable characters are: A-Z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < and >. Lowercase characters are converted to uppercase except when using the CREATE command.

OPERID

OPERPRIORITY

操作 (OPERRSL)

操作安全性

这些属性已过时，但支持这些属性以提供与较早发行版的 CICS的兼容性。

PROTOCOL({APPC|LU61|EXCI})

指定要用于相互通信链路 (ISC 或 MRO) 的协议类型。

APPC (LUTYPE6.2): 高级程序间通信 (APPC) 协议。为 CICS-CICS ISC 指定该值。
EXCI: 外部 CICS 接口。指定该值，以表明会话供使用外部 CICS 接口的非 CICS 客户机程序使用。
LU61: LUTYPE6.1 协议。对 CICS-CICS ISC ， CICS-IMS或 MRO 指定此项。

RECEIVECOUNT(number)

对于 MRO 和 z/OS Communications Server LU6.1 会话以及与 EXCI 客户机的会话，指定 接收会话数; 即，通常在发送之前接收的会话数:

MRO 接收会话 (包括与 EXCI 客户机的会话) 总是在发送之前接收。
z/OS Communications Server LU6.1 接收会话通常在发送之前接收，但在缺少合适的发送会话时，可能会在接收之前发送。

如果未指定 RECEIVECOUNT 属性，那么没有接收会话。

您可以指定的接收会话数取决于 RECEIVEPFX 属性中指定的前缀的长度:

If you use the default receive prefix (<), or your own 1-character prefix, you can specify 1 through 999 receive sessions.
如果使用 2 字符前缀，那么可以指定 1 到 99 个接收会话。

您还应确保指定的值与伙伴系统中的发送会话数相匹配:

如果伙伴是另一个 CICS 系统，那么该值应与伙伴系统中指定的 SENDCOUNT 相匹配。
如果合作伙伴是 EXCI 客户机，那么不能指定合作伙伴中的发送会话数。但是， EXCI 地址空间中存在发送会话的上限。达到此限制时， IRP 将拒绝对具有 SYSTEM_ERROR 原因码 608 的会话的进一步请求。有关如何为 CICS 系统指定限制的信息，请参阅 EXCI 管道分配。

RECEIVEPFX({<|前缀})

指定 CICS 要用作接收会话名称 (会话的终端控制表终端条目 (TCTTE) 的名称) 的前一个或两个字符的 1 或 2 字符前缀。

前缀不得导致与现有连接或终端名称冲突。

< (MRO and EXCI sessions)

For MRO 和 EXCI sessions, if you do not specify your own receive prefix, CICS enforces the default prefix—the less-than symbol (<), which is used in conjunction with the receive count to generate receive session names.

CICS 创建会话名称的最后三个字符。可接受的字符为 A-Z 1-9。这些 3 字符标识以字母 AAA 开头，并按升序继续，直到会话条目数达到 RECEIVECOUNT 值设置的限制为止。请注意，接收会话名称是在发送会话之后生成的，它们遵循相同的顺序。

For example, if the last session name generated for the send sessions is >AAJ, using the default 发送prefix (>) CICS generates the receive session names as <AAK, <AAL, <AAM, and so on. (此会话标识生成方法与 APPC 会话相同，但初始前缀符号除外。)

If you use more than 46656 sessions (<AAA to <999), CICS allocates the next range of AAA< to 999<, again in a similar manner to APPC sessions.

具有超过 46656 个会话的区域的性能可能不高。您应该考虑增加 CICS 区域数的替代方法。

虽然您最多可以定义 93312 个 MRO 会话，但当前存在阻止您尝试一次获取超过 65535 个会话的限制。如果所有伙伴区域都已启动并正在运行，那么当 CICS 启动或 CEDA 安装超过 65536 个会话时，可能会发生此情况。稍后可以获取更多会话。

注: 如果您指定自己的前缀，那么 CICS 将以与 LUTYPE6.1 会话相同的方式生成会话名称。

前缀 (LUTYPE6.1 会话)

如果会话位于 LUTYPE6.1 ISC 连接上，那么必须指定 1 或 2 字符前缀。 Do not use the default < symbol for LUTYPE6.1 sessions.

对于 LUTYPE6.1 会话 (如果您指定自己的 1 或 2 字符前缀) ， CICS 会通过将数字附加到前缀 (范围在 1 到 99 或 1 到 999 之间) 来生成会话名称。该数字以 1 开头，并按 1 递增，直到达到指定的 RECEIVECOUNT 为止。

RECEIVESIZE({4096|number})

指定这些会话能够接收的最大 z/OS Communications Server 请求单元 (RU) 大小。对于 LU61 会话，该值必须在 1 和 30720 之间；对于 APPC 会话，必须在 256 和 30720 之间。缺省值为 4096。

将指定的值传输到已连接的逻辑单元。此值可由 CICS向下舍入，具体取决于您指定的值，因为该值必须以架构形式传输。在 BIND 时，可能会进一步协商该值。

如果 CICS 是辅助 LU 会话，那么这指示这些会话能够发送的最大 z/OS Communications Server 请求单元 (RU) 大小。

RECOVNOTIFY

该属性已过时，但仍受支持，用于提供与 CICS 较早发行版的兼容性。

RECOVOPTION({SYSDEFAULT|CLEARCONV| RELEASESESS|UNCONDREL|NONE})

此选项适用于使用 z/OS Communications Server 持久会话或 XRF 运行的 CICS 区域中的会话恢复。

z/OS Communications Server 持久会话: 在使用持久会话支持运行的 CICS 区域中，此选项指定希望 CICS 如何恢复会话，并在持久会话延迟时间间隔内系统重新启动时将终端返回到服务。

XRF: 在使用 XRF 支持运行的 CICS 区域中，此选项指定您希望 CICS 如何恢复会话，并在 XRF 接管后将终端恢复为服务。

对于除 NONE 以外的所有恢复选项，如果执行的操作是 z/OS Communications Server UNBIND ，那么 UNBIND 后跟 z/OS Communications Server SIMLOGON。

环境委员会

z/OS Communications Server 持久会话: APPC 会话不支持 CLEARCONV。它缺省为 SYSDEFAULT。

XRF: 如果指定了 AUTOCONNECT (YES) ，那么将重新启动会话。如果指定了 AUTOCONNECT (NO) ，那么将取消会话绑定。

NONE

z/OS Communications Server 持久会话: 在具有持久会话支持的情况下运行的 CICS 区域中，这指定在持久会话延迟时间间隔内系统重新启动时不恢复会话: 实际上，方式组上的会话没有持久会话支持。 LU6.2 会话未绑定，并且方式组 CNOS 值重置为零。系统重新启动后，如果指定 AUTOCONNECT (YES) ，那么会自动重新连接会话。

XRF: 在使用 XRF 支持运行的 CICS 区域中，这指定备用系统不跟踪登录状态，并且在接管后不会自动恢复终端会话; 实际上，终端没有 XRF 支持。接管后，如果指定 AUTOCONNECT (YES) ，那么备用系统将自动重新连接终端。

RELEASESESS

z/OS Communications Server 持久会话: APPC 会话不支持 RELEASESESS。它缺省为 SYSDEFAULT。

XRF: 如果指定了 AUTOCONNECT (YES) ，那么将重新启动会话。如果指定了 AUTOCONNECT (NO) ，那么将取消会话绑定。

SYSDEFAULT

z/OS Communications Server 持久会话: 在具有持久会话支持的 CICS 区域中，这指定 CICS 将根据会话活动和终端特征，选择在持久会话延迟时间间隔内系统重新启动时恢复会话的最佳过程。

虽然会话已恢复，但发生故障时正在进行的任何事务都将异常终止且未恢复。如果恢复的会话正由另一个 CICS 区域通过 APPC 连接使用，那么事务也会异常终止。

CICS 通过下列其中一种方法来恢复具有最小可能影响的会话:

如果在 CICS 失败时会话未处于繁忙状态，那么无需执行任何操作。
如果在 CICS 失败时会话繁忙，那么 CICS 将在发生故障时针对正在进行的 APPC 对话发出 DEALLOCATE (ABEND) (相当于 EXEC CICS ISSUE ABEND)。
如果这两个事件都不适用，那么会话将处于未绑定状态。

XRF: 如果指定了 AUTOCONNECT (YES) ，那么将重新启动会话。如果指定了 AUTOCONNECT (NO) ，那么将取消会话绑定。

UNCONDREL

需要 CICS 发送 UNBIND 请求以释放活动会话。无论在系统重新启动 (对于持久会话支持) 或接管 (对于 XRF) 时会话是否繁忙，都将发送 UNBIND。

RELREQ({NO|YES})

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

SENDCOUNT(number)

仅对于 MRO 和 z/OS Communications Server LU6.1 会话，指定 发送会话数; 即，通常在接收之前发送的会话数:

MRO 发送会话始终在接收前发送
z/OS Communications Server LU6.1 发送会话通常在接收之前发送，但在发送之前可能会接收到合适的接收会话不足的情况

可以指定的发送会话数取决于 SENDPFX 属性中指定的前缀长度:

如果使用缺省发送前缀 (>) 或您自己的 1 字符前缀，那么可以通过 999 个发送会话指定 1
如果使用 2 字符前缀，那么可以指定 1 到 99 个发送会话。

您还应确保指定的值与伙伴系统中的接收会话数相匹配:

如果伙伴是另一个 CICS 系统，那么该值应与伙伴系统中指定的 RECEIVECOUNT 相匹配

如果未指定 SENDCOUNT 属性，那么没有发送会话。当伙伴是 EXCI 客户机时，请勿指定 SENDCOUNT 属性

SENDPFX({>|前缀})

指定 CICS 要用作发送会话名称 (会话的终端控制表终端条目 (TCTTE) 的名称) 的前一个或两个字符的 1 或 2 字符前缀。

前缀不得导致与现有连接或终端名称冲突。

> (MRO 会话)

对于 MRO 会话，如果未指定您自己的发送前缀，那么 CICS 将强制使用缺省前缀 (大于号 (>)) ，该前缀与发送计数结合使用以生成发送会话名称。

CICS 从字母数字字符 A 到 Z 以及 1 到 9 创建会话名称的最后三个字符。这些 3 字符标识以字母 AAA 开头，并按升序继续，直到会话条目数达到 SENDCOUNT 值设置的限制为止。

例如，使用缺省前缀 (>) ， CICS 将会话名称生成为> AAA ，> AAB ，> AAC 等。如果使用超过 46656 个会话 (>AAA 到> 999) ，那么 CICS 会分配 AAA> 到 999> 的下一个范围。 (此会话标识生成方法与 APPC 会话相同，但初始符号除外。)

具有超过 46656 个会话的区域的性能可能不高。您应该考虑增加 CICS 区域数的替代方法。

虽然您最多可以定义 93312 个 MRO 会话，但当前存在阻止您尝试一次获取超过 65535 个会话的限制。如果所有伙伴区域都已启动并正在运行，那么在 CICS 启动期间或 CEDA 安装期间可能会发生此情况，超过 65536 个会话。稍后可以获取更多会话。

注: 如果您指定自己的前缀，那么 CICS 将以与 LUTYPE6.1 会话相同的方式生成会话名称。

prefix (针对 LUTYPE6.1 会话)

如果会话位于 LUTYPE6.1 ISC 连接上，那么必须指定 1 或 2 字符前缀。请勿将缺省> 符号用于 LUTYPE6.1 会话。

对于 LUTYPE6.1 会话 (如果您指定自己的 1 或 2 字符前缀) ， CICS 会通过将数字附加到前缀 (范围在 1 到 99 或 1 到 999 之间) 来生成会话名称。该数字以 1 开头，并按 1 递增，直到达到指定的 SENDCOUNT 为止。

SENDSIZE({4096|number})

指定这些会话能够发送的最大 z/OS Communications Server 请求单元 (RU) 大小。对于 LU61 会话，该值必须介于 1 与 30720 之间，对于 APPC 会话，该值必须介于 256 与 30720 之间。缺省值为 4096。可以在绑定时协商该值。增大 SENDSIZE 的值会导致为会话分配更多存储器，但可能会减少在两个节点之间发送的物理消息数。

如果 CICS 是辅助 LU 会话，那么此属性指示这些会话能够接收的最大 z/OS Communications Server 请求单元 (RU) 大小。该值必须介于 256 与 30720 之间。

SESSIONS(名称)

指定此 SESSIONS 定义的名称。该名称的最大长度为 8 个字符。

可接受的字符：

A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

此名称用于标识 CSD 文件上的 SESSIONS 定义。它不会在活动的 CICS 系统中使用。

SESSNAME(sessname)

指定要用作 CICS 双向通信并行会话中会话限定符对的本地半部分的符号标识。该名称的最大长度为 4 个字符。

可接受的字符：

A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

SESSPRIORITY({0|优先级})

指定终端优先级。此十进制值 (0 到 255) 用于建立整体事务处理优先级。（事务处理优先级等于终端优先级、事务优先级和运算符优先级之和；该值不能超过 255。）

TRANSACTION

该属性已过时，但仍受支持，用于提供与 CICS 较早发行版的兼容性。

USERAREALEN({0|number})

指定此会话的用户区域的长度 (以字节计) ，范围在 0 到 255 之间。应尽量小。安装会话时，终端用户区域将初始化为零。

终端用户区域可能位于 31 位存储器或 24 位存储器中，具体取决于 TCTUALOC 系统初始化参数的值。缺省情况是终端用户区域可以位于 31 位存储器或 24 位存储器中，但 CICS 尽可能使用 31 位存储器。如果您要求终端用户区域位于 24 位存储器中，因为您有不支持 31 位寻址的应用程序，请为 CICS 区域指定系统初始化参数 TCTUALOC=BELOW 。

USERID(userid)

指定用于登录的用户标识 (SEC = YES) ，并在安全错误消息，安全违例消息和审计跟踪中引用。它必须是对安全管理器定义的有效用户标识，否则操作员将无法登录。对受保护资源的所有访问权都取决于 USERID。

此 USERID 覆盖在 CONNECTION 定义上指定的 SECURITYNAME。

该名称的最大长度为 8 个字符。

可接受的字符：

A-Z 0-9 $ @ #

除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。