参数列表 (DFHUVNDS)
DFHUNVDS DSECT 映射传递到 COMMAREA 中的 DFHUCNV 的参数列表。
如果参数为零,那么没有可用的数据。 如果没有为资源创建转换模板,那么将调用 DFHUCNV ,但仅参数列表中的以下字段包含数据:
- UNVRSTP
- UNVRNMP
- UNVDIRP
- UNVOVLY
DFHUNVDS DSECT
UNVRSTP DS AL4 PTR-TO-RESOURCE TYPE
UNVRNMP DS AL4 PTR-TO-RESOURCE NAME
UNVDIRP DS AL4 PTR-TO-CONVERSION DIRECTIVE
CNVRQATE EQU X'02' REQUEST ASCII TO EBCDIC
CNVRPETA EQU X'04' RESPONSE EBCDIC TO ASCII
UNVDTMP DS AL4 PTR-TO-DATA CONV TEMPLATE
UNVDLNP DS AL4 PTR-TO-DATA TEMPLATE LENGTH
UNVKTMP DS AL4 PTR-TO-KEY CONV TEMPLATE
UNVKLNP DS AL4 PTR-TO-KEY TEMPLATE LENGTH
UNVATEP DS AL4 PTR-TO-ASCII/EBCDIC TRANS TABLE
UNVETAP DS AL4 PTR-TO-EBCDIC/ASCII TRANS TABLE
UNVATED DS AL4 PTR-TO-DBCS ASCII/EBCDIC T.TABLE
UNVETAD DS AL4 PTR-TO-DBCS EBCDIC/ASCII T.TABLE
UNVOVLY DS 0H OVERLAY SECTION
ORG UNVOVLY TS REQUEST OVERLAY
UNVTSDP DS AL4 PTR-TO-TS DATA
UNVTSLNP DS AL4 PTR-TO-TS DATA LENGTH
ORG UNVOVLY TD REQUEST OVERLAY
UNVTDDP DS AL4 PTR-TO-TD DATA
UNVTDLNP DS AL4 PTR-TO-TD DATA LENGTH
ORG UNVOVLY IC REQUEST OVERLAY
UNVICDP DS AL4 PTR-TO-IC DATA
UNVICLNP DS AL4 PTR-TO-IC DATA LENGTH
ORG UNVOVLY PC REQUEST OVERLAY
UNVPCDP DS AL4 PTR-TO-PC DATA
UNVPCLNP DS AL4 PTR-TO-PC DATA LENGTH
ORG UNVOVLY FC REQUEST OVERLAY
UNVFCDP DS AL4 PTR-TO-FC DATA
UNVFCLNP DS AL4 PTR-TO-FC DATA LENGTH
UNVFCKP DS AL4 PTR-TO-FC KEY
UNVFCKLP DS AL4 PTR-TO-FC KEY LENGTH
ORG ,
UNVMRTNE DS A PTR-TO-MBCS TRANSLATION ROUTINE
UNVCLIDP DS AL4 A "client" CCSID
* (for example, 00819)
UNVSRIDP DS AL4 A "server" CCSID
* (for example, 00285)
以下是参数的详细描述:
- UNVRSTP
- 指向指示此请求所引用的资源的单字节资源类型。 资源类型的含义在 DSECT DFHCNVDS 中定义。 资源类型为 FC , IC , TS , TD 和 PC。
- UNVRNMP
- 指向包含资源名称的 8 个字符的字段,必要时用空格填充。 这些可能是:
- 对于 FC 请求,这是一个八字节文件名
- 对于 TS 请求,这是一个 8 字节的 TS 队列名称
- 对于 TD 请求,这是一个四字节的 TD 队列名称
- 对于 IC 请求,这是一个四字节事务名称
- 对于 PC 请求,这是一个八字节程序名。
- UNVDIRP
- 指向一个单字节字段,该字段显示需要进行的转换:
- CNVRQATE (X'02 ') 指示需要 从客户机编码转换为服务器编码的请求。
- CNVRPETA (X'04 ') 指示需要 从服务器编码转换为客户机编码的响应。
- UNVDTMP
- 指向 CICS 找到的与此资源匹配的转换模板的开始。 如果 UNVDTMP 为零,那么找不到模板。
- UNVDLNP
- 指向给出转换模板长度的字段。 字段为:
- CICS® Transaction Server for z/OS® 的全字
- 所有其他平台的半字。
- UNVKTMP (仅文件控制请求)
- 指向 CICS 针对请求 或响应的关键部分找到的模板的开头。 如果 UNVKTMP 为零,那么表示没有密钥模板,或者记录由相对记录号或相对字节地址访问。
- UNVKLNP (仅文件控制请求)
- 指向提供密钥转换模板长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
- UNVATEP
- 指向用于将字符数据从客户机编码转换为服务器编码的 256 字节 SBCS 转换表。
- UNVETAP
- 指向用于将字符数据从服务器编码转换为客户机编码的 256 字节 SBCS 转换表。
- 已创建
- 指向用于将字符数据从客户机编码转换为服务器编码的 DBCS 转换表。
- UNVETAD
- 指向用于将字符数据从服务器编码转换为客户机编码的 DBCS 转换表。
覆盖部分取决于资源类型:
TS 请求:
- UNVTSDP
- 指向正在读取或写入的 TS 记录的开始。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
- UNVTSLNP
- 指向给出 TS 记录长度的字段。
TD 请求:
- UNVTDDP
- 指向正在读取或写入的 TD 记录的开始。
- UNVTDLNP
- 指向给出 TD 记录长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
IC 请求:
- UNVICDP
- 指向 IC START 请求的 "源" 区域。
- UNVICLNP
- 指向给出 "源" 区域长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
PC 请求:
- UNVPCDP
- 指向所提供的 COMMAREA 的开始。
- UNVPCLNP
- 指向给出 COMMAREA 长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
FC 请求:
- UNVFCDP
- 指向正在读取或写入的文件控制记录的开头。
- UNVFCLNP
- 指向给出文件控制记录长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
- UNVFCKP
- 指向正在读取或写入的文件控制记录的密钥开始。
- UNVFCKLP
- 指向给出键长度的字段。 字段为:
- CICS Transaction Server for z/OS 的全字
- 所有其他平台的半字。
- UNVMRTNE
- 指向必须用于与 MBCS 代码页之间的转换的转换例程。 相关客户机代码页为 954 , 964 和 970。例程期望寄存器 1 指向 DFHUNVM DSECT 定义的结构:
DFHUNVM DSECT UNVMTABP DS AL4 Set to value in UNVATED or UNVETAD UNVMINP DS AL4 Address of source data INVMINL DS FL4 Length of source data UNVMOUTP DS AL4 Address of target buffer UNVMOUTL DS FL4 Length of target buffer - UNVCLIDP
- 指向为 IBM定义的 CCSID (例如 00819) 提供对应于 "客户机" 代码页的全字字段。
- UNVSRIDP
- 指向提供 IBM定义的 CCSID (例如 00285) 对应于 "服务器" 代码页的全字字段。