ASSIGN

描述

ASSIGN 命令从应用程序的本地环境外部获取值。 获取的数据取决于指定的选项。 最多可以在一个 ASSIGN 命令中指定 16 个选项。 在 ASSIGN 命令上指定多个选项时，如果任何指定选项因异常条件 INVREQ 而失败，那么其他指定选项仍将填充所请求的信息。

对于适用于终端或终端相关数据的选项，引用始终是主体设施。

如果主体设施是远程终端，那么将从信息的本地副本获取返回的数据。 该请求未路由到远程终端所连接的系统。

事务路由尽可能对 ASSIGN 命令透明。 通常，无论事务是本地事务还是远程事务，返回的值都相同。

有关这些选项的更多信息，请参阅 在系统间环境中开发。

选项

ABCODE (数据区)

此选项返回 4 字符的当前异常终止代码。 异常终止代码记录在 事务异常终止代码中。 如果未发生异常终止，那么该变量将设置为空白。

ABDUMP (数据区)

此选项返回 1 字节值。 X'FF' 指示发出了不带 NODUMP 选项的 EXEC CICS ABEND ABCODE 命令，并且 ABCODE 包含异常终止代码。 X'00' 指示未生成内存转储，或者 ABCODE 包含空白。

ABOFFSET (数据区)

此选项返回发生最新异常终止代码 ASRA ， ASRB 或 ASRD 时异常终止的全字二进制偏移量 (以字节计)。 如果异常终止在当前程序外部，那么将返回值 X'FFFFFFFF' 。 如果在执行发出事务期间未发生 ASRA ， ASRB 或 ASRD 异常终止，或者如果最初在远程 DPL 服务器程序中发生异常终止，那么数据区将设置为二进制零。

ABPROGRAM (数据区)

此选项返回最新异常终止的失败程序的 8 字符名称。

如果最初在远程系统中运行的 DPL 服务器程序中发生异常终止，那么 ABPROGRAM 将返回 DPL 服务器程序名。

如果在异常结束时无法确定失败的程序，那么此字段将设置为二进制零。

当最新异常结束是 APCT (由于尝试装入程序，映射集或分区集失败而导致) 时，将从未装入的程序，映射集或分区集获取名称。

ACTIVITY (数据区)

如果此程序正在代表 CICS® 业务事务服务 (BTS) 活动运行，那么此选项将返回 16 个字符的活动名称。

在 CICS 和业务事务服务 (BTS)中描述了 BTS。

ACTIVITYID (数据区)

如果此程序正在代表 BTS 活动运行，那么此选项将返回活动实例的 52 个字符，即 CICS分配的标识。

如果在当前进程外部运行的程序想要获取此活动实例的控制权，那么它必须在 ACQUIRE ACTIVITYID 命令上指定此标识。

在 CICS 和业务事务服务 (BTS)中描述了 BTS。

ALTSCRNHT (数据区)

此选项返回为终端定义为半字二进制变量的备用屏幕高度。 如果未从终端启动任务，那么将发生 INVREQ。

ALTSCRNWD (数据区)

此选项返回为终端定义为半字二进制变量的备用屏幕宽度。 如果未从终端启动任务，那么将发生 INVREQ。

APLKYBD (数据区)

此选项返回 1 字节指示符，用于显示终端键盘是否具有 APL 键盘功能 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

APLTEXT (data-area)

此选项返回一个 1 字节指示符，用于显示终端键盘是否具有 APL 文本功能 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

应用程序 (数据区)

此选项返回与任务关联的 current 应用程序的 64 个字符的名称。 它是由应用程序名称，平台名称，操作名称以及应用程序的主版本号，次版本号和微版本号组成的应用程序上下文的一部分。 如果没有应用程序上下文与任务相关联，那么将返回空白。

APPLID (data-area)

此选项返回拥有事务的 CICS 系统的 8 字符 APPLID。

如果系统正在使用 XRF ，那么返回的值是通用 APPLID。 应用程序不受从活动到备用的接管的影响。

ASRAINTRPT (数据区)

此选项返回一个 8 字符的数据区，该数据区包含 ILC (指令长度代码) 和 PIC (程序中断代码) ，在发生最新异常终止时，代码为 AICA ， ASRA ， ASRB ， ASRD 或 ASRE。 如果在执行发出事务期间未发生 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止，或者如果异常终止最初发生在远程 DPL 服务器程序中，那么该字段包含二进制零。 有效时，返回的 8 字节的内容如下所示:

• ILC (2 字节二进制)
• PIC (2 字节二进制)
• 填充符 (4 字节二进制，始终为零)

ASRAKEY (cvda)

此选项返回上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止 (如果有) 时的执行键。 CVDA 值如下：

CICSEXECKEY

如果任务在上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止时在 CICS-key 中运行，那么将返回此值。 如果 CICS 子系统存储器保护未处于活动状态，那么所有程序都将在 CICS 键中运行。

用户 XECKEY

如果任务在上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止时以用户键运行，那么将返回此值。

非中文科

如果上次异常结束时的执行密钥不是其中一个 CICS 密钥 (例如，不是密钥 8 或密钥 9) ，那么将返回此值。

NOTAPPLIC

如果不存在 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止，那么将返回此值。

ASRAPSW (数据区)

此选项返回一个 8 字节的数据区，该数据区包含程序状态字 (PSW) ，发生最新异常终止时，代码为 AICA ， ASRA ， ASRB ， ASRD 或 ASRE。

如果在执行发出事务期间未发生 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止，或者如果异常终止最初发生在远程 DPL 服务器程序中，那么该字段包含二进制零。

ASRAPSW16 (数据区)

此选项返回一个包含 128 位程序状态字 (PSW) 的 16 字节数据区，该数据区的最新异常终止发生时代码为 AICA ， ASRA ， ASRB ， ASRD 或 ASRE。

如果在执行发出事务期间未发生 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止，或者如果异常终止最初发生在远程 DPL 服务器程序中，那么该字段包含二进制零。

ASRAREGS (data-area)

此选项在发生最新的 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止时返回常规寄存器 0-15 的内容。

寄存器的内容在数据区 (长度为 64 字节) 中返回，顺序为 0 ， 1 ， ... ， 14, 15.

如果在执行发出事务期间未发生 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止，或者如果最初在远程 DPL 服务器程序中发生异常终止，那么数据区将设置为二进制零。

ASRAREGS64 (数据区)

此选项在发生最新的 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止时返回 64 位常规寄存器 0-15 的内容。

寄存器的内容在数据区 (长度为 128 个字节) 中返回，顺序为 0 ， 1 ， ... ， 14, 15.

如果在执行发出事务期间未发生 AICA ， ASRA ， ASRB ， ASRD 或 ASRE 异常终止，或者如果最初在远程 DPL 服务器程序中发生异常终止，那么数据区将设置为二进制零。

ASRASPC (cvda)

返回上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止 (如果有) 时控制的空间类型。 CVDA 值如下：

子空间

如果任务在上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止时在其自己的子空间或公共子空间中运行，那么将返回此值。

基础空间

如果任务在上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止时在基本空间中运行，那么将返回此值。 如果事务隔离未处于活动状态，那么所有任务都在基本空间中运行。

NOTAPPLIC

如果不存在 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止，那么将返回此值。

ASRASTG (cvda)

此选项返回上次 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止 (如果有) 时正在寻址的存储器类型。 CVDA 值如下所示：

CICS

如果要寻址的存储器是 CICS-key 存储器，那么将返回此值。 这可以在其中一个 CICS 动态存储区域中。 当 CICS 使用 RENTPGM 系统初始化参数上的 NOPROTECT 选项运行时，或者当存储器保护未处于活动状态时，可以在其中一个只读动态存储器区域中执行此操作。

USER

如果要寻址的存储器是其中一个用户动态存储器区域 (UDSA ， EUDSA 或 GUDSA) 中的用户密钥存储器，那么将返回此值。

readOnly

当 CICS 使用 RENTPGM 系统初始化参数上的 PROTECT 选项运行时，如果要寻址的存储器是其中一个只读动态存储器区域 (RDSA 或 ERDSA) 中的只读存储器，那么将返回此值。

NOTAPPLIC

在以下情况下将返回此值:

• 找不到此任务的 AEYD ， AEYF ， AICA ， ASRA 或 ASRB 异常终止。
• 异常终止中受影响的存储器不受 CICS管理。
• ASRA 异常终止不是由 0C4 异常终止引起的。

BRIDGE (数据区)

此选项返回发出 START BREXIT TRANSID 命令以启动发出此命令的用户事务的网桥监视器事务的 4 字符 TRANSID。 在以下情况下将返回空白:

• 网桥监视器事务未启动用户事务。
• 此命令由分布式程序链接 (DPL) 请求启动的程序发出。

