Show information on current system
Component: | BS2000 |
Functional area: | System control and optimization |
Domain: | SYSTEM-TUNING |
Privileges: | all privileges |
Routing code: | @ |
Function
The SHOW-SYSTEM-INFORMATION command allows the user to obtain information about data relating to the system currently running.
If a live migration has taken place, the live migration counter displays a value > 0. The SERVER-UNIT operand controls whether the information on the current system or on the IPL system is output.
The user can request all system information or individual parts of that information. This information can be output to SYSOUT or SYSLST.
The following items of system information can be requested:
machine designation (type and model details)
Information about whether and to where live migration took place
identification of the available CPUs
information about the hardware/software interface (HSI)
size of the usable physical main memory
smallest size of main memory which can be used for software
identification of the operating system running
identification of the BS2000 input/output configuration
time of system initialization for the current session
information about the current system configuration (Sysid, home pubset, host name, possibly the VM identification under VM2000, system name and origin of the system parameters upon system initialization)
in VM2000 mode, the VM2000 version
in VM2000 mode, information about the Monitor System (BS2000 version and host name)
information about the system time setting (time zone, changeover time, synchronization and TODR epoch)
The command supports structured output in S variables (see "Output in S variable").
Restrictions
If the command is issued from a console, only OUTPUT=*SYSOUT is allowed.
Format
SHOW-SYSTEM-INFORMATION |
INFORMATION = *ALL / *CONFIGURATION / *CPU-ID-LIST / *HSI-ATTRIBUTES / *MEMORY-SIZE / *MINIMAL-MEMORY-SIZE / *BS2000-IDENTIFICATION / *IOCONF-IDENTIFICATION / *IPL-TIME / *SYSTEM-CONFIGURATION / *VM2000-VERSION / *VM2000-MONITOR-SYSTEM / *SYSTEM-TIME-PARAMETER ,OUTPUT = *SYSOUT / *SYSLST ,SERVER-UNIT = *STD / *INITIAL / *CURRENT |
Operands
INFORMATION =
Specifies which system information is to be output.
INFORMATION = *ALL
All the information described in the following is to be output.
INFORMATION = *CONFIGURATION
Provides information about the machine designation as follows:
CONFIGURATION = <id-of-actual-machine>
After live migration the original system name is output.
Meaning of the output values of <id-of-actual-machine>:
Machine type (model range) in the new extended format (21 bytes), e.g. for an SU710 system:
'390SU- 710-160 '
If the machine type is not entered into the system, '7.500-7000' followed by 11 blanks is output. The machine designation is subdivided into the four following sections:
Section | Byte | Meaning |
|---|---|---|
1 | 0-4 | Base type (e.g. 390SU, X86SU, 7.500) |
2 | 6-10 | Model range |
3 | 12-15 | Model identifier |
4 | 17-20 | Special model features (e.g. vector processor) |
Bytes 5, 11 and 16 act as section separators and always contain the character ‘-’ (hyphen). If no information is available for section 4, bytes 16-20 contain blanks.
INFORMATION = *CPU-ID-LIST
Provides information about identifications of the CPUs available at startup as follows:
CPU-ID-LIST : ADR 0 = <cpu-id_0>
.
.
ADR n = <cpu-id_n>
Meaning of the output values:
<cpu-id_i> | Identification of the i-th CPU. The information output is the internal form (8 bytes) as supplied by the hardware, in printable form (i.e. 16 characters). As many identifications are output as there exist CPUs. However, the output does not indicate how many CPUs are actually online. |
INFORMATION = *HSI-ATTRIBUTES
Provides information about the hardware/software interface (HSI) as follows:
HSI-ATT : TYPE = IX / KM / UD
ASF = NO / YES
OPERATION-MODE = NATIVE / VM2000
Meaning of the output values:
TYPE | Information about the HSI type: | |
=IX: | The HSI type for /390 architecture (SU /390). | |
=KM | The HSI type for x86 architecture (SU x86). | |
=UD: | The HSI type is not defined. | |
ASF | Information about address space extension: | |
=NO: | No extended address space is available. | |
=YES: | The operating system is running on a machine whose virtual address space is capable of extension (advanced address space facility). Optional access to program space and two or more data spaces is thus possible. An additional set of registers (access registers) is available for this purpose. | |
OPERATION-MODE: | ||
Information about the use of VM2000: | ||
=NATIVE: | The operating system is running on a real machine. | |
=VM2000: | The operating system is running on a virtual machine in VM2000 operation mode. | |
INFORMATION = *MEMORY-SIZE
Provides information about the size of the usable physical main memory as follows:
MEMORY-SIZE = <memory-size> <unit>
Meaning of the output values:
<memory-size> | Size of main memory as a decimal number. Leading zeros are truncated. The output is left-justified. Value range: 1 <= |
<unit> | unit type (KByte / MByte / GByte) |
INFORMATION = *MINIMAL-MEMORY-SIZE
Returns information on the smallest size of main memory which can be used for software in the form:
MINIMAL-MEMORY-SIZE = <min-memory-size> <unit>
Meaning of the output values:
<min-memory-size> | Smallest size of main memory which can be used for software in nbytes; a decimal number. Leading zeros are truncated. The output is left-justified. Value range: 1 <= |
<unit> | unit type (KByte / MByte / GByte) |
INFORMATION = *BS2000-IDENTIFICATION
Provides information about the identification of the operating system running as follows:
BS2000-ID : NAME = <bs2-name>
VERSION = <bs2-version>
SERVICE-PACK = <sp-name>
UGEN-TIME = <bs2-gen-date>,<bs2-gen-time>
Meaning of the output values:
<bs2-name> | Program name (8 bytes, left-justified), e.g. ‘BS2V210'’ |
<bs2-version> | Version in DOD format, e.g. 'V21.0A00pp'; |
<sp-name> | Service pack name in format 'SP yy.n' (yy = release year, n = sequence number) |
<bs2-gen-date> | Date of generation of the operating system in ISO4 format: yyyymm-dd |
<bs2-gen-time> | Time of generation of the operating system in ISO4 format: hh:mm:ss |
INFORMATION = *IOCONF-IDENTIFICATION
Provides information about the identification of the BS2000 input/output configuration as follows:
IOCONF-ID : NAME = <iocf-name>
VERSION = <iocf-version>
CREATED = <iocf-gen-date>,<iocf-gen-time>
FORMAT = <iocf-format>
Meaning of the output values:
<iocf-name> | IOCF name (8 bytes, left-justified, blanks are output) e.g. ‘BS2V210’ The first 8 bytes of the ID block (NAME operand of IOGEN generation) of the current IOCF are output. |
<iocf-version> | Input of the version from the current IOCF (10 bytes, left-justified, blanks are output), e.g. 'V21.0A00' |
<iocf-gen-time> | Time of generation of the I/O configuration in ISO4 format: hh:mm:ss In the case of Server Units x86, only blanks are output. |
<iocf-format> | IOCF format (7 bytes, for diagnostic purposes only) |
INFORMATION = *IPL-TIME
Provides information about the time of system initialization for the current session as follows:
IPL-TIME = <ipl-date>,<ipl-time>
Meaning of the output values:
<ipl-date> | Date of startup of the current session in ISO4 format: yyyy-mm-dd |
<ipl-time> | Time of startup of the current session in ISO4 format: hh:mm:ss |
INFORMATION = *SYSTEM-CONFIGURATION
Provides information about the configuration of the BS2000 system in the form:
SYSTEM-CONF: SYSID = <sysid>
HOME-PUBSET = <cat-id>
HOST-NAME = <host-name>
VM-INDEX = <vm-index>
VM-NAME = <vm-name>
SYSTEM-NAME = <sys-name>
SYSPAR-BS2-SEL = *STD / *BY-VM-NAME / *BY-IOCONF-ID-NAME /
*BY-SYSTEM-NAME / *BY-DIALOG
LIVE-MIG-COUNT = <lm-counter>
Meaning of the output values:
<sysid> | System ID (3 characters) |
<cat-id> | Catalog ID of the home pubset in the format <cat-id 1..4> |
<host-name> | BCAM name of the local system (8 characters), e.g. ‘D027ZE01' |
<vm-index> | In VM2000 mode, the VM index in the format <integer 1..99>; in native mode the value 0 (for the operating modes, see OPERATION-MODE) |
<vm-name> | In VM2000 mode, the VM name in the format <name 1..8>; in native mode *NONE (for the operating modes, see OPERATION-MODE) |
<sys-name> | System name in the format <name 1..8> if available, otherwise *NONE |
SYSPAR-BS2-SEL | The value displayed in this field provides information on the origin of the system parameters at system startup (for automatic selection of the parameter file, see also the “Introduction to System Administration” [14] manual). |
*STD | From the parameter file SYSPAR.BS2.vvv |
*BY-SYSTEM-NAME | From the parameter file SYSPAR.BS2.vvv.<sys-name> |
*BY-VM-NAME | From the parameter file SYSPAR.BS2.vvv.<vm-name> |
*BY-IOCONF-ID-NAME | From the parameter file SYSPAR.BS2.vvv.<iocf-name> vvv corresponds to the BS2000 version without a period (see *STD); |
*BY-DIALOG | The system parameters were entered fully or partially via the parameter files specified in the dialog or directly on the console. |
<lm-counter> | Number of live migrations which have taken place |
INFORMATION = *VM2000-VERSION
In VM2000 mode (see OPERATION-MODE) provides information about the VM2000 version:
VM2000-VERSION = <vm2000-version>
Meaning of the output values:
<vm2000-version> | Version specification in DOD format, e.g. 'V12.0A' |
INFORMATION = *VM2000-MONITOR-SYSTEM
In VM2000 mode (see OPERATION-MODE) provides information about the Monitor System:
VM2000-MONITOR- BS2000-VERSION = <bs2-version> SYSTEM: HOST-NAME = <host-name>
<bs2-version> | Version specification in DOD format, e.g. 'V21.0A0000' |
<host-name> | BCAM name of the Monitor System e.g. 'D027ZE01' |
INFORMATION = *SYSTEM-TIME-PARAMETER
Provides information about the BS2000 system time settings in the form:
SYSTEM-TIME- ZONE = <zone-time-diff>
PARAMETER: SEASON = <actual-season>
SEASON-DIFFERENCE = <season-time-diff>
PREV-CHANGE-DATE = <prev-change-date>,<prev-change-time>
NEXT-CHANGE-DATE = <next-change-date>,<next-change-time>
SYNCHRONISATION = <synch-value>
EPOCH = <epoch-value>
Meaning of the output values:
<zone-time-diff> | Time difference between the local time zone and UTC time in the format: +hh:mm or -hh:mm |
<actual-season> | Current season in the local time zone; possible values: |
<season-time-diff> | Time difference in the local time zone between summer time and normal time in the format: hh:mm |
<prev-change-date> | Date of the last time changeover in ISO4 format: yyyy-mm-dd |
<prev-change-time> | Time of the last time changeover in ISO4 format: hh:mm:ss |
<next-change-date> | Date of the next time changeover in ISO4 format: yyyy-mm-dd |
<next-change-time> | Time of the next time changeover in ISO4 format: hh:mm:ss |
<synch-value> | Source of external time synchronization. The table below shows the possible values for the various server types in ascending order of priority of the synchronization types. If more than one timer exists, the highest-priority synchronization is shown. |
<epoch-value> | TODR epoch |
<synch-value> | SU /390 (or S server) | SU x86 |
|---|---|---|
*NONE | Loading errors: | Loading errors: |
X2000 | has been omitted | Without external synchronization (default) |
SKP-X | Without external synchronization (default) | has been omitted |
DCE/NTP | Synchronization by NTP network (in BS2000) | Synchronization by NTP network (in BS2000) |
XCS | Synchronization by XCS network | Synchronization by XCS network |
SERVER-CONN-EXT-REF | External timer connected via MU or (for VM2000 guest systems) connected in the monitor system | External timer connected via MU or (for VM2000 guest systems) connected in the monitor system |
BS2-CONN-EXT-REF | External timer connected via NTP (BS2000) | External timer connected via NTP (BS2000) |
OUTPUT = *SYSOUT / *SYSLST
Specifies whether output is to be to SYSOUT (default) or SYSLST. Output to SYSLST is not possible on the console.
SERVER-UNIT = *STD / *INITIAL / *CURRENT
Specifies the Server Unit whose data is to be displayed. The setting is only relevant when a live migration has taken place and the value requested using the INFORMATION operand can change as a result of migration.
SERVER-UNIT = *STD
The currently valid setting from the MIGHOST system parameter should be used.
The system parameter MIGHOST can be modified dynamically with the MODIFY-SYSTEM-PARAMETERS command.
When a live migration has taken place and the value *ALL, *CONFIGURATION, *CPU-ID-LIST, *IOCONF-IDENTIFICATION, *SYSTEM-CONFIGURATION, *VM2000-VERSION or *VM2000-MONITOR-SYSTEM is specified for INFORMATION, message NSI6231 or NSI6232 shows what the output will look like before the data is output.
SERVER-UNIT = *INITIAL
The data of the Server Unit on which IPL was performed (IPL system) is displayed.
SERVER-UNIT = *CURRENT
The data of the Server Unit on which the BS2000 session is currently running is displayed (possibly after a live migration).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
1 | 0 | CMD0001 | Command output interrupted |
2 | 0 | NBR1099 | Output to SYSLST not allowed |
32 | CMD2009 | Internal error during S variable generation | |
64 | OPS0002 | Command interrupted during generation of S variables | |
130 | OPS0001 | Not enough memory to generate S variables |
Output in S variable
The INFORMATION operand identifies the S variables which are to be created. All variables are output with INFORMATION=*ALL.
Notation used in command | Abbreviated form used in table |
|---|---|
INFORMATION = *CONFIGURATION | 1 |
INFORMATION = *CPU-ID-LIST | 2 |
INFORMATION = *HSI-ATTRIBUTES | 3 |
INFORMATION = *MEMORY-SIZE | 4 |
INFORMATION = *MINIMAL-MEMORY-SIZE | 5 |
INFORMATION = *BS2000-IDENTIFICATION | 6 |
INFORMATION = *IOCONF-IDENTIFICATION | 7 |
INFORMATION = *IPL-TIME | 8 |
INFORMATION = *SYSTEM-CONFIGURATION | 9 |
INFORMATION = *VM2000-VERSION | 10 |
INFORMATION = *VM2000-MONITOR-SYSTEM | 11 |
INFORMATION = *SYSTEM-TIME-PARAMETER | 12 |
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
BS2000 program name | var(*LIST).BS2000-ID.NAME | S | <c-string 8..8> | 6 |
Version specification (OSD-BC) for BS2000 | var(*LIST).BS2000-ID.OSD-BC-VERSION | S | <c-string 10..10> | 6 |
| Service pack name | var(*LIST).BS2000-ID.SERVICE-PACK | S | <c-string 7..7> | 6 |
BS2000 generation date | var(*LIST).BS2000-ID.UGEN-DATE | S | <yyyy-mm-dd> | 6 |
BS2000 generation time | var(*LIST).BS2000-ID.UGEN-TIME | S | <hh:mm:ss> | 6 |
Version specification for BS2000 | var(*LIST).BS2000-ID.VERSION | S | <c-string 10..10> | 6 |
Machine designation | var(*LIST).CONF | S | <c-string 21..21> | 1 |
CPU identifier | var(*LIST).CPU-ID(*LIST) | S | <c-string 16..16> | 2 |
Address space extension supported | var(*LIST).HSI-ATTR.ASF | T | FALSE | 3 |
Operating mode of the operating system | var(*LIST).HSI-ATTR.OPERATION-MODE | S | NATIVE | 3 |
CPU type | var(*LIST).HSI-ATTR.TYPE | S | IX | 3 |
IOCF format (only for debugging) | var(*LIST).IOCONF-ID.FORMAT | S | <c-string 7..7> | 7 |
First 8 bytes of the current IOCF's ID block; | var(*LIST).IOCONF-ID.NAME | S | <c-string 8..8> | 7 |
Generation date of the BS2000 I/O configuration or blanks in the case of SU x86 | var(*LIST).IOCONF-ID.UGEN-DATE | S | <yyyy-mm-dd> | 7 |
Generation time of the BS2000 I/O configuration or blanks in the case of SU x86 | var(*LIST).IOCONF-ID.UGEN-TIME | S | <hh:mm:ss> | 7 |
Version specification of the BS2000 I/O configuration or blanks in the case of SU x86 | var(*LIST).IOCONF-ID.VERSION | S | <c-string 10..10> | 7 |
Startup date | var(*LIST).IPL.DATE | S | <yyyy-mm-dd> | 8 |
Startup time | var(*LIST).IPL.TIME | S | <hh:mm:ss> | 8 |
Unit of measurement for the main memory size | var(*LIST).MEM-SIZE.DIM | S | GB | 4 |
Size of main memory | var(*LIST).MEM-SIZE.VAL | I | <integer 1..2147483647> | 4 |
Smallest unit of size of the main memory which is usable for software | var(*LIST).MIN-MEM-SIZE.DIM | S | GB | 5 |
Smallest size of main memory usable for software | var(*LIST).MIN-MEM-SIZE.VAL | I | <integer 1..2147483647> | 5 |
catalog ID of the home pubset | var(*LIST).SYS-CONF.HOME-PUBSET | S | <cat-id 4..4> | 9 |
Host name | var(*LIST).SYS-CONF.HOST-NAME | S | <c-string 8..8> | 9 |
Number of live migrations which have taken place | var(*LIST).SYS-CONF.LIVE-MIG-COUNT | I | <integer 0..99999999> | 9 |
System ID | var(*LIST).SYS-CONF.SYSID | S | <c-string 3..3> | 9 |
System name; if not available, the value *NONE | var(*LIST).SYS-CONF.SYS-NAME | S | <c-string 8..8> | 9 |
Origin of the system parameters | var(*LIST).SYS-CONF.SYSPAR-BS2-SEL | S | *STD | 9 |
VM index (in VM2000 mode, otherwise 0) | var(*LIST).SYS-CONF.VM-INDEX | I | <integer 0..99> | 9 |
VM name (in VM2000 mode, otherwise *NONE) | var(*LIST).SYS-CONF.VM-NAME | S | <c-string 1..8> | 9 |
Epoch | var(*LIST).SYS-TIME.EPOCH | S | 00..FF | 12 |
Source of external time synchronization; for meaning of values see table "Time synchronization displays" | var(*LIST).SYS-TIME.EXTERNAL-SYNCH | S | <c-string 20..20> with one of the following values and filled with blanks: | 12 |
Date of the next time change | var(*LIST).SYS-TIME.NEXT-CHA-DATE | S | <yyyy-mm-dd> | 12 |
Time of the next time change | var(*LIST).SYS-TIME.NEXT-CHA-TIME | S | <hh:mm:ss> | 12 |
Date of the most recent time change | var(*LIST).SYS-TIME.PREVIOUS-CHA-DATE | S | <yyyy-mm-dd> | 12 |
Time of the most recent time change | var(*LIST).SYS-TIME.PREVIOUS-CHA-TIME | S | <hh:mm:ss> | 12 |
Current season in the local time zone; possible values: | var(*LIST).SYS-TIME.SEASON | S | W | 12 |
Difference between summer and normal time | var(*LIST).SYS-TIME.SEASON-DIFFERENCE | S | <hh:mm> | 12 |
Time zone of the local system (difference from UTC time) | var(*LIST).SYS-TIME.ZONE | S | +<hh:mm> | 12 |
VM2000 version for VM2000 operation, otherwise *NONE | var(*LIST).VM2000-VERSION | S | <c-string 6..6> | 10 |
| BS2000 version of the monitor system (for VM2000 operation), otherwise *NONE | var(*LIST).VM-MONITOR.BS2000-VERSION | S | <c-string 10..10> *NONE | 11 |
Host name of the monitor system (for VM2000 operation), otherwise *NONE | var(*LIST).VM-MONITOR.HOST-NAME | S | <c-string 8..8> | 11 |
BS2000 OSD/BC version of the monitor system (for VM2000 operation), otherwise *NONE | var(*LIST).VM-MONITOR.OSD-BC-VERSION | S | <c-string 10..10> | 11 |
For reasons of compatibility the S variable var(*LIST).CURRENT-CONF is generated when INFORMATION=*ALL and SERVER-UNIT=*STD.
Example
Output on the VM on an SU x86 of an SE server
/SHOW-SYS-INF %CONFIGURATION = X86SU- 300B-160F %CPU-ID-LIST : ADR 0 = 78C0896080340000 % ADR 1 = 78C0896180340000 % ADR 2 = 78C0896280340000 % ADR 3 = 78C0896380340000 % ADR 4 = 78C0896480340000 % ADR 5 = 78C0896580340000 %HSI-ATT : TYPE = KM % ASF = YES % OPERATION-MODE = VM2000 %MEMORY-SIZE = 4600 MB %MINIMAL-MEMORY-SIZE = 504 MB %BS2000-ID : NAME = P10BSK % VERSION = V21.0A00P1 % SERVICE-PACK = SP 20.0 % CREATED = 2020-08-13,13:15:14 %IOCONF-ID : NAME = *NONE % VERSION = % CREATED = % FORMAT = *NONE %IPL-TIME = 2020-09-22,08:20:36 %SYSTEM-CONF : SYSID = 181 % HOME-PUBSET = 4V07 % HOST-NAME = C3POVM02 % VM-INDEX = 2 % VM-NAME = C3POVM02 % SYSTEM-NAME = C3POVM02 % SYSPAR-BS2-SEL = *BY-VM-NAME % LIVE-MIG-COUNT = 0 %VM2000-VERSION = V11.5A %VM2000-MONITOR- BS2000-VERSION = V20.0A0000 % SYSTEM: HOST-NAME = C3POVM01 %SYSTEM-TIME- ZONE = +01:00 % PARAMETER: SEASON = S % SEASON-DIFFERENCE = 01:00 % PREV-CHANGE-DATE = 2020-03-29,02:00:00 % NEXT-CHANGE-DATE = 2020-10-25,03:00:00 % SYNCHRONIZATION = SERVER-CONN-EXT-REF % EPOCH = 08