PRINT-CATALOG

Displays information about cataloged DataBasic programs.

Syntax

PRINT-CATALOG {fileSpecifier} itemList {(options}

Syntax Elements

fileSpecifier The file containing the cataloged programs (see General Conventions). If omitted, itemList is assumed to refer to programs cataloged from the local account.

itemList A space-separated list containing the item-ids of the cataloged programs. These can be the item-ids of the MD entries, the executable items (in POINTER-FILE or the dictionary or data section of the file) or the deliverable items (see Introduction to DataBasic for descriptions of these different types of item). The list can be provided by a list-generating command that immediately-precedes BVERIFY.

If fileSpecifier has been included, an asterisk (*) can be used to specify all the items in the specified file.

Options

I Prompts for the account from which the programs were cataloged. Programs cataloged from the account specified will be listed instead of those from the local account.

P Sends output to the printer.

Operation

PRINT-CATALOG displays the following information:

Program The account, file name, data section name and program name.

Compiled on The compilation data and time.

Source The file name (including the data section, if appropriate) and item name of the source program.

Last updated The date on which the source item was last updated.

Comments

If you specify a program that has not been cataloged, an error message is normally displayed. However, if you specify a file name and the program executable cannot be found in that file, but there is an MD or POINTER-FILE item with the specified name, details of that program will be displayed.

Note: You can display similar information for a program that has not been cataloged by using the dictionary SYS.BASLIB (SYSFILES account) to list the program. See Viewing Program Headers for details.

Alternative Syntax

The following syntax can also be used:

PRINT-CATALOG program account

where program is the name of a single cataloged program with an executable in the global POINTER-FILE, and account is an account name.

Example

:PRINT-CATALOG BP PGM1

The following information is printed about the cataloged program PGM1 in file BP:

Program         : TAB BP,BP $PGM1
Compiled on     : 26 Apr 95 at 17:29
Source          : TAB-BP PGM1
Last updated    : 26 Apr 95