注: 如果从网桥出口发出 START BREXIT 命令，那么返回的 TRANSID 是发出 START BREXIT 命名网桥出口的网桥监视器的 TRANSID。

BTRANS (数据区)

此选项返回一个 1 字节指示符，该指示符显示终端是否定义为具有后台透明能力 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

CHANNEL (数据区)

此选项返回程序的当前通道的 16 个字符的名称 (如果存在); 否则，返回空白。

CMDSEC (数据区)

此选项返回一个 1 字节指示符，该指示符显示是否为当前任务定义了命令安全性检查。 (X 表示 "是" ，空白表示 "否"。)

COLOR (数据区)

此选项返回一个 1 字节指示符，用于显示终端是否定义为具有扩展颜色功能 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

CWALENG (data-area)

此选项返回一个半字二进制字段，该字段指示公共工作区 (CWA) 的长度。 如果不存在 CWA ，那么将返回零长度。

DEFSCRNHT (数据区)

此选项返回一个半字二进制变量，该变量包含为终端定义的缺省屏幕高度。 如果未从终端启动任务，那么将发生 INVREQ。

DEFSCRNWD (数据区)

此选项返回一个半字二进制变量，该变量包含为终端定义的缺省屏幕宽度。 如果未从终端启动任务，那么将发生 INVREQ。

DELIMITER (数据区)

此选项返回 3600 的 1 字节数据链路控制字符。 可能的值包括：

X'80 '

输入以文本结束符 (ETX) 结束。

X'40 '

输入以块结束 (ETB) 结束。

X'20 '

输入以记录间分隔符 (IRS) 结束。

X'10'

输入以头开始 (SOH) 结束。

X'08'

透明输入。

如果未从终端启动任务，那么将发生 INVREQ。

DESTCOUNT (数据区)

此选项返回半字二进制字段。 此选项具有以下用途:

• 在 BMS ROUTE 命令之后，它显示所需的值是路由列表中不同终端类型的数目，从而显示可能需要的溢出控制区的数目。
• 在 BMS 溢出处理中，它显示所需的值是迂到溢出的目标的相对溢出控制号。 如果在溢出处理未生效时指定此选项，那么获取的值无意义。 如果未发出 BMS 命令，那么会发生 INVREQ。

DESTID (data-area)

此选项返回外部目标的 8 字节标识，在 8 个字符的右边填充空白。 如果在任务中发出批处理数据交换命令之前指定了此选项，那么将发生 INVREQ。

DESTIDLENG (数据区)

此选项返回 DESTID 获取的目标标识的半字二进制长度。 如果在任务中发出批处理数据交换命令之前指定了此选项，那么将发生 INVREQ。

DSSCS (数据区)

此选项返回一个 1 字节的指示符，该指示符显示主体设施是基本 SCS 数据流设备 (X'FF') 还是 (X'00')。

如果未从终端启动任务，那么将发生 INVREQ。

DS3270 (数据区)

此选项返回一个 1 字节指示符，该指示符显示主体设施是否为 3270 数据流设备 (X'FF') (X'00')。

如果未从终端启动任务，那么将发生 INVREQ。

ERRORMSG (data-area)

此选项返回在 CICS 任务的事务异常终止控制块中引用的最多 500 字节的错误消息。 在 DPL 请求失败后，消息是从远程系统返回的消息。 对于短于 500 字节的消息，将使用空值填充消息。

如果不存在任何消息，那么 500 字节区域包含空值。

ERRORMSGLEN (data-area)

此选项返回半字二进制值，该值表示针对 ERRORMSG 返回的消息的长度。 如果事务异常终止控制块中引用的消息超过 500 字节，那么将截断该消息并将其长度设置为 500。

如果不存在任何消息，那么返回的长度为 0。

EWASUPP (数据区)

此选项返回一个 1 字节的指示符，该指示符显示 "擦除写入替代项" 是否受支持 (X'FF') (X'00')。

如果未从终端启动任务，那么将发生 INVREQ。

EXTDS (数据区)

此选项返回一个 1 字节指示符，该指示符显示终端是否接受 3270 扩展数据流 (X'FF') (X'00')。 支持查询功能，颜色，扩展突出显示，编程符号或验证的终端需要扩展数据流功能。 接受查询结构化字段命令的终端也具有此指示符集。 如果扩展数据流已开启，那么设备支持写入结构化字段 COMMAND 和出站查询结构化字段。

