LISTCONFIG

LISTCONFIG reads a config-file and lists the subsystems in the file.

Command-line syntax:

listconfig config-file [version]

Version is a version number, a date or a label for the config-file. You can also specify LATEST to denote the most recently checked-in of each subsystem.

For each subsystem, LISTCONFIG lists:

The subsystem name
The label for the subsystem as deduced from the version specification in the config-file.
The version number for the version directory of the subsystem. Blank if there is no label.
The date for this version of the version directory. Current if LATEST was specified for the subsystem.
The path to the version directory for the subsystem.

If the path to a subsystem is incorrect, LISTCONFIG leaves the columns for the label and the version-numberblank, and lists MISSING! in the date column.

If there are other problems with the directory, for instance there is no label to be found, but there should be (which it should do, except when the version specification for the subsystem is LATEST, or you specified LATEST on the command line), LISTCONFIG puts question marks in the label and version-number column and Dubious in the date column. In this case, there is also a warning message indicating the problem before the subsystem listing.

You use LISTCONFIG to find out which version of each subsystem that other AbaPerls tools such as DBBUILD or DBUPDGEN would process. config-file corresponds to the ‑config switch for these tools and version corresponds to the ‑label switch. In difference to the other tools, LISTCONFIG does not terminate execution if a subsystem is missing or does not have a label.

LISTCONFIG does not report the configuration options in the file. However, LISTCONFIG does perform a full parse of the file, and if there are any errors in the specification of configuration options. LISTCONFIG prints these and terminates the execution.

If you do not provide config-file, but there is a SUBSYSTEMS.LIS in the current directory, LISTCONFIG will report the contents of this file.