Conversion and key templates

In the COMMAREA, fields UNVDTMP and UNVDLNP point to the conversion template and its length.

Fields UNVKTMP and UNVKLNP point to the key template and its length. Figure 1 illustrates the use and meaning of these fields.

Figure 1. Parameter fields and the conversion templates
The picture shows the fields (in the DFHUCNV parameter list) that are described in the previous paragraph: UNVDTMPThe address of the start of the conversion templateUNVDLNPThe address of a half-word that contains the length of the conversion templateUNVKTMPThe address of the start of the key-conversion templateUNVKLNPThe address of a half-word that contains the length of the key-conversion template

Each type of template consists of field conversion records, one for each field in the data record or key. Each field conversion record has the same layout, shown under Field conversion records, and mapped by a supplied DSECT, DFHCNVDS (see DFHCNVDS, DSECT for field conversion records). Figure 2 shows the relationship between a template, field conversion records, and DFHCNVDS. The figure shows DFHCNVDS overlaying the first field conversion record in a template for a data record or key with six fields.

Figure 2. Field conversion records and a conversion or key template
The picture shows a conversion or key template consisting of six field conversion records. (The template is thus for a data record or key with six fields.) It shows the DFHCNVDS DSECT overlaying the first field conversion record in the template.


dfht80s.html | Timestamp icon Last updated: Sunday, 4 June 2017