Upgrade 4—Update description tables

The job defined in the UPDTDESC member in your.prefix.CNTL is required to update your xxxxDESC description tables. This job updates and also compares your xxxxDESC tables with the TBOLDESC table that was delivered in an earlier release. It ensures that any customizations that may have been made are reflected in the xxxxDESC tables for the current version.

This job must be run once for each xxxxDESC table including TBOLDESC, where xxxx is usually the application name, but can be any four characters.

As part of the job, the program TBCOMP compares your versions of the xxxxDESC tables with the originally released TBOLDESC. It will return a condition code — see Table 1.

Table 1. Upgrade condition codes

Condition code

Meaning

00

No changes to the xxxxDESC table — it is an unchanged copy of the originally released TBOLDESC.

08

This is normal and indicates that there are differences between the tables. These differences reflect the customizations at your site; they are then applied, via TBEXEC, to the newly created versions of the xxxxDESC tables.

16

Job stops with this condition code. Indicates that there were non-matching table definitions — these are listed in the TBCOMP output.

n

Any other condition code is an error — refer to the list of tableBASE return codes in the Appendix “tableBASE Messages” in the tableBASE Programming Guide.