Using the vars Tag

Use the <vars> tag to extract values of a specified type, size, and offset from a call parameter. You can then refer to the extracted values in the <rep> and <hc> tags using the %var_name notation.

The <arg> subtag characterizes the argument of interest. Attributes are:

• var specifies the variable name.
• param specifies the index of the parameter.
• type specifies the variable type.
• offset specifies the offset of the field in bytes.
• bitoffset specifies the offset of the field in bits.
• size specifies the size of the field in bytes.
• bitsize specifies the size of the field in bits.

Additional attributes for PL/I are:

• len specifies the size of a character or bit string field.
• mode specifies the binary or decimal mode for a numeric field.
• scale specifies the scale of a fixed-point numeric field.
• prec specifies the precision of a fixed-point or floating-point numeric field.
• varying specifies whether a bit string variable is encoded as a varying-length string in the structure (yes or no, the default).

Supported data types are described in the language-specific sections below.

CALL 'DBNTRY' USING DB-USER-ID
                    DB-XYZ-REQUEST-AREA
                    XYZ01-RECORD
                    DB-XYZ-ELEMENT-LIST.

If the second parameter contains a 3-character table name in bytes 6-8, the following definition extracts the name for use as the right end of a relationship:

<vars>
  <arg var='TableName'
       param='2'
       type='auto'
       offset='5'
       size='3'/>
</vars>
<rep>
  <rel>
    <target type='TABLE'
            name='%TableName'/>
    .
    .
    .
  </rel>
</rep>