有关查询结构化字段的详细信息，请参阅 IBM 3270 数据流程序员参考。

如果未从终端启动任务，那么将发生 INVREQ。

FACILITY (数据区)

此选项返回发起发出此命令的事务的主体设施的 4 字节标识。 如果指定了此选项，并且未分配任何设施，那么将发生 INVREQ。

注: 如果事务是由瞬时数据触发器级别到期启动的，那么可以使用 QNAME 选项来获取瞬时数据分区内队列的名称。

FCI (数据区)

此选项返回 1 字节的设施控制指示符。 有关更多信息，请参阅 ASSIGN 返回的代码。 这指示与事务关联的设施类型; 例如， X'01' 指示终端或逻辑单元。 将始终返回获取的值。

GCHARS (数据区)

此选项返回半字二进制图形字符集全局标识 (GCSGID)。 该值是 1-65534 范围内的数字，表示可以在终端输入或输出的图形字符集。 如果未从终端启动任务，那么将发生 INVREQ。

GCODES (数据区)

此选项返回半字二进制代码页全局标识 (CPGID)。 该值是 1-65534 范围内的数字，表示 EBCDIC 或 ASCII 代码页，用于定义可以在终端输入或输出的字符的代码点。 如果未从终端启动任务，那么将发生 INVREQ。

GMMI (数据区)

此选项返回一个 1 字节指示符，该指示符显示 good 晨 消息是否应用于与正在运行的事务 (X'FF') 相关联的终端 (X'00')。 如果指定了此选项，并且当前任务未与终端关联，那么将发生 INVREQ 条件。

GMEXITOPT (cvda)

此选项返回随 SIT 参数 GMTRAN提供的设置，该参数确定使用 PF3 或 PF15 时的终端会话和事务行为。 CVDA 值如下：

EXIT

使用 PF3 或 PF15 时，登录事务将终止。 终端会话未断开连接。

DISCONNECT

使用 PF3 或 PF15 时，终端会话将断开连接，并且登录事务将终止。

注: 只有 CICS 提供的事务才会采用 EXIT 和 DISCONNECT 选项的关联行为。 对于用户事务，必须调用此 ASSIGN 命令以发现设置了哪个选项，然后事务必须实现期望的行为。

HILIGHT (数据区)

此选项返回一个 1 字节指示符，该指示符显示终端是否定义为具有扩展突出显示功能 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

INITPARM (数据区)

此选项返回 60 个字符的数据区，其中包含在 INITPARM 系统初始化参数上为程序指定的任何初始化参数。 仅当发出命令的程序的名称与 INITPARM 系统初始化参数上指定的程序名匹配时，才会返回这些值。 如果没有程序的参数，那么不会更新区域，并且未定义其内容。 将 INITPARMLEN 与 INITPARM 配合使用以确定是否指定了参数; 不能仅使用 ASSIGN INITPARM 返回的值来指示是否指定了系统初始化参数。

INITPARMLEN (数据区)

此选项返回 INITPARM 的半字二进制长度。 如果没有参数，那么 INITPARMLEN 包含二进制零。

INPARTN (数据区)

此选项返回最新输入分区的 1 或 2 字符名称。 如果尚未定位任何映射，或者如果 BMS 路由生效，或者如果未从终端启动任务，那么会发生 INVREQ。

INPUTMSGLEN (数据区)

此选项返回终端输入字符串的半字二进制长度 (以字节为单位)。 如果没有终端输入数据，那么将返回长度为零的值。

INVOKINGPROG (数据区)

此选项返回使用 LINK 或 XCTL 命令将控制链接或传输到当前程序的应用程序的 8 字符名称:

• 如果在分布式程序链接 (DPL) 命令调用的远程程序中发出 ASSIGN INVOKINGPROG 命令，那么 CICS 将返回发出 DPL 命令的程序的名称。
• 如果在最高级别的应用程序中发出 ASSIGN INVOKINGPROG 命令，那么 CICS 将返回 8 个空白。
• 如果在用户可替换程序，网桥出口程序或程序列表程序中发出 ASSIGN INVOKINGPROG 命令，那么 CICS 将返回 8 个空白。
• 如果从全局用户出口，任务相关出口或从此类出口链接到的应用程序发出 ASSIGN INVOKINGPROG 命令，那么 CICS 将返回不是全局用户出口或任务相关用户出口的最新调用程序的名称。

