Domain: Environment information
The SYSTEM-INFORMATION( ) function can be used to request system information and system parameters. One value can be queried per call.
Restrictions
The SYSTEM-INFORMATION( ) function is equivalent to the Executive macro SINF at the program level (see the manual entitled “Executive Macros” [7] for information on the SINF macro call) which is only supported for compatibility reasons. The SINF macro is not developed further and is replaced by the NSIINF and NSIOPT macros. Consequently system information and system parameters which were introduced only after this macro was replaced cannot be queried with the SYSTEM-INFORMATION( ) function. The values which can be queried are listed in the “Overview of possible parameter values”.
The system information and system parameters which currently exist can be requested on command level using the commands SHOW-SYSTEM-INFORMATION and SHOW-SYSTEM-PARAMETERS. These commands also support structured output to S variables (see the manual “Commands” [3]).
Format
SYSTEM-INFORMATION( ) SYS-INF( ) |
INFORMATION = string_expression |
Result type
STRING
Input parameters
INFORMATION = string_expression
Designates the name of a system parameter or a system parameter. You can only specify those names that are also supported by the SINF macro call (see the following “Overview of possible parameter values”).
Result
The item of system information or system parameter is returned in the form of a string.
Error message
SDP0435 DESIRED INFORMATION NOT AVAILABLE
Overview of possible parameter values
The permissible parameter values are the same as the values which may be specified for the INFO operand in this macro. The system parameters and system information are listed in abbreviated form in the following two tables.
The parameters are described in the SHOW-SYSTEM-PARAMETERS command in the “Commands” manual [3]. The system information is described in the “Executive Macros” manual [7].
System parameters
System | Meaning |
BLKCTRL | Default value for the file attribute BLKCTRL |
BLSCOPYN | Default value for the operand COPYRIGHT in the utility routine BINDER. |
BLSCOPYR | Default value for the operand COPYRIGHT in the utility routine TSOSLNK. |
DEFLUID | The default value for :catid:$userid in file path names for some commands and utility routines. |
DMCMAXP | Maximum number of entries in the MRS catalog of the home pubset. |
DUMPCL5P | Indicates whether the privileged class 5 memory is included in the user and area dumps output by CDUMP. |
DUMPSEPA | Indicates whether secret pages are included in user and system dumps. |
ENCRYPT | Indicates whether passwords are encrypted internally in the system. |
SECSTART | Indicates whether secure system start is active or inactive. |
SECSTENF | Indicates whether system initiation is aborted if the REPs cannot be logged completely. |
SHUTARCH | Indicates whether the system checks, when SHUTDOWN is initiated, whether the program ARCHIVE is still being used. |
SSMLGOF1 | Indicates how the spoolout of the system files SYSLST and SYSOUT is executed at the end of a job. |
SSMLGOF2 | Indicates whether messages are output when spooling out system files. |
SVC79 | Indicates restrictions for the use of SVC79 (switching from the non-privileged (TU) to the privileged system status (TPR)). |
TEMPFILE | The character which identifies temporary (user) files or job variables (one of the characters #, @ or NO). |
System information
System | Meaning |
CONFNAME | System type (model range) e.g.: H120-S (in the old format). |
CONFNAMX | System type (model range) in the new extended format, e.g.: 7.500-C40-F |
CPUID | The CPU identifier. The output consists of 8 elements, each 8 bytes in length. |
CPUSER | Serial number (6 digits each) of the first, second, third and fourth CPU. If a CPU does not exist, X' 000000' is entered in the corresponding field. The entries are not related to the CPU addresses. |
HSIBASE | The HSI base type. |
HSILINE | Additional information about the HSI CFCS3. |
HSITYPE | Attributes of the current HSI type. |
HSIVM | Indicates whether this is a real or a virtual machine. |
MEMSIZE | Size of the (physical) main memory available for the software (specified in bytes). |
OSAMODE | Indicates the addressing mode of the operating system. |
OSID | Byte 0-7: Program name of the operating system, e.g. ' BS2V095 '. |
SYSBASE | Start address of the operating system in the virtual address space. |
Example 1
/A = SYSTEM-INFORMATION(INFORMATION='MEMSIZE') /SHOW-VARIABLE A A = 1073741824
The size of the physical main memory that can be used by the software is output in variable A: 1,073,741,824 bytes
Example 2
Procedure for querying several pieces of system information or several system parameters:
/DECLARE-VARIABLE VALUE-LIST,TYPE=*STRING, / INITIAL-VALUE='(- /BLKCTRL,DEFLUID,OSID,CONFNAMX,CPUID,HSIVM,SSMLGOF1,SSMLGOF2,TEMPFILE)' /DECLARE-VARIABLE ACT-VALUE,TYPE=*STRING /DECLARE-VARIABLE I,TYPE=*INTEGER /FOR I = *COUNTER(FROM=1,TO=SUBLIST-NUMBER(VALUE-LIST)) / ACT-VALUE = SUBLIST(VALUE-LIST,I) / SHV ACT-VALUE,VALUE=C-LIT / WRITE-TEXT '&ACT-VALUE: &(SYSTEM-INFORMATION(ACT-VALUE))' / IF-BLOCK-ERROR / WRITE-TEXT 'CURRENTLY NO INFORMATION AVAILABLE FOR &ACT-VALUE' / END-IF /END-FOR
Output after calling the procedure:
ACT-VALUE = 'BLKCTRL' BLKCTRL: PAMKEY ACT-VALUE = 'DEFLUID' DEFLUID: $TSOS ACT-VALUE = 'OSID' OSID: M12BXS V140 ACT-VALUE = 'CONFNAMX' CONFNAMX: 7.500- S150-40 ACT-VALUE = 'CPUID' CPUID: 3002000188000000301200018800000030220001880000000000000000000000000000000 0000000000000000000000000000000000000000000000000000000 ACT-VALUE = 'HSIVM' HSIVM: V2 ACT-VALUE = 'SSMLGOF1' SSMLGOF1: REQ-SPOOL ACT-VALUE = 'SSMLGOF2' SSMLGOF2: YES ACT-VALUE = 'TEMPFILE' TEMPFILE: #