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