KATAKANA (数据区)

此选项返回一个 1 字节指示符，用于显示主体设施是否支持片假名 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

LANGINUSE (数据区)

此选项返回显示正在使用的语言的 3 字节助记符代码。 3 字节助记符与 1 byte NATLANGINUSE 选项具有 1: 1 对应关系。 请参阅 本地语言代码 以获取代码的可能值。

LDCMNEM (数据区)

此选项返回迂到溢出的目标的 2 字节逻辑设备代码 (最不发达国家) 助记符。 如果在溢出处理未生效时指定此选项，那么获取的值不重要。 如果未发出 BMS 命令，那么会发生 INVREQ。

LDCNUM (数据区)

此选项返回迂到溢出的目标的 1 字节的最不发达国家数字值。 这指示最不发达国家的类型，例如打印机或控制台。 如果在溢出处理未生效时指定此选项，那么获取的值不重要。

LINKLEVEL (数据区)

此选项返回表示本地系统中的程序链接级别的半字二进制值。 最顶层的链接级别为 1 ，对于每个 EXEC CICS LINK ，链接级别递增 1。 对于语言 CALL 语句，链接级别不会递增。 如果程序是 DPL 请求的目标，那么返回的链接级别是在 CICS 区域中正在执行而不是更广泛的分布式事务。 如果程序被 DPLed 到，那么链接级别 1 是 CICS 镜像程序 DFHMIRS。

LOCALCCSID (数据区)

此选项返回用于 CICS 区域的全字二进制编码字符集标识 (CCSID)。 它是在 LOCALCCSID 系统初始化参数上指定的值。

MAJORVERSION (data-area)

此选项返回全字二进制值，该值表示与该任务关联的 当前 应用程序的主要版本，该任务是应用程序上下文的一部分。 如果任务未关联应用程序上下文，则返回 -1 。

MAPCOLUMN (数据区)

此选项返回包含最近定位的映射的源的屏幕上列的半字二进制数。 如果尚未定位任何映射，或者如果 BMS 路由生效，或者如果未从终端启动任务，那么会发生 INVREQ。

MAP高度 (数据区域)

此选项返回最近定位的地图的半字二进制高度。 如果尚未定位任何映射，或者如果 BMS 路由生效，或者如果未从终端启动任务，那么会发生 INVREQ。

MAPLINE (数据区)

此选项返回屏幕上包含最近定位映射的源的行的半字二进制数。 如果尚未定位任何映射，或者如果 BMS 路由生效，或者如果未从终端启动任务，那么会发生 INVREQ。

MAPWIDTH (数据区域)

此选项返回最近定位的映射的半字二进制宽度。 如果尚未定位任何映射，或者如果 BMS 路由生效，或者如果未从终端启动任务，那么会发生 INVREQ。

MICROVERSION (data-area)

此选项返回全字二进制值，该值表示与任务关联的 当前 应用程序的微版本，该任务是应用程序上下文的一部分。 如果任务未关联应用程序上下文，则返回 -1 。

MINORVERSION (数据区)

此选项返回全字二进制值，该值表示与该任务关联的 当前 应用程序的次版本，该任务是应用程序上下文的一部分。 如果任务未关联应用程序上下文，则返回 -1 。

MSRCONTROL (数据区)

此选项返回一个 1 字节的指示符，该指示符显示终端是否支持磁槽阅读器 (MSR) 控制 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

NATLANGINUSE (数据区)

此选项返回 1 字节助记符代码，该代码显示与当前任务的 USERID (可能是缺省 USERID) 关联的本地语言。 请参阅 SIGNON 命令，以获取有关如何派生此值的说明。 (NATLANGINUSE 未显示 NATLANG 系统初始化参数上指定的系统缺省语言)。

请参阅 本地语言代码 以获取代码的可能值。

NETNAME (data-area)

此选项返回 z/OS® Communications Server 网络中逻辑单元的 8 字符名称。 如果未从终端启动任务，那么将发生 INVREQ。 如果主体设施不是本地终端，那么 CICS 不再返回空字符串，而是远程终端的网络名。

如果此命令是由 3270 网桥事务启动的用户事务发出的，那么返回的值是网桥设施的 termid。

如果 CICS 区域支持 z/OS Communications Server LU 别名，那么 CICS 返回的 NETNAME 可能是由 z/OS Communications Server 动态分配或在 CDRSC 定义的 LUALIAS 参数上预定义的 LU 别名。

