ETPND pragma

This pragma can be used to create a documentation area in each module (code and data CSECT) of the generated LLM. This area contains general information on the translation unit (e.g. the version number or creation date), but no data on the function of the module. If desired, a patch area can be reserved for corrections that may be required at a later stage.

Format:

---

#pragma ETPND { CODE | DATA }
              [,VER= version ]
              [,DATE= datum ]
              [,COMPNR= compnr ]
              [,PATCH= anzahl ]
              [,MODULLENGTH= länge ]CODE

---

CODE DATA	The ETPND area is created in the code or data module.
version	Module version as a decimal value in the range [0..999]. If this entry is omitted, 0 is assumed.
date	Date of creation, in the form yyyymmdd, yyyy-mm-dd or yymmdd. If the six-digit format is specified, the year must be between 1960 and 2059. The two missing digits for the year (19 or 20) are added as appropriate. The date must lie between 1.1.1905 and 1.1.2035. Overflows in months or days, if present, are converted to the canonical form. An entry of 19961335 (35.13.1996), for example, would thus correspond to 19970204 (4.2.1997). If no creation date is specified, the compiler uses the date of compilation.
compno	Component number as a decimal value in the range [0..99999999]. If this entry is omitted, 0 is assumed.
number	Size of the patch area in bytes. The value must not exceed 4294967295 (0xFFFFFFFF). If this entry is omitted, an area of 200 bytes is reserved in the code module, and no area (0) is reserved in the data module. If PATCH=0 is specified, no patch area is reserved in the code module either. The value may be specified as a decimal, octal or hexadecimal number.
length	Length of the module including that of the ETPND area (24+7 bytes due to alignment on a double-word boundary) in bytes; this operand can be used to terminate a module on a page boundary. The value must not exceed 4294967295 (0xFFFFFFFF). If the value specified for length is less than the actual length of the module; the operand will be ignored. The value may be specified as a decimal, octal or hexadecimal number.

Notes

• An ETPND pragma cannot be used to specify values for both MODULLENGTH and PATCH at the same time. If the ETPND pragma contains both entries, MODULLENTGH is ignored.

• Only one ETPND pragma may be specified per module (i.e. per code and data CSECT). If multiple ETPND pragmas are specified for the same module, only the last pragma specified is used.