Show subsystem configuration
Function
This statement can be used to output the contents of a subsystem configuration, which is stored in a subsystem catalog, to either the screen or a file, as required.
The output always contains the name of the subsystem catalog and information on whether and how the catalog is saved in the event of an error (this behavior is set in the statement SAVE-CATALOG ..., FORCED=...).
SHOW-CATALOG will be rejected if the specified file or subsystem name or the specified subsystem version does not exist. If the subsystem catalog is empty, a warning message will be issued and the statement aborted.
If the specified file name does not correspond to that of the catalog which is currently open, the following message is output:
SCM0011 DO YOU REALLY WANT TO OVERWRITE MEMORY CATALOG '(&00)'? REPLY (Y/N)
If the reply is Y, the virtual definitions in the current catalog will be lost.
If the reply is N, execution of the SHOW-CATALOG statement will be aborted. With the aid of SAVE-CATALOG, the user can store in a file all subsystem definitions not yet saved.
If the CHECK-CATALOG statement was not used to run a consistency check beforehand, SHOW-CATALOG may detect consistency errors in the subsystem catalog.
Format
SHOW-CATALOG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
CATALOG-NAME =
Specifies the name of the catalog which contains the definitions that are to be displayed. If this catalog file name does not exist or if the specified catalog is empty, the statement will be rejected.
CATALOG-NAME = *CURRENT
Default value: the contents of the catalog which is currently open (START-CATALOG-CREATION or START-CATALOG-MODIFICATION statement) are to be output.
CATALOG-NAME = <filename 1..54 without-gen-vers>
Fully qualified name of the static subsystem catalog whose contents are to be displayed.
CONTAINED-SUBSYSTEMS = *NO / *YES
Specifies whether to output the list of DSSM subsystems defined in the catalog (*YES) or not (*NO).
SUBSYSTEM-NAME =
Specifies the subsystems on which information is being requested.
If the name of the subsystem or a version on which information is requested does not exist, the statement will be rejected. The scope of the information to be output for the subsystems can be restricted by specifying appropriate criteria in the following operands.
SUBSYSTEM-NAME = *ALL
Default value: information is requested about all the subsystems which are listed in the catalog directory.
SUBSYSTEM-NAME = <structured-name 1..8>(...)
Name of the subsystem for which SSCM is to provide information from the catalog.
VERSION =
Specifies the version of the selected subsystem.
VERSION = *ALL
The information which is output should cover all versions of the subsystem stored in the catalog.
VERSION = <c-string 3..8> / <text 3..8>
Information from the catalog should only be provided for these versions of the selected subsystem.
GENERAL-ATTRIBUTES = *YES / *NO
Specifies whether the following general attributes of the named subsystems are to be read from the catalog (*YES) or not (*NO):
when is the subsystem to be started after system initialization?
(CREATION-TIME)in what mode is the subsystem to be loaded?
(SUBSYSTEM-LOAD-MODE)is the subsystem to be automatically unloaded at shutdown?
(STOP-AT-SHUTDOWN)may the subsystem be suspended or unloaded after it has been loaded?
(SUBSYSTEM-HOLD)may the commands for controlling a subsystem be used?
(STATE-CHANGE-CMDS)is the FORCE option permitted?
(FORCED-STATE-CHANGE)is the RESET option permitted?
(RESET)must the initialization routine be executed if the holder task is terminated abnormally?
(RESTART-REQUIRED)
may more than one version of the subsystem be active simultaneously?
(VERSION-COEXISTENCE)may two versions of a subsystem be dynamically exchanged?
(VERSION-EXCHANGE)What is the name of the installation unit of the subsystem?
(INSTALLATION-UNIT)What is the copyright (text and date) of the subsystem?
(COPYRIGHT)
INTERNAL-ENTRIES = *YES / *NO
Specifies whether SSCM is to provide the following information about the entry points to the specified subsystems (*YES) or not (*NO):
the names of the entry points for the subsystem routines INIT, STOPCOM, DEINIT and CLOSE-CTRL
the name of the entry point to be used for dynamic identity checking (DYNAMIC-CHECK-ENTRY)
the name of the interface version to be used in calling the INIT, STOPCOM, DEINIT or CLOSE-CTRL routine (INTERFACE-VERSION).
MEMORY-ATTRIBUTES = *YES / *NO
Specifies whether the following memory-related information on the subsystems, which is stored in the catalog, is to be output (*YES) or not (*NO):
memory class (MEMORY-CLASS)
size of required address space (SIZE)
start address of the subsystem code (START-ADDRESS)
privileges and access authorization for the address space (SUBSYSTEM-ACCESS)
RELATED-FILES = *YES / *NO
Specifies whether to supply information about the subsystem satellites (*YES) or not (*NO). This output includes information as to whether it is mandatory to use a REP file for this subsystem (REP-FILE-MANDATORY) and concerning the user ID under which the satellites are cataloged (INSTALLATION-USERID).
The term “subsystem satellites” covers:
the subsystem’s object module file (LIBRARY)
the message file (MESSAGE-FILE)
the syntax file (SYNTAX-FILE)
the subsystem’s information file (SUBSYSTEM-INFO-FILE)
the REP file (REP-FILE)
LINK-ATTRIBUTES = *YES / *NO
Specifies whether the information on the linkage and loading of the subsystem is to be read from the catalog (*YES) or not (*NO):
the name of the object module/ENTRY/CSECT required for loading (LINK-ENTRY)
the inclusion of the autolink function (AUTOLINK)
the information on system response when there are unresolved external references (UNRESOLVED)
the inclusion of a check run for referenced subsystems (CHECK-REFERENCE)
REFERENCE-RELATION = *YES / *NO
Specifies whether the list of subsystems to which address relations exist is to be included in the output of catalog information (*YES) or not (*NO).
DEPENDENCE-RELATION = *YES / *NO
Specifies whether the list of subsystems to which dependency relations exist is to be included in the output of catalog information (*YES) or not (*NO).
ADDR-SPACE-RELATION = *YES / *NO
Specifies whether the list of subsystems with which any address space overlap must be avoided is to be included in the output of catalog information (*YES) or not (*NO).
HOLDER-TASK-INFO = *YES / *NO
Specifies whether the identity of the holder task and the list of subsystems which are to be created within a common holder task is to be included in the output of catalog information (*YES) or not (*NO).
SUBSYSTEM-ENTRIES = *YES / *NO
Specifies whether the list of entry points declared in the definition of the subsystem and the following attributes of these entries are to be read from the catalog (*YES) or not (*NO):
type of the declared job entry point (MODE)
number of the routine (for an SVC or system exit) (NUMBER)
the function number of the entry point (FUNCTION-NUMBER)
the version of the function number (FUNCTION-VERSION)
information about calling via system exit routines (CALL-BY-SYSTEM-EXIT)
the privileges and access authorization for entry points
(CONNECTION-ACCESS and CONNECTION-SCOPE)
OUTPUT =
Specifies where the information generated by the statement is to be output.
OUTPUT = *SYSLST(...)
Default value: 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 should go to the standard 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 is given here.
SUMMARY = *YES / *NO
Specifies whether the requested output is to be preceded by a summary of all the subsystems listed in the catalog directory (*YES) or not (*NO).
For OUTPUT=*SYSLST(SUMMARY=*YES) see the overview of abbreviations below.
OUTPUT = *SYSOUT
The messages will be output to the data display terminal.
Overviews of the subsystems in the catalog (see operand OUTPUT=*SYSLST(SUMMARY=*YES)) make use of the following abbreviations:
for CREATION-TIME
ACR: *AT-CREATION-REQUEST
ASC: *AT-SUBSYSTEM-CALL
ADL: *AT-DSSM-LOAD
BDL: *BEFORE-DSSM-LOAD
MAS: *MANDATORY-AT-STARTUP
BSR: *BEFORE-SYSTEM-READY
ASR: *AFTER-SYSTEM-READY
for MEMORY-CLASS
S: *SYSTEM-GLOBAL
P: *LOCAL-PRIVILEGED
U: *LOCAL-UNPRIVILEGED
B: *BY-SLICE
for SUBSYSTEM-ACCESS
SYS: *SYSTEM
ALL:: *LOW / *HIGH
for INTERNAL-ENTRIES
DYN: *DYNAMIC
YES: name
NO: *NO
for CONNECTION-ACCESS
SYS: *SYSTEM
for STATE-CHANGE-CMDS
ADM: *BY-ADMINISTRATOR-ONLY
for REP-FILE
MAN: REP-FILE = *STD / filename and REP-FILE-MANDATORY = *YES
for GENERAL-ATTRIBUTES
YES: *ALLOWED
NO: *FORBIDDEN
für RELATED-FILES
YES: *STD / filename
NO: *NO
IMO: *INSTALLED