NEXTTRANSID (数据区)

此选项返回由 SET NEXTTRANSID 或 RETURN TRANSID设置的 4 字符下一个事务标识。 如果没有更多事务，那么将返回空白。

NUMTAB (数据区)

此选项返回在 2980 的正确验证码区域中放置打印元素所需的选项卡的 1 字节号。 如果未从终端启动任务，那么将发生 INVREQ。

OPCLASS (数据区)

该选项以 24 位字符串形式返回 BMS 用于路由终端报文的操作符类别，该类别在 CICS 段的 RACF® 中定义。

OPERATION (数据区)

此选项返回与任务关联的 current 操作的 64 个字符的名称，该任务是应用程序上下文的一部分。 如果没有与任务关联的应用程序上下文，那么将返回空白。

OPERKEYS (数据区)

为了与先前发行版兼容，接受此选项。 如果指定了此参数，那么将返回 64 位空字符串。

OPID (data-area)

此选项返回 3 字符运算符标识。 这由 BMS 用于路由终端消息，如 RACF的 CICS 段中所定义。

如果任务是从远程终端启动的，那么此命令返回的 OPID 不一定是与在远程终端注册的用户相关联的 OPID。 如果要知道注册用户的 OPID ，请使用 INQUIRE TERMINAL 系统编程命令。

如果使用 SET TERMINAL 命令更改了 OPID ，那么该 OPID 也可以与当前登录的用户的 OPID 不同。

OPSECURITY (数据区)

为了与先前发行版兼容，接受此选项。 如果指定，那么将返回 24 位空字符串。

ORGABCODE (数据区)

此选项在重复异常终止的情况下返回 4 字节的原始异常终止代码。

OUTLINE (data-area)

此选项返回一个 1 字节的指示符，该指示符显示终端是否定义为具有字段概述功能 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

PAGENUM (data-area)

此选项返回迂到溢出的目标的半字二进制当前页码。 如果在溢出处理未生效时指定此选项，那么获取的值无意义。 如果未发出 BMS 命令，那么会发生 INVREQ。

PARTNPAGE (数据区)

此选项返回最近导致页面溢出的分区的 2 字节名称。 如果未发出 BMS 命令，那么会发生 INVREQ。

PARTNS (数据区)

此选项返回显示终端是否支持分区 (X'FF') (X'00') 的 1 字节指示符。 如果未从终端启动任务，那么将发生 INVREQ。

PARTNSET (数据区)

此选项返回应用程序分区集的名称 (1-6 个字符)。 如果未设置应用程序分区，那么将返回空白值。 如果未从终端启动任务，那么将发生 INVREQ。

PLATFORM (数据区)

此选项返回与任务关联的平台的 64 个字符的名称，该任务是应用程序上下文的一部分。 如果没有与该任务关联的应用程序上下文，那么将返回空白。

PRINSYSID (数据区)

此选项返回本地系统中另一个系统已知的 4 字符名称; 即，定义另一个系统的 CONNECTION 定义。 对于由终端定义定义的单会话 APPC 设备，返回的值是终端标识。

仅当主体设施是下列其中一项时才适用:

• 与另一个 CICS 系统的 MRO 会话
• 与另一个 CICS 或 IMS 系统的 LU6.1 会话
• 与另一个 CICS 系统或另一个 APPC 系统或设备的 APPC 会话

如果主体设施不是 MRO ， LU6.1或 APPC 会话，或者如果任务没有主体设施，那么会发生 INVREQ。

注: 当事务路由时，特殊注意事项通常适用。 特别是，无法在路由事务中使用 ASSIGN PRINSYSID 命令来查找终端拥有区域的名称。 有关更多信息，请参阅 CICS 事务路由。

PROCESS (data-area)

如果此程序正在代表 CICS 业务事务服务 (BTS) 活动运行，那么此选项将返回包含该活动的 BTS 进程的 36 个字符的名称。

在 CICS 和业务事务服务 (BTS)中描述了 BTS。

PROCESSTYPE (数据区)

如果此程序正在代表 BTS 活动运行，那么此选项将返回包含该活动的 BTS 进程的 8 字符进程类型。

在 CICS 和业务事务服务 (BTS)中描述了 BTS。

PROGRAM (数据区)

此选项返回当前正在运行的程序的 8 字符名称。

PS (数据区)

