MAP

MAP

Top  Previous  Next

 

The MAP command produces a map of the system catalogue.

 

 

Format

 

MAP {mode} {ALL} {LPTR {n}} {FILE {file.name}} {DETAIL} {NO.PAGE}

 

where

 

modeis one of GLOBAL, PRIVATE or LOCAL to indicate which catalogue is to be mapped. If no mode is specified, the report shows the content of the private and global catalogues.

 

ALLindicates that system entries are to be included in the map.

 

LPTRspecifies that the output is to be sent to a print unit. The print unit number, n, defaults to 0 if omitted.

 

FILEspecifies that the output is to be sent to a file. If file.name is omitted, the $MAP file is used by default.

 

DETAILshows the source pathname, if available, for each reported program.

 

NO.PAGEsuppresses pagination of reports sent to the terminal.

 

 

The MAP command produces a combined list of the contents of the global and private catalogues. Without the FILE keyword, the map shows the name of each catalogued item with its date and time of compilation and its size, separating the object code and cross-reference tables. Items from the global catalogue have an asterisk in the leftmost column of the report. The report ends with a line giving the total size of all reported items.

 

The file produced with the FILE keyword can be listed using the query processor.

 

The private catalogue is normally a subdirectory, cat, under the account directory but can be moved by creating an X-type VOC entry named $PRIVATE.CATALOGUE in which field 2 contains the pathname of the alternative private catalogue directory. This only takes effect when QM is re-entered or on use of the LOGTO command. This feature is particularly useful where two or more accounts are to share a common private catalogue. The US spelling, $PRIVATE.CATALOG, may be used instead. If both are present, the British spelling takes priority.

 

See FIND.PROGRAM for another method of locating the source version of a catalogued program.

 

 

Example

 

MAP ALL LPTR

 

The above command prints a map of the catalogue, including system items.

 

 

See also:

BASIC, CATALOGUE, DELETE.CATALOGUE, FIND.PROGRAM