退出 XICTENF
当 EXEC CICS® START 命令所需的终端在此系统中未知时,出口 XICTENF 由时间间隔控制程序调用。
- 调用时机
- 通过时间间隔控制程序,当 EXEC CICS START 命令所需的终端在此系统中未知时。 期望出口程序提供一个返回码,指示终端是否存在于另一个已连接的 CICS 系统上,如果存在,那么在哪个系统上存在该终端。
- 特定于出口的参数
- UEPICEVT
- 包含请求类型的 2 字节的地址。 类型的等同值为:
- UEPICESD
- 带有数据的 START 命令
- UEPICES
- 没有数据的 START 命令。
- UEPICTR
- 1 字节的地址,其中包含发出 START 命令的任务是否由事务路由启动的指示。 等同的值为:
- UEPICTY
- 正在处理 START 命令,发出该命令的任务已路由至事务。
- UEPICTN
- 未处理 START 命令 或 正在处理 START 命令,但发出该命令的任务未路由至事务。
- UEPICFS
- 1 字节的地址,其中包含指示 START 命令是否已交付功能的指示。 等同的值为:
- UEPICFY
- 正在处理 START 命令,并且交付了 START 功能。
- UEPICFN
- 未处理 START 命令 或 正在处理 START ,但未交付该命令的功能。
- UEPICTRN
- 4 字节的地址,其中包含要运行的事务的名称。
- UEPICRTR
- 4 字节的地址,其中包含应运行事务的终端的名称。
- UEPICCTR
- 4 字节的地址,对于 START 命令,包含当前终端的名称 (如果已路由该命令) 或会话的名称 (如果已交付该命令)。
对于其他 START 命令,指向的字段包含空格。
- UEPICNTI
- 8 字节的地址,对于函数输送的 START 命令,包含请求来自的最后一个系统的网络名。
对于此系统中通过事务路由到任务而发出的 START 命令,这是从中路由任务的最后一个系统的网络名。
对于其他 START 命令情况,指向的字段包含空白。
- UEPICSYI
- 4 字节的地址,如果 UEPICNTI 包含网络名,那么包含相应的 SYSID。
如果 UEPICNTI 不包含网络名,那么指向的字段为空白。
- UEPICNTO
- 包含 UEPICNTI 内容的 8 字节的地址。
如果它设置返回码 "UERCNETN" ,那么出口程序必须在此字段中放置 ATI 请求应发送到的系统的网络名。
- UEPICSYO
- 包含 UEPICSYI 内容的 4 字节的地址。
如果它设置返回码 "UERCSYSI" ,那么出口程序必须将 ATI 请求应发送到的系统的 sysid 放在此字段中。
- UEPICNNI
- 4 字节输入字段的地址,其中包含要运行事务的终端的网络名 (如果 CICS知道)。 如果 CICS 不知道网络名,那么寻址字段包含空白。
- UEPICNNO
- 调用时包含 UEPICNNI 内容的 4 字节输入/输出字段的地址。 您的出口程序可以使用此字段来提供要运行事务的终端的网络名。 如果将 ATI 请求定向到的 TOR 是 z/OS® Communications Server 通用资源的成员,那么出口程序提供终端网络名非常重要。
- 返回码
- UERCTEUN
- 终端未知,拒绝请求。
- UERCNETN
- 终端已知,在 UEPICNTO 中返回了网络名。
- UERCSYSI
- 终端已知,在 UEPICSYO 中返回了 sysid。
- UERCPURG
- 在 XPI 调用期间清除了任务。
- XPI 调用
- 不得使用以下内容:
- 添加暂挂
- 删除暂挂
- 出队 (dequeue)
- ENQUEUE
- RESUME
- SUSPEND
- WAIT_MVS。
样本出口程序
DFHXTENF 是可用于 XALTENF 和 XICTENF 出口的样本程序。 有关 DFHXTENF 的更多信息,请参阅 Terminal-not-known sample exit program: DFHXTENF。