CHECK-CATALOG

Check subsystem definition(s) for consistency

Function

This statement is used to carry out consistency checks on the definitions of subsystems held in a catalog.

CHECK-CATALOG will be rejected if the file name specified by the user does not exist, or if the subsystem catalog is empty.

If the specified file name does not correspond with that of the catalog which is currently open, the following message will be output:

SCM0011    DO YOU REALLY WANT TO OVERWRITE MEMORY CATALOG '(&00)'? REPLY (Y/N)

If the user replies with Y, the virtual definitions in the current catalog will be lost. If the reply is N, execution of the CHECK-CATALOG statement will be aborted, and the user can then use the SAVE-CATALOG statement to save to a file all subsystem definitions which have not yet been saved.

The catalog cannot be saved without first carrying out checks on any link and dependency relations.

Format

CHECK-CATALOG

CATALOG-NAME = *CURRENT / <filename 1..54 without-gen-vers>
,DEPENDENCE-RELATION = *YES / *NO
,LINK-RELATION = *YES / *NO
,RELATED-FILES = *NO / *YES
,OUTPUT = *SYSOUT / *SYSLST(...)
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>

Operands

CATALOG-NAME =
Specifies the name of the catalog which holds the definitions which are to be checked.

CATALOG-NAME = *CURRENT
Default value: the catalog which is currently open (START-CATALOG-CREATION or START-CATALOG-MODIFICATION statement) is to be checked.

CATALOG-NAME = <filename 1..54 without-gen-vers>
Fully qualified name of the static subsystem catalog whose contents are to be checked.

DEPENDENCE-RELATION = *YES / *NO
Specifies whether the checks on subsystem definitions are also to take into account dependency relations to other subsystems (*YES) or not (*NO). The catalog cannot be saved if *NO was specified in a prior CHECK-CATALOG statement.

LINK-RELATION = *YES / *NO
Specifies whether the checks on subsystem definitions are also to take into account address links to other subsystems (*YES, default value) or not (*NO). The catalog cannot be saved if *NO was specified in a prior CHECK-CATALOG statement.

RELATED-FILES = *NO / *YES
Specifies whether the existence of files which have dependency relations to these subsystems is to be checked (*YES) or not (*NO, default value).
If the names of dependent files were defined with the value *INSTALLED(...), the DEFAULT-NAME specified there will also be checked.

OUTPUT =
Specifies where to output the information generated by the statement, i.e. the results of the check run.

OUTPUT = *SYSOUT
Default value: the messages will be output to the terminal.

OUTPUT = *SYSLST(...)
The messages are to be output to SYSLST.

SYSLST-NUMBER =
Identifies the SYSLST file to which the output is to be directed.

SYSLST-NUMBER = *STD
Default value: output is to go to the default system file SYSLST.

SYSLST-NUMBER = <integer 1..99>
Output is to go to one of the system files from the set SYSLST01 to SYSLST99, the number of which must be specified here.