此选项返回一个 1 字节指示符，该指示符显示终端是否定义为具有编程符号能力 (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

QNAME (数据区)

此选项返回瞬时数据分区内队列的 4 字符名称，此队列通过达到其触发器级别来启动此任务。 如果任务不是由自动事务启动 (ATI) 启动，那么会发生 INVREQ。

RESSEC (数据区)

此选项返回一个 1 字节指示符，该指示符显示是否为正在运行的事务定义了资源安全性检查。 (X 表示 "是" ，空白表示 "否"。)

RESTART (数据区)

此选项返回一个 1 字节的指示符，该指示符显示是已重新启动任务 (X'FF') 还是已正常启动任务 (X'00')。

RETURNPROG (数据区)

此选项返回当当前程序已完成运行时要向其返回控制权的程序的 8 字符名称。 返回的值取决于对当前程序的控制方式，如下所示:

• 如果当前程序由 LINK 命令 (包括分布式程序链接) 调用，那么 RETURNPROG 将返回与 INVOKINGPROG 相同的名称。
• 如果当前程序由 XCTL 命令调用，那么 RETURNPROG 会返回链中上次发出 LINK 命令的应用程序的名称。

  如果使用 XCTL 命令调用当前程序的程序处于最高级别，那么 CICS 将返回 8 个空白。

• 如果在顶级程序中发出 ASSIGN RETURNPROG 命令，那么 CICS 将返回 8 个空白。
• 如果在用户可替换模块或程序列表表程序中发出 ASSIGN RETURNPROG 命令，那么 CICS 将返回 8 个空白。
• 如果在全局用户出口，与任务相关的出口或从此类出口链接到的应用程序中发出 ASSIGN RETURNPROG 命令，那么 CICS 将返回在完成所有中间全局用户出口和与任务相关的用户出口程序时返回的控制程序的名称。

示例：

Program A links to program B
Program B links to program C
Program C uses XCTL to transfer control to program D 
Program D issues an ASSIGN RETURNPROG command, and CICS returns the name of 
Program B.

SCRNHT (数据区)

此选项返回一个半字二进制变量，其中包含为当前任务定义的 3270 屏幕的高度。 如果未从终端启动任务，那么将发生 INVREQ。

SCRNWD (数据区)

此选项返回一个半字二进制变量，该变量包含为当前任务定义的 3270 屏幕的宽度。 如果未从终端启动任务，那么将发生 INVREQ。

SIGDATA (数据区)

此选项返回包含从逻辑单元接收的入站信号数据的 4 字节字符串。 如果未从终端启动任务，那么将发生 INVREQ。

SOSI (数据区)

此选项返回一个 1 字节的指示符，该指示符显示终端是否定义为具有混合的 IBMIC/DBCS 字段功能 (X'FF') (X'00')。 EBCDIC 字段中的 DBCS 子字段由 SO (移出) 和 SI (移入) 字符定界。 如果未从终端启动任务，那么将发生 INVREQ。

STARTCODE (数据区)

此选项返回 2 字符值，该值指示发出请求的事务的启动方式。 可能的值包括：

代码

事务启动者

D

未指定 SYNCONRETURN 选项的分布式程序链接 (DPL) 请求。 该任务无法针对其主体设施或任何同步点请求发出 I/O 请求。

DS

指定了 SYNCONRETURN 选项的分布式程序链接 (DPL) 请求，如代码 D 中所示。 该任务可以发出同步点请求。

QD

瞬时数据触发器级别。

S

未在 FROM 选项中传递数据的 START 命令。 它可能已传递通道，也可能未传递通道。

SD

在 FROM 选项中传递数据的 START 命令。

SZ

FEPI START 命令。

TD

终端输入或永久转换。

U

用户连接的任务。

STATIONID (data-area)

此选项返回 2980 的 1 字节站标识。 如果未从终端启动任务，那么将发生 INVREQ。

SYSID (data-area)

此选项返回提供给本地 CICS 系统的 4 字符名称。 可以在文件控制，时间间隔控制，临时存储器或瞬时数据命令的 SYSID 选项中指定此值，在这种情况下，假定要访问的资源位于本地系统上。

TASKPRIORITY (数据区域)

此选项返回半字二进制字段，该字段指示发出任务的当前优先级 (0-255)。 首次附加任务时，这是用户，终端和事务优先级的总和。 CHANGE TASK 命令可以在执行期间更改此值。

T夜力 (数据区)

此选项返回终端控制表用户区域 (TCTUA) 的半字二进制长度。 如果不存在 TCTUA ，那么将返回零长度。

TELLERID (数据区)

此选项返回 2980 的 1 字节的柜员标识。 如果未从终端启动任务，那么将发生 INVREQ。

TERMCODE (数据区)

此选项返回 2 字节代码，用于提供与任务关联的终端的类型和型号。

第一个字节是标识从 TERMINAL 资源派生的终端类型的代码。 有关资源属性的描述，请参阅 TERMINAL 资源。 第二个字节是 TERMMODEL 属性中指定的单字符型号。

类型代码的含义在 ASSIGN 返回的代码中给出。

TERMPRIORITY (数据区)

此选项返回半字二进制终端优先级 (0-255)。

TEXTKYBD (数据区)

此选项返回一个 1 字节指示符，用于显示主体设施是否支持 TEXTKYBD (X'FF') (X'00')。 如果未从终端启动任务，那么将发生 INVREQ。

TEXTPRINT (data-area)

此选项返回显示主体设施是否支持 TEXTPRINT (X'FF') (X'00') 的 1 字节指示符。 如果未从终端启动任务，那么将发生 INVREQ。

TNADDR (数据区)

在 39 个字符的区域中，返回 TN3270 客户机的 IPv4 或 IPv6 地址。 如果 TNIPFAMILY 返回 NOTAPPLIC，那么 TNADDR 返回空白。

如果未从终端启动任务，那么将发生 INVREQ。

TNIPFAMILY (cvda)

返回 TNADDR 选项的地址格式。 CVDA 值如下所示：

NOTAPPLIC

此值指示下列其中一种情况:

• 终端不是 3270 设备。
• 未使用 TNADDR。
• 无法解析地址。

IPV4

TNADDR 选项包含 IPv4 点分十进制地址。

IPV6

TNADDR 选项包含 IPv6 冒号十六进制地址。

如果未从终端启动任务，那么将发生 INVREQ。

TNPORT (数据区)

返回包含用于 TN3270 客户机连接的端口号的全字二进制值。 如果此终端不是 3270 设备，那么 TNPORT 会返回零。

如果未从终端启动任务，那么将发生 INVREQ。

TRANPRIORITY (数据区)

此选项返回半字二进制事务优先级 (0-255)。

TWALENG (数据区)

此选项返回事务工作区 (TWA) 的半字二进制长度。 如果不存在 TWA ，那么将返回零长度。

UNATTEND (数据区)

此选项返回一个 1 字节的指示符，该指示符显示终端的操作方式是否为无人照管，即，无人照管终端。 这些指示符为 X'FF' 表示无人照管， X'00' 表示有人照管。 如果未从终端启动任务，那么将发生 INVREQ。

USERID (数据区)

此选项返回注册用户的 8 字节用户标识。 如果未显式登录用户，那么 CICS 将返回缺省用户标识。 如果您使用的是双向通信环境，那么特殊注意事项适用。 有关 LUTYPE6.1， APPC 和 MRO 的 ASSIGN 命令的更多信息，请参阅 相互通信方法

USERNAME (数据区)

此选项返回从 RACF获取的 20 个字符的用户名称。

USERPRIORITY (数据区)

此选项返回半字二进制运算符优先级 (0-255)。

VALIDATION (数据区)

此选项返回一个 1 字节指示符，该指示符显示终端是否定义为具有验证功能 (X'FF') (X'00')。 验证功能由强制填充，强制输入和触发器属性组成。 如果未从终端启动任务，那么将发生 INVREQ。

条件

ASSIGN 命令始终返回 CECI 下或 REXX 程序中的异常条件 INVREQ。 即使 CECI 或 REXX 程序可能返回正确请求的信息，它也会尝试从其他选项获取信息，其中一些选项无效。

16 INVREQ

RESP2 值：

2

尚未发出任何 BMS 命令， BMS 路由已生效，或者尚未定位任何映射。

3

尚未发出批处理数据交换 (BDI) 命令。

4

任务不是由自动事务启动 (ATI) 启动的。

5

该任务未与终端关联; 或者该任务没有主体设施; 或者该主体设施不是 MRO ， LU6.1或 APPC 会话。

6

从 CICS BTS 环境外部发出了 CICS BTS 请求。 因此，事务未代表 BTS 活动运行。

200

在分布式程序链接调用的服务器程序中不允许使用命令语法选项。

缺省操作: 异常终止任务。

由 ASSIGN 返回的代码