参数列表 (DFHUVNDS)

DFHUNVDS DSECT 映射传递到 COMMAREA 中的 DFHUCNV 的参数列表。

如果参数为零,那么没有可用的数据。 如果没有为资源创建转换模板,那么将调用 DFHUCNV ,但仅参数列表中的以下字段包含数据:
  • UNVRSTP
  • UNVRNMP
  • UNVDIRP
  • UNVOVLY

图 1。 映射传递到 DFHUCNV 的参数列表的 DFHUNVDS-DSECT
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) 对应于 "服务器" 代码页的全字字段。