Show contents of SSD object (subsystem definitions)
Function
This statement outputs the contents of an SSD object either to the screen or to another file. The definitions of one or more subsystems are stored in an SSD object.
Each of the subsystem definitions which is stored in the specified SSD object (ISAM file) will be output separately.
The name and version of the SSD object are always output, as is the name of the domain for the SSD object and information on whether PULS problem messages have been incorporated in the SSD object.
It should be borne in mind that SHOW-SSD does not output the complete contents of the SSD object, but only the subsystem definition statements entered since the last ADD-CATALOG-ENTRY statement.
Format
SHOW-SSD | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SSD-FILE-NAME =
Specifies the name of the SSD object (ISAM file) which contains the definitions that are to be displayed. If there is no ISAM file with this name or if the specified file is empty, the statement will be rejected.
SSD-FILE-NAME = *CURRENT
Default value: the contents of the SSD object which is currently open (START-SSD-CREATION statement) are to be output.
SSD-FILE-NAME = <filename 1..54 without-gen-vers>
Fully qualified name of the SSD object whose contents are to be displayed.
GENERAL-ATTRIBUTES = *YES / *NO
Specifies whether the following general attributes of the subsystems defined in the SSD object are to be displayed (*YES) or not (*NO):
when is the subsystem to be started after system initialization?
(CREATION-TIME)
in which load 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 subsystems contained in the file (*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 SSD object as part of the subsystem definition, is to be output (*YES) or not (*NO):
memory class (MEMORY-CLASS)
size of the 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 information about the subsystem satellites is to be supplied (*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 SSD object (*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 SSD file 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 SSD object 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 SSD file 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 are to be included in the output of SSD file 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 SSD object (*YES) or not (*NO):
type of the declared entry point (MODE)
number of the routine (for an SVC or system exit) (NUMBER)
function number of the entry point (FUNCTION-NUMBER)
version of the function number (FUNCTION-VERSION)
information about invocation 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 is to 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 must be given here.
OUTPUT = SYSOUT
The messages will be output to the data display terminal.