文件控制域出口, XFCFRIN 和 XFCFROUT
XFCFRIN 出口是在进入主文件控制请求门 FCFR 时调用的,并且 XFCFROUT 出口在文件控制请求完成后运行。 必须将 XFCFRIN 和 XFCFROUT 出口编码为线程安全标准并声明为线程安全,以利用线程安全的远程文件支持。
- XFCFRIN
- XFCFRIN 允许您编写程序以执行下列一项或多项任务:
- 监视文件控制请求并允许它们继续,由 CICS® 文件控制处理
- 拦截文件控制请求并完全绕过 CICS 文件控制处理
- 将请求重定向到远程区域。
如果出口程序将请求传递给 CICS 文件控制 (而不选择将其重定向到远程区域) ,那么不允许对任何参数进行更改。 如果出口程序拦截请求并绕过文件控制:
- 它必须返回文件控制本来会返回的所有响应和输出参数。 这些参数在特定于出口的参数的描述中标记为 输出 。
- 它必须指示如果请求是函数输送的,是否允许镜像事务终止。 某些文件控制请求要求先前在同一事务中执行了另一个请求。 (例如, READNEXT 前面必须有匹配的 STARTBR; REWRITE 前面必须有匹配的 READ , READNEXT 或带有 UPDATE 选项的 READPREV)。 如果镜像事务在两个此类请求之间终止,那么第二个可能会失败。 相反,不必要地保留的镜像事务将占用 CICS 资源,并可能导致存储和锁定问题。
- CICS 在同步点处理过程中终止文件浏览和未完成的更新。 但是,不会对同步点调用 XFCFRIN 出口。 如果要准确仿真 CICS 行为的这一方面,或者要支持可恢复资源,那么必须调用用于调度同步点管理器的任务相关用户出口程序-请参阅 编码要由 CICS 同步点管理器启动的程序。
要将请求重定向到远程区域,出口程序必须添加或更改 SYSID 参数的值。 在这种情况下,它可能还需要提供键长度和记录长度的值。 不允许对任何其他参数进行更改。
- XFCFROUT
- XFCFROUT 允许您监视已完成的文件控制请求的结果。 例如,如果未选择绕过 CICS 文件控制处理,那么可以分析 (CICS-internal) 文件控制请求以确定其类型,传递到文件控制的参数以及返回的值。 在以下两种情况下都将调用此函数:
- 在 CICS 文件控制正常完成其处理或发生错误后
- 如果 XFCFRIN 出口程序选择绕过 CICS 文件控制处理。
所有参数都是输入参数; 您的出口程序无法修改任何值。
要将 IPIC 连接用于函数输送文件控制请求,请先确保 XFCFRIN 和 XFCFROUT 检查 UEPTERM 参数是否为非零值,然后再尝试将其用作地址。 对于已通过 IPIC 连接交付功能的文件控制请求, UEPTERM 参数为零。