Show information on the subsystem attributes
| Component: | DSSM | 
| Functional area: | Subsystem management | 
| Domain: | SYSTEM-MANAGEMENT | 
| Privileges: | STD-PROCESSING | 
Function
The SHOW-SUBSYSTEM-ATTRIBUTES command informs the user of the attributes of subsystems.
The command supports structured output in S variables (see "Output in S variables").
Privileged Function
The subsystem administrator receives information on both not privileged and privileged subsystems.
Format
| SHOW-SUBSYSTEM-ATTRIBUTES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 
 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SUBSYSTEM-NAME= *ALL / <structured-name 1..8>
Specifies the subsystems on which information is requested.
SUBSYSTEM-NAME = *ALL
It is not possible to specify a version explicitly in the VERSION operand here. 
Information is to be issued for all subsystems in the catalog (depending on the privileges of the user).
SUBSYSTEM-NAME= <structured-name 1..8>
Name of the subsystem on which SSCM will provide information from the catalog.
VERSION = *ALL / <product-version mandatory-man-corr> / <product-version without-man-corr>
Specifies the version of the selected subsystem.
VERSION = *ALL
Default: all versions of the subsystem contained in the catalog are to be included in the information output.
VERSION = <product-version mandatory-man-corr> / <product-version without-man-corr>
It is not possible to specify a version with SUBSYSTEM-NAME=*ALL here.
Version of the subsystem or a version of the SDF-A operand value PRODUCT-VERSION. Format: “mm.n” or “mm.naso”, where
| mm = | main version (numeric) | 
| n = | revision version (numeric) | 
| aso = | update version (a= letter, release level; so=numeric, correction level) | 
INFORMATION = *MINIMUM / *ALL-ATTRIBUTES / *PARAMETERS(...)
Specifies the scope of the information output.
INFORMATION = *MINIMUM
Default.
Only the name, version and status of the subsystem are output.
INFORMATION = *ALL-ATTRIBUTES
All information on the subsystem is output.
INFORMATION = *PARAMETERS(...)Specifies which information is wanted.
GENERAL-ATTRIBUTES = *NO / *YES
Specifies whether the following general attributes of the subsystems named are to be read from the catalog (*YES) or not (*NO):
- When is the subsystem to be started after the system has been started? (CREATION-TIME) 
- In which load mode is the subsystem to be loaded? (SUBSYSTEM-LOAD-MODE) 
- Is the subsystem to be unloaded automatically at shutdown? (STOP-AT-SHUTDOWN) 
- May the loaded subsystem be stopped or unloaded? (SUBSYSTEM-HOLD) 
- May the subsystem control commands be used? (STATE-CHANGE-CMDS) 
- Is the FORCE option allowed? (FORCED-STATE-CHANGE) 
- Is the RESET option allowed? (RESET) 
- Does the subsystem have to be restarted when the holder task was terminated abnormally? 
 (RESTART-REQUIRED)
- May more than one version of the subsystem be active at the same time? 
 (VERSION-COEXISTENCE)
