退出 XFCFROUT

在完成文件控制请求后调用出口 XFCFROUT。

特定于出口的参数
UEPTRANID
4 字节事务标识的地址。
UEPUSER
8 字节用户标识的地址。
UEPTERM
零，或 4 字节终端标识的地址。 如果未返回地址，这可能意味着此请求已通过 IPIC 连接交付。
UEPPROG
8 字节应用程序名称的地址。
UEP_FC_FUNCTION
包含函数的字节的地址。 可能的值包括：
  • UEP_FC_FUN_READ_INTO
  • UEP_FC_FUN_READ_SET
  • UEP_FC_FUN_READ_UPDATE_INTO
  • UEP_FC_FUN_READ_UPDATE_SET
  • UEP_FC_FUN_WRITE
  • UEP_FC_FUN_REWRITE
  • UEP_FC_FUN_REWRITE_DELETE
  • UEP_FC_FUN_DELETE
  • UEP_FC_FUN_UNLOCK
  • UEP_FC_FUN_START_BROWSE
  • UEP_FC_FUN_READ_NEXT_INTO
  • UEP_FC_FUN_READ_NEXT_SET
  • UEP_FC_FUN_READ_PREVIOUS_INTO
  • UEP_FC_FUN_READ_PREVIOUS_SET
  • UEP_FC_FUN_READ_NEXT_UPDATE_INTO
  • UEP_FC_FUN_READ_NEXT_UPDATE_SET
  • UEP_FC_FUN_READ_PREVIOUS_UPDATE_INTO
  • UEP_FC_FUN_READ_PREVIOUS_UPDATE_SET
  • UEP_FC_FUN_RESET_BROWSE
  • UEP_FC_FUN_END_BROWSE
UEPTSTOK
在任务的整个生命周期内有效的 4 字节令牌的地址。 请参阅 使用任务令牌 UEPTSTOK。
UEP_FC_FILE_NAME
包含文件名的 8 字节字段的地址。
UEP_FC_BUFFER_P
包含由请求发起方提供的缓冲区地址的全字的地址，其中记录是在完成带有 INTO 选项的 READ ， READ NEXT 或 READ PREV 请求时返回的。
UEP_FC_BUFFER_L
包含 (对于 READ ， READ NEXT 和 READ PREV 请求) 读取记录的缓冲区的 LENGTH 值的全字的地址。
UEP_FC_RECORD_P
下列其中一项的地址:
  • 如果请求是带有 SET 选项的 READ ， READ NEXT 或 READ PREV 请求，那么将返回一个全字，在该全字中返回记录所在的缓冲区的地址。
  • 如果请求是 WRITE 或 REWRITE ，那么是包含所写入记录的地址的全字。
UEP_FC_RECORD_L
包含 LENGTH 值 (对于 READ ， WRITE ， REWRITE ， READ NEXT 和 READ PREV 请求) 的全字的地址。

对于所有 READ ， READ NEXT 或 READ PREV 请求，这是一个输出字段，包含记录读取的实际长度。 对于这些类型的请求，此记录长度值始终存在，即使未在 EXEC CICS API 调用上指定 LENGTH 选项也是如此。

对于 WRITE 或 REWRITE ，这是可选字段，如果存在此字段，那么将包含写入的记录的长度。

UEP_FC_MAX_RECORD_L
包含文件最大记录长度的全字的地址。
UEP_FC_RECORD_ID_P
包含 RIDFLD (记录标识) 值的地址的全字的地址。 有关记录标识何时是输入或输出字段的讨论，请参阅 表 1。
UEP_FC_RECORD_ID_L
KEYLENGTH 的半字值的地址，它是记录标识的 (可能是部分) 长度。

记录标识的长度是 READ ， WRITE ， DELETE ， START BR ， READ NEXT ， READ PREV 和 RESET BR 请求的可选输入参数。

UEP_FC_FULL_RECORD_ID_L
记录标识的完整长度的半字值的地址。 (记录标识的完整长度对应于 EXEC CICS 接口的 KEYLENGTH 关键字。)

记录标识的完整长度作为 READ NEXT 和 READ PREV 请求的必填输出字段返回。

UEP_FC_RECORD_ID_TYPE
包含 RIDFLD 类型的字节的地址 (对于 READ ， WRITE ， DELETE ， START BR ， READ NEXT ， READ PREV 和 RESET BR 请求)。
UEP_FC_KEY
VSAM KSDS 或 AIX® PATH 访问
UEP_FC_RBA
通过 RBA 访问 VSAM ESDS 或 KSDS
UEP_FC_RRN
VSAM RRDS 访问
UEP_FC_DEBKEY
BDAM 按键解锁 (仅 READ ， DELETE ， START BR 和 RESET BR 请求)
UEP_FC_DEBREC
BDAM 按相对记录进行的分块 (仅 READ ， DELETE ， START BR 和 RESET BR 请求)
UEP_FC_XRBA
VSAM 扩展 ESDS 访问
UEP_FC_REQID
半字值 REQID 的地址 (对于 START BR ， READ NEXT ， READ PREV ， RESET BR 和 END BR 请求)。
UEP_FC_NUMREC
NUMREC 全字值的地址，其中 (如果请求使用 RIDFLD DELETE) 返回已删除的记录数。
UEP_FC_KEY_比较
包含键比较设置的字节的地址 (对于 READ ， START BR 和 RESET BR 请求)。
UEP_FC_EQUAL
键-等于-比较。
UEP_FC_GTEQ
键-大于或等于-比较。
UEP_FC_GENERIC
包含 (对于 READ ， DELETE ， START BR 和 RESET BR 请求) 通用键设置的字节的地址。
UEP_FC_GENERIC_KEY
用于密钥搜索的通用密钥。
UEP_FC_FULL_KEY
用于密钥搜索的完整密钥。
UEP_FC_MASS_INSERT
包含 (针对 WRITE 请求) 批量插入设置的字节的地址。
UEP_FC_SEQUENTIAL_WRITE
顺序方式。
UEP_FC_DIRECT_WRITE
直接方式。
UEP_FC_READ_INTEGRITY
包含读完整性设置 (对于非更新 READ ， READ NEXT 和 READ PREV 请求) 的字节的地址。 (在当前版本的 CICS®中，此设置仅适用于 VSAM RLS。)
UEP_FC_CR
一致的读完整性。
UEP_FC_FCT_VALUE
根据 FILE 定义中的设置读取完整性。
UEP_FC_NRI
无读完整性。
UEP_FC_RR
可重复的读完整性。
UEP_FC_TOKEN
包含 TOKEN 值的全字的地址。

如果请求为 READ ， READ NEXT 或带有更新的 READ PREV ，并且地址不为空，那么该区域是返回令牌的输出字段。

如果请求是 REWRITE ，不带 RIDFLD 的 DELETE 或 UNLOCK ，那么该区域是输入字段。

UEP_FC_SYSID
包含标识远程区域的 SYSID 的 4 字节区域的地址。 在 XFCFROUT 出口的输入中，该区域包含以下任一项:
  • API 调用的 SYSID 选项的值， 或
  • 空白 (如果未指定 SYSID) ，或
  • XFCFRIN 出口指定的 SYSID 值的值。
UEP_FC_LENGTH_ERROR_CODE
包含在请求完成后返回的长度错误代码的 1 字节区域的地址。 可能的值包括：
  • UEP_FC_LENGTH_OK
  • UEP_FC_ BUFFER_LEN_TOO_SMALL
  • UEP_FC_RECORD_LEN_TOO_LARGE
  • UEP_FC_BUFFER_LEN_NOT_FILE_LEN
  • UEP_FC_RECORD_LEN_NOT_FILE_LEN
UEP_FC_DUPLICATE_KEY_CODE
1 字节区域的地址，指示请求是否找到所提供密钥的多个记录。 可能的值包括：
  • UEP_FC_DUPLICATE 键
  • UEP_FC_NOT_DUPLICATE 键
UEP_FC_ACCMETH_RETURN_CODE
返回响应 UEP_FC_REASON_ACCMETH_REQUEST_ERROR 或 UEP_FC_REASON_IO_ERROR 时返回与访问方法相关的信息的 4 字节区域的地址。
UEP_FC_RESPONSE
请求完成后包含响应的 1 字节区域的地址:
  • UEP_FC_RESPONSE_OK
  • UEP_FC_RESPONSE_EXCEPTION
  • UEP_FC_RESPONSE_灾难
  • UEP_FC_RESPONSE_INVALID
  • UEP_FC_RESPONSE_PURGED
UEP_FC_REASON
1 字节区域的地址，其中包含原因 (如果请求已完成但带有 EXCEPTION 响应)。 可能的原因是:
  • UEP_FC_REASON_ABEND
  • UEP_FC_REASON_ACCMETH_REQUEST_ERROR
  • UEP_FC_REASON_BDAM_DELETE
  • UEP_FC_REASON_BDAM_LENGTH_CHANGE
  • UEP_FC_REASON_BDAM_KEY_CONVERSION
  • UEP_FC_REASON_BDAM_READ_PREVIOUS
  • UEP_FC_REASON_BDAM_WRITE_MASS_INSERT
  • UEP_FC_REASON_BROWSE_UPD_NOT_RLS
  • UEP_FC_REASON_CACHE_FAILURE
  • UEP_FC_REASON_CFDT_CONNECT_ERROR
  • UEP_FC_REASON_CFDT_DISCONNECT_ERROR
  • UEP_FC_REASON_CFDT_INVALID_延续
  • UEP_FC_REASON_CFDT_POOL_FULL
  • UEP_FC_REASON_CFDT_REOPEN_ERROR
  • UEP_FC_REASON_CFDT_SERVER_NOT_AVAILABLE
  • UEP_FC_REASON_CFDT_SERVER_NOT_FOUND
  • UEP_FC_REASON_CFDT_SYSIDERR
  • UEP_FC_REASON_CFDT_TABLE_GONE
  • UEP_FC_REASON_CHANGED
  • UEP_FC_REASON_CR_NOT_RLS
  • UEP_FC_REASON_DATASET_BEING_COPIED
  • 已检测到UEP_FC_REASON_DEADLOCK_观
  • UEP_FC_REASON_DELETE_AFTER_READ_UPDATE
  • UEP_FC_REASON_DELETE_BEFORE_READ_UPDATE
  • UEP_FC_REASON_DISASTER_PERCOLATION
  • UEP_FC_REASON_DUPLICATE_READ_UPDATE
  • UEP_FC_REASON_DUPLICATE_RECORD
  • UEP_FC_REASON_DUPLICATE_REQID
  • UEP_FC_REASON_END_OF_FILE
  • UEP_FC_REASON_ESDS_DELETE
  • UEP_FC_REASON_FILE_DISABLED
  • UEP_FC_REASON_FILE_NOT_OPEN
  • UEP_FC_REASON_FILE_NOT_可恢复
  • 找不到 UEP_FC_REASON_FILE_NOT_FOUND
  • UEP_FC_REASON_FULL_KEY_不法长度
  • UEP_FC_REASON_GENERIC_DELETE_NOT_KSDS
  • UEP_FC_REASON_GENERIC_KEY_TOO_LONG
  • UEP_FC_REASON_ILLEGAL_KEY_TYPE_CHANGE
  • UEP_FC_REASON_INREASONENT_SPACE
  • UEP_FC_REASON_INVALID_UPDATE_TOKEN
  • UEP_FC_REASON_IO_ERROR
  • UEP_FC_REASON_ISCINVREQ
  • UEP_FC_REASON_ISC_NOT_SUPPORTED
  • UEP_FC_REASON_KEY_LENGTH_负数
  • UEP_FC_REASON_KEY_STOLEN
  • UEP_FC_REASON_KSDS_AND_XRBA
  • UEP_FC_REASON_LOADING
  • UEP_FC_REASON_LOCKED
  • UEP_FC_REASON_LOST_LOCKS
  • UEP_FC_REASON_LOCK_STRUCTURE_FULL
  • UEP_FC_REASON_NOT_IN_SUBSET
  • UEP_FC_REASON_NO_VARIABLE_LENGTH
  • UEP_FC_REASON_NOSUSPEND_NOT_RLS
  • UEP_FC_REASON_NOTAUTH
  • UEP_FC_REASON_NOT_EXTENDED
  • UEP_FC_REASON_PREVIOUS_RLS_FAILURE
  • UEP_FC_REASON_RBA_ACCESS_TO_RLS_KSDS
  • UEP_FC_REASON_READ_NOT_AUTHORIZED
  • UEP_FC_REASON_READPREV_IN_GENERIC_BROWSE
  • UEP_FC_REASON_RECLEN_EXCEEDS_LOGGER_BFSZ
  • UEP_FC_REASON_RECORD_BUSY
  • UEP_FC_REASON_RECORD_NOT_FOUND
  • UEP_FC_REASON_REMOTE_INVREQ
  • UEP_FC_REASON_RESTART_FAILED
  • UEP_FC_REASON_REWRITE_BEFORE_READ_UPDATE
  • UEP_FC_REASON_RIDFLD_KEY_NOT_RECORD_KEY
  • 已检测到UEP_FC_REASON_RLS_DEADLOCK_观
  • UEP_FC_REASON_RLS_DISABLED
  • UEP_FC_REASON_RLS_FAILURE
  • UEP_FC_REASON_RR_NOT_RLS
  • UEP_FC_REASON_SECURITY_FAILURE
  • 已检测到UEP_FC_REASON_SELF_DEADLOCK_观
  • UEP_FC_REASON_SERVREQ_违例
  • UEP_FC_REASON_SHIP
  • UEP_FC_REASON_SHIPPED_SECURITY_FAILURE
  • UEP_FC_REASON_STORE_FAIL
  • UEP_FC_REASON_消
  • UEP_FC_REASON_SYSIDERR
  • UEP_FC_REASON_TABLE_FULL
  • UEP_FC_REASON_TABLE_TOKEN_INVALID
  • UEP_FC_REASON_TIMEOUT
  • UEP_FC_REASON_TOO_MANY_CFDTS_IN_UOW
  • UEP_FC_REASON_UNKNOWN_REQID_ENDBR
  • UEP_FC_REASON_UNKNOWN_REQID_READNEXT
  • UEP_FC_REASON_UNKNOWN_REQID_READPREV
  • UEP_FC_REASON_UNKNOWN_REQID_RESETBR
  • UEP_FC_REASON_UPDATE_NOT_AUTHORIZED
UEP_FC_EXIT_TOKEN
从 XFCFRIN 传递的 4 字节令牌的地址。
返回码
UERCNORM
继续处理。
UERCPURG
在 XPI 调用期间清除了任务。
XPI 调用
都可以用。
API 和 SPI 调用
不能使用任何值。