- May two versions of a subsystem be exchanged dynamically? (VERSION-EXCHANGE) 
- What is the name of the subsystem’s INSTALLATION-UNIT? (INSTALLATION-UNIT) 
- What is the subsystem’s copyright (text and date)? (COPYRIGHT) 
The following information is also output:
- Year from the copyright information 
- Status of the subsystem 
- Name of the monitoring job variable if this was specified when the subsystem was activated (MONJV operand in the START-SUBSYSTEM command). 
 
 
INTERNAL-ENTRIES = *NO / *YES
Specifies whether the following information on the entry points of the subsystem is to be supplied by SSCM (*YES) or not (*NO):
- the names of the entry points for the subsystem routines INIT-/STOPCOM-/DEINIT- and CLOSE-CRTL-ROUTINE 
- the name of the entry point used for dynamic identity checking (DYNAMIC-CHECK-ENTRY) 
- the name of the interface version for calling the INIT-/STOPCOM-/DEINIT-/CLOSE-CTRL routines (INTERFACE-VERSION) 
 
 
MEMORY-ATTRIBUTES = *NO / *YES
Specifies whether the following information pertaining to the storage contained in the catalog is to be output (*YES) or not (*NO):
Specifies whether the storage attributes of the subsystem are to be output. These are:
- memory class (MEMORY-CLASS) 
- size of the address area needed (SIZE) 
- start address of the subsystem code (START-ADDRESS) 
- privileges and access authorization for the address area (SUBSYSTEM-ACCESS) 
 
 
RELATED-FILES = *NO / *YES
Specifies whether information on the subsystem’s subcomponents are to be supplied (*YES) or not (*NO). The output comprises information on whether a REP file is mandatory for the subsystem (REP-FILE-MANDATORY) and under which user ID the subcomponents are cataloged (INSTALLATION-USERID).
The term subcomponent comprises:
- the subsystem’s object module file (LIBRARY) 
- the message file (MESSAGE-FILE) 
- the syntax file (SYNTAX-FILE) 
- the subsystem information file (SUBSYSTEM-INFO-FILE) 
- the REP file (REP-FILE) 
 
 
LINK-ATTRIBUTES = *NO / *YES
Specifies whether the information is to be read from the catalog (*YES) or not (*NO), which is stored there on linking and loading the subsystem:
- the name of the link module required /ENTRY/CSECT (LINK-ENTRY) 
- inclusion of the autolink function (AUTOLINK) 
- information on the behavior regarding unresolvable external references (UNRESOLVED) 
- inclusion of a check run for reference subsystems (CHECK-REFERENCE) 
REFERENCE-RELATION = *NO / *YES
Specifies whether the list of subsystems to which there are address references are to be included in the catalog information output (*YES) or not (*NO).
DEPENDENCE-RELATION = *NO / *YES
Specifies whether the list of subsystems to which there are dependencies are to be included in the catalog information output (*YES) or not (*NO).
HOLDER-TASK-INFO = *NO / *YES
Specifies whether the identification of the holder task and the list of subsystems contained in a common holder task are to be included in the catalog information output (*YES) or not (*NO).
SUBSYSTEM-ENTRIES = *NO / *YES
Specifies whether the list of job entries specified when the subsystem was defined and the attributes listed below are to be read from the catalog (*YES) or not (*NO):
- type of specified job entry (MODE) 
- routine number (for *SVC or *SYSTEM-EXIT) (NUMBER) 
- function number of the starting point (FUNCTION-NUMBER) 
- version of the function number (FUNCTION-VERSION) 
- information on calls by system exit routines (CALL-BY-SYSTEM-EXIT) 
- privileges and access authorizations regarding entry points (CONNECTION-ACCESS and CONNECTION-SCOPE) 
OUTPUT = *SYSOUT / *SYSLST(...) / *NONE
Specifies the system file into which the information is to be directed.
OUTPUT = *SYSOUT
Default. The information is output to SYSOUT.
OUTPUT = *SYSLST(...)
The information is output to SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
The number of the SYSLST file into which the information is to be output.
LINES-PER-PAGE = <integer 1..99>
The number of lines of a SYSLST page.
OUTPUT = *NONE
The information is not output to SYSOUT or SYSLST. The system merely generates S variables (see below). See section "Working with S variables" for details on S variables. 
Return codes
| (SC2) | SC1 | Maincode | Meaning | 
|---|---|---|---|
| 0 | CMD0001 | No error | |
| 1 | ESM0414 | Syntax error: invalid version | |
| 32 | CMD2009 | System error: when writing S variable range | |
| 32 | ESM0360 | System error: XVT or TCB not accessible | |
| 32 | ESM0602 | System error: problems with storage administration | |
| 32 | ESM0611 | System error: connection tables for this task do not exist | |
| 32 | ESM0671 | System error: while writing to SYSOUT | |
| 64 | ESM0600 | Operand error: no version with *ALL | |
| 64 | ESM0601 | Specified system not found | |
| 64 | ESM0608 | Subsystem version not found | |
| 64 | OPS0002 | Command canceled | |
| 144 | OPS0001 | Command cannot be executed due to lack of storage space: repeat  | 
Notes
- If the user only has the *STD-PROCESSING privilege, he receives the attributes of nonprivileged subsystems (i.e. subsystems for which SUBSYSTEM-ACCESS is not *SYSTEM). 
- If an error occurs while the information is being written to SYSOUT or SYSLST (ESM0671) the generation of the S variable continues normally. 
- If an error occurs while the S variable is being written (OPS0001 or CMD2009) writing the information to SYSOUT or SYSLST is continued normally. 
- If the cancel key [K2] is pressed when the input prompt is issued ('PLEASE ACKNOWLEDGE') both output to SYSOUT and to the S variable is canceled immediately. Return code OPS0002 is set. 
- It can only be guaranteed that the output to SYSOUT/SYSLST is fully identical if the procedure issuing the command prohibits the output being interrupted with INTERRUPTION-ALLOWED=*NO. 
Output in S variables
The information output in the S variables matches the output from SYSOUT and SYSLST (see the description of these operands above). The following table groups the S variables according to their assignment to the suboperands of INFORMATION=*PARAMETERS(...).
| Notation used in command | Abbreviated form used in table | 
|---|---|
| INFORMATION=*PARAMETERS(GENERAL-ATTRIBUTES=*NO/*YES) | GEN-ATT | 
| INFORMATION=*PARAMETERS(INTERNAL-ENTRIES=*NO/*YES) | INT-ENT | 
| INFORMATION=*PARAMETERS(MEMORY-ATTRIBUTES=*NO/*YES) | MEM-ATT | 
| INFORMATION=*PARAMETERS(RELATED-FILES=*NO/*YES) | REL-FIL | 
| INFORMATION=*PARAMETERS(LINK-ATTRIBUTES=*NO/*YES) | LINK-ATT | 
| INFORMATION=*PARAMETERS(REFERENCE-RELATION=*NO/*YES) | REF-REL | 
| INFORMATION=*PARAMETERS(DEPENDENCE-RELATION=*NO/*YES) | DEP-REL | 
| INFORMATION=*PARAMETERS(HOLDER-TASK-INFO=*NO/*YES) | HOL-TASK | 
| INFORMATION=*PARAMETERS(SUBSYSTEM-ENTRIES=*NO/*YES) | SUB-ENT | 
| Output information | Name of the S variable | T | Contents | Condition | 
|---|---|---|---|---|
| Integration of the Autolink function | var(*LIST).AUTOLINK | S | *ALLOW  | LINK-ENT | 
| Integration of the check run for reference subsystems | var(*LIST).CHECK-REF | S | *YES  | LINK-ENT | 
| Address of the name of the entry point for the subsystem routine CLOSE-CTRL-ROUTINE (if CRE) | var(*LIST).CLOSE-CTRL-ROUT.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the entry point for the subsystem routine CLOSE-CTRL-ROUTINE | var(*LIST).CLOSE-CTRL-ROUT.NAME | S | <text 1..8>  | INT-ENT | 
| Copyright (text and date) of the subsystem | var(*LIST).COPYRIGHT | S | <string 1..54>  | GEN-ATT | 
| Start time of the subsystem following system initialization | var(*LIST).CRE-TIME | S | *BEFORE-DSSM-LOAD  | GEN-ATT | 
| Name of the subsystem | var(*LIST).DATA(*LIST).SUBSYS-NAME | S | <structured-name 1..8> | |
| Version of the subsystem | var(*LIST).DATA(*LIST).SUBSYS-VERSION | S | <product-version> | |
| Address of the name of the entry point for the subsystem routine DEINIT (if CRE) | var(*LIST).DEINIT-ROUT.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the entry point for the subsystem routine DEINIT | var(*LIST).DEINIT-ROUT.NAME | S | <text 1..8>  | INT-ENT | 
| Address of the name of the entry point used for dynamic identity checks (if CRE) | var(*LIST).DYN-CHECK-ENTRY-NAME.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the entry point used for dynamic identity checks | var(*LIST).DYN-CHECK-ENTRY-NAME. | S | <text 1..8>  | INT-ENT | 
| Permission to use FORCE option | var(*LIST).FORCED-STATE-CHA | S | *ALLOW  | GEN-ATT | 
| Subsystem name in the shared holder task | var(*LIST).HOLDER-TASK.SHARED-WITH-SUBSYS(*LIST).SUBSYS-NAME | S | <structured-name 1..8>  | HOL-TASK | 
| Product version of the subsystem in the shared holder task | var(*LIST).HOLDER-TASK.SHARED-WITH-SUBSYS(*LIST).SUBSYS-VERSION | S | <product-version> | HOL-TASK | 
| TID of the holder task(if CREATED) | var(*LIST).HOLDER-TASK.TID | S | <text 8> | HOL-TASK | 
| TSN of the holder task | var(*LIST).HOLDER-TASK.TSN | S | <text 4> | HOL-TASK | 
| Address of the name of the entry point for the subsystem routine INIT (if CRE) | var(*LIST).INIT-ROUT.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the entry point for the subsystem routine INIT | var(*LIST).INIT-ROUT.NAME | S | <text 1..8>  | INT-ENT | 
| Name of the subsystem’s INSTALLATION-UNIT | var(*LIST).INSTALL-UNIT | S | <text 1..30>  | GEN-ATT | 
| User ID under which the related components are cataloged | var(*LIST).INSTALL-USERID | S | <name 1..8>  | REL-FIL | 
| Address of the name of the interface version used to call the routines INIT-/STOPCOM-/DEINIT-/CLOSE-CTRL (if CRE) | var(*LIST).INTERF-VERSION.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the interface version used to call the routines INIT-/STOPCOM-/DEINIT-/CLOSE-CTRL | var(*LIST).INTERF-VERSION.NAME | S | <text 1..8>  | INT-ENT | 
| Address of the name of the object module /ENTRY/CSECT required for loading (if CRE) | var(*LIST).LINK-ENTRY.ADDR | S | <text 1..8> | LINK-ENT | 
| Name of the object module /ENTRY/CSECT required for loading | var(*LIST).LINK-ENTRY.NAME | S | <text 1..8> | LINK-ENT | 
| Memory class | var(*LIST).MEM-CLASS | S | *SYS-GBL  | MEM-ATT | 
| Monitoring job variable | var(*LIST).MONJV | S | *YES  | GEN-ATT | 
| Default name of the message file (for *INSTALL) | var(*LIST).MSG-F.DEF-NAME | S | <filename 1..54>  | REL-FIL | 
| Logic ID of the message file(for *INSTALL) | var(*LIST).MSG-F.LOGIC-ID | S | <filename 1..30> | REL-FIL | 
| Name of the message file | var(*LIST).MSG-F.NAME | S | <filename 1..54>  | REL-FIL | 
| Criterion for automatic loading if CREATION-TIME=*AT-SUBS-CALL is set at start time: on the first call to an associated SVC, ISL or another interface | var(*LIST).ON-ACTION | S | *STD  | GEN-ATT | 
| Product version of the subsystem for which address references exist (*HIGH=highest product version) | var(*LIST).REF-SUBSYS(*LIST).HIGH-VERSION | S | <product-version>  | REF-REL | 
| Product version of the subsystem for which address references exist (*LOW=lowest product version) | var(*LIST).REF-SUBSYS(*LIST).LOW-VERSION | S | <product-version>  | REF-REL | 
| Name of the subsystem for which address references exist | var(*LIST).REF-SUBSYS(*LIST).SUBSYS-NAME | S | <structured-name 1..8> | REF-REL | 
| Product version of the subsystem for which dependence relations exist (*HIGH=highest product version) | var(*LIST).RELATED-SUBSYS(*LIST).HIGH-VERSION | S | <product-version>  | DEP-REL | 
| Product version of the subsystem for which dependence relations exist (*LOW=lowest product version) | var(*LIST).RELATED-SUBSYS(*LIST).LOW-VERSION | S | <product-version>  | DEP-REL | 
| Name of the subsystem for which dependence relations exist | var(*LIST).RELATED-SUBSYS(*LIST).SUBSYS-NAME | S | <structured-name 1..8> | DEP-REL | 
| Default name of the REP file(for *INSTALL) | var(*LIST).REP-F.DEF-NAME | S | <filename 1..54>  | REL-FIL | 
| Logic ID of the REP file(for *INSTALL) | var(*LIST).REP-F.LOGIC-ID | S | <filename 1..30> | REL-FIL | 
| Use of a REP file is mandatory for this subsystem | var(*LIST).REP-F.MANDATORY | S | *YES  | REL-FIL | 
| Name of the REP file | var(*LIST).REP-F.NAME | S | <filename 1..54>  | REL-FIL | 
| Permit RESET option | var(*LIST).RESET | S | *ALLOW  | GEN-ATT | 
| Repeat initialization routine on abnormal termination of the holder task | var(*LIST).RESTART-REQ | S | *YES  | GEN-ATT | 
| Size of the required address space (for *LOC-PRIVIL and *BY-SLICE) | var(*LIST).SIZE | I | <integer 1..32767> | MEM-ATT | 
| Start address of subsystem code (for *LOC-UNPRIVIL) | var(*LIST).START-ADDR | S | <text 1..8> | MEM-ATT | 
| Use of subsystem control commands | var(*LIST).STATE-CHA-CMDS | S | *ALLOW  | GEN-ATT | 
| Should the subsystem be automatically unloaded on shutdown? | var(*LIST).STOP-AT-SHUTDOWN | S | *YES  | GEN-ATT | 
| Address of the name of the entry point for the subsystem routine STOPCOM (if CRE) | var(*LIST).STOPCOM-ROUT.ADDR | S | <text 1..8> | INT-ENT | 
| Name of the entry point for the subsystem routine STOPCOM | var(*LIST).STOPCOM-ROUT.NAME | S | <text 1..8>  | INT-ENT | 
| Privileges and access authorizations relating to the address space (for *SYS-GBL and *LOC-UNPRIVIL) | var(*LIST).SUBSYS-ACCESS | S | *LOW  | MEM-ATT | 
| Addresses of the entry points(if CREATED) | var(*LIST).SUBSYS-ENTRIES(*LIST).ADDR | S | <text 1..8> | SUB-ENT | 
| Privileges relating to the entry points | var(*LIST).SUBSYS-ENTRIES(*LIST).CONN-ACCESS | S | *ALL  | SUB-ENT | 
| Access authorizations relating to the entry points | var(*LIST).SUBSYS-ENTRIES(*LIST).CONN-SCOPE | S | *TASK  | SUB-ENT | 
| Permit entry points on initial connection | var(*LIST).SUBSYS-ENTRIES(*LIST).FIRST-CONN | S | *ALLOW  | SUB-ENT | 
| Function number of entry point (for ISL or SVC) | var(*LIST).SUBSYS-ENTRIES(*LIST).FUNC-NUM | I | <integer 0..255> | SUB-ENT | 
| Version of the function number(for ISL or SVC) | var(*LIST).SUBSYS-ENTRIES(*LIST).FUNC-VERSION | I | <integer 1..255> | SUB-ENT | 
| Type of specified incoming job | var(*LIST).SUBSYS-ENTRIES(*LIST).MODE | S | *LINK  | SUB-ENT | 
| Name of entry point | var(*LIST).SUBSYS-ENTRIES(*LIST).NAME | S | <text 1..8> | SUB-ENT | 
| Stop or unload the loaded subsystem | var(*LIST).SUBSYS-HOLD | S | *ALLOW  | GEN-ATT | 
| Default name of the subsystem’s information file (for *INSTALL) | var(*LIST).SUBSYS-INFO-F.DEF-NAME | S | <filename 1..54>  | REL-FIL | 
| Logic ID of the subsystem’s information file (for *INSTALL) | var(*LIST).SUBSYS-INFO-F.LOGIC-ID | S | <filename 1..30> | REL-FIL | 
| Name of the subsystem’s information file | var(*LIST).SUBSYS-INFO-F.NAME | S | <filename 1..54>  | REL-FIL | 
| Internal status | var(*LIST).SUBSYS-INT-STA | S | INSTALLED  | GEN-ATT | 
| Default name of the subsystem’s object module file (for *INSTALL) | var(*LIST).SUBSYS-LIB.DEF-NAME | S | <filename 1..54> | REL-FIL | 
| Logic ID of the subsystem’s object module file (for *INSTALL) | var(*LIST).SUBSYS-LIB.LOGIC-ID | S | <filename 1..30> | REL-FIL | 
| Name of the subsystem’s object module file | var(*LIST).SUBSYS-LIB.NAME | S | <filename 1..54>  | REL-FIL | 
| Load mode in which the subsystem is loaded | var(*LIST).SUBSYS-LOAD-MODE | S | *STD  | GEN-ATT | 
| Status of the subsystem | var(*LIST).SUBSYS-STA | S | *NOT-CRE  | GEN-ATT | 
| Default name of the syntax file(for *INSTALL) | var(*LIST).SYNTAX-F.DEF-NAME | S | <filename 1..54>  | REL-FIL | 
| Logic ID of the syntax file(for *INSTALL) | var(*LIST).SYNTAX-F.LOGIC-ID | S | <filename 1..30> | REL-FIL | 
| Name of the syntax file | var(*LIST).SYNTAX-F.NAME | S | <filename 1..54>  | REL-FIL | 
| Information on behavior in the event of unresolved external references | var(*LIST).UNRESOLVED-EXTERNAL | S | *ALLOW  | LINK-ENT | 
| More than one version of the subsystem active simultaneously | var(*LIST).VERSION-COEXIST | S | *ALLOW  | GEN-ATT | 
| Dynamic exchange of two versions of the subsystem | var(*LIST).VERSION-EXCHA | S | *ALLOW  | GEN-ATT | 
| Year specification(if COPYRIGHT) | var(*LIST).YEAR | S | <string 4> | GEN-ATT | 
Example
Output of the attributes of nonprivileged subsystems (users with the privilege *STD-PROCESSING) )
/show-subsystem-attributes subsystem-name=*all
%******************************************************************** %* 4 * SUBSYSTEM NAME: FHS VERSION: 08.3 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 5 * SUBSYSTEM NAME: FHS-DM VERSION: 08.3 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 7 * SUBSYSTEM NAME: PLI1 VERSION: 04.2 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED . . . . %******************************************************************** %* 256 * SUBSYSTEM NAME: GET-TIME VERSION: 20.0 * %******************************************************************** % STATUS OF THE SUBSYSTEM : CONNECTABLE %******************************************************************** %* 257 * SUBSYSTEM NAME: GET-TIMX VERSION: 20.0 * %******************************************************************** % STATUS OF THE SUBSYSTEM : CONNECTABLE %******************************************************************** %* 267 * SUBSYSTEM NAME: LMSCONV VERSION: 03.5 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 277 * SUBSYSTEM NAME: PAMCONV VERSION: 12.1 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 287 * SUBSYSTEM NAME: SMPGEN-U VERSION: 20.0 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 294 * SUBSYSTEM NAME: TULAM VERSION: 20.0 * %******************************************************************** % STATUS OF THE SUBSYSTEM : NOT CREATED %******************************************************************** %* 297 * SUBSYSTEM NAME: CRTEBASY VERSION: 11.0 * %******************************************************************** % STATUS OF THE SUBSYSTEM : CONNECTABLE