SYSTEM-INFO

File 26
Op-Sys z/OS, z/VSE, BS2000
Statement FIND
Task

Retrieve information from the operating system on which this Entire System Server is running.

In an Entire Net-Work environment, this view can be used to determine which operating systems are to be supported.

Common Fields for all Operating Systems

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
NODE-NAME-LIST A16      
SYSTEM-MESSAGE-CODE A10      
SYSTEM-TYPE A8      
SYSTEM-RELEASE A8      
SECURITY A4      
AUTO-LOGON A3      
ESY-VERSION A8      
NODE-ID A50      
JOBNAME A8      
STARTUP-PARM A80   D  
LOCAL-DATX D      
LOCAL-TIMX T      

Additional Fields Supported for z/OS, z/VSE

Dictionary Field Name F/L Mu DE Remarks
CPU-ID A12   D  
CPU-UTILIZATION N3      
GMT-DIFFERENCE N3   D  
LAST-IPL-DATX D   D  
LAST-IPL-TIMX T   D  
PRODUCT-NAME A16      
PRODUCT-VERSION A8      
SPOOL-RELEASE A8   D  
SPOOL-TYPE A8   D  

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
SYSTEM-NAME A8   D  
SMF-RECORD N3   D  
APF N3   D  

Additional Fields Supported for z/VSE

Dictionary Field Name F/L Mu DE Remarks
DATE-FORMAT A3   D  
SYSTEM-ID A16   D  

Additional Fields Supported for BS2000

Dictionary Field Name F/L Mu DE Remarks
SYSTEM-CODE B2      
SYSTEM-BASE-ADDRESS A8      
CONFIGURATION-NAME A21      
MEMORY-SIZE A8      
FIRST-CPU-SERIAL-NUMBER A6      
SECOND-CPU-SERIAL-NUMBER A6      
OPERATING-SYSTEM-TYPE A4      
OPERATING-SYSTEM-ID A8      
JOBVAR A3      
SESSION-NUMBER N3      
LMS-VERSION N3      
MODE A8      
LOGON-ID A8      

Relevant Error Codes

Code Text z/OS z/VSE BS2000
799 Entire System Server internal error.    

X

Field Descriptions

Field Name Type/Length Operating System
APF (A3) z/OS

Possible values:

Value Explanation
NO  Entire System Server is not running APF-authorized.
YES  Entire System Server is running APF-authorized.
Field Name Type/Length Operating System
AUTO-LOGON (A3) z/OS, z/VSE, BS2000

Automatic logon option for the Entire System Server. If YES is specified in the corresponding startup parameter, the Entire System Server will perform an automatic logon to the active security system using *INIT-USER as user ID.

Field Name Type/Length Operating System
CONFIGURATION-NAME (A21) BS2000

Hardware type (for example, 7500-H60-F).

Field Name Type/Length Operating System
CPU-ID (A12) z/OS, z/VSE

Bytes 1-8 contain the CPU identification number, bytes 9-12 the machine-type number of the CPU. Both provide a unique CPU identification that can be used in associating results with an individual machine.

Field Name Type/Length Operating System
CPU-UTILIZATION (N3) z/OS

Percentage of time the CPU is busy.

Field Name Type/Length Operating System
DATE-FORMAT (A3) z/VSE

DATE-FORMAT returns the value specified in the VSE JCS card //STDOPT DATE =. The values returned are DMY or MDY. Used to determine default date format as displayed in z/VSE .

Field Name Type/Length Operating System
ESY-VERSION (A8) z/OS, z/VSE, BS2000

The version number of this Entire System Server, for example, 3.3.1.

Field Name Type/Length Operating System
FIRST-CPU-SERIAL-NUMBER (A6) BS2000

The serial number of the first CPU.

Field Name Type/Length Operating System
GMT-DIFFERENCE (N3) z/OS, z/VSE

Time difference in hours between local time and GMT.

Field Name Type/Length Operating System
JOBNAME (A8) z/OS, z/VSE, BS2000

Job name of the Entire System Server node.

Field Name Type/Length Operating System
JOBVAR (A3) BS2000

Possible values:

Value Explanation
NO  Software product Job Variables not available.
YES  Software product Job Variables is installed.
Field Name Type/Length Operating System
LAST-IPL-DATX (D) z/OS, z/VSE

Date in Natural format of last system IPL.

Field Name Type/Length Operating System
LAST-IPL-TIMX (T) z/OS, z/VSE

Time in Natural format of last system IPL.

Field Name Type/Length Operating System
LMS-VERSION (N3) BS2000

LMS version which must be used by this Entire System Server node as specified in the startup parameters.

Field Name Type/Length Operating System
LOCAL-DATX (D) z/OS, z/VSE, BS2000

Current date in Natural format.

Field Name Type/Length Operating System
LOCAL-TIMX (T) z/OS, z/VSE, BS2000

Current time of day in Natural format.

Field Name Type/Length Operating System
LOGON-ID (A8) BS2000

Returns the current user ID of the caller. This value is changed after NATPROC-LOGON.

Field Name Type/Length Operating System
MEMORY-SIZE (A8) BS2000

Available system main storage in bytes.

Field Name Type/Length Operating System
MODE (A8) BS2000

Indicates the user mode of Entire System Server. Possible values:

  • MULTI

  • SINGLE

Field Name Type/Length Operating System
NODE-ID (A50) z/OS, z/VSE, BS2000

Logical identifier of the node. This value is defined for the node using the startup parameter IDENTIFIER.

Field Name Type/Length Operating System
NODE-NAME-LIST (A16) z/OS, z/VSE, BS2000

Lists entries of Entire System Server Nodes.

Field Name Type/Length Operating System
OPERATING-SYSTEM-ID (A8) BS2000

Program name of the BS2000 where the Entire System Server is running.

Field Name Type/Length Operating System
OPERATING-SYSTEM-TYPE (A4) BS2000

Type of hardware-software interface. Possible values:

Value Explanation
NXS  24-bit address mode
XS25  25-bit address mode
XS31  31-bit address mode
Field Name Type/Length Operating System
PRODUCT-NAME (A16) z/OS, z/VSE

The name of the product as defined in the operating system. Currently, possible values are z/OS, z/VSE.

Field Name Type/Length Operating System
PRODUCT-VERSION (A8) z/OS, z/VSE

The version of the product as defined in the operating system. In z/OS environments, this will be in the format vv.rr.mm, whilst in the z/VSE environment this will be v.r.m.

Field Name Type/Length Operating System
SECOND-CPU-SERIAL-NUMBER (A6) BS2000

The serial number of the second CPU.

Field Name Type/Length Operating System
SECURITY (A4) z/OS, z/VSE, BS2000

Security system defined in Entire System Server startup parameters.

Field Name Type/Length Operating System
SESSION-NUMBER (N3) BS2000

Number of actual BS2000 session.

Field Name Type/Length Operating System
SMF-RECORD (N3) z/OS

SMF record number written by the Entire System Server.

Field Name Type/Length Operating System
SPOOL-RELEASE (A8) z/OS, z/VSE

Spooling system release number.

Field Name Type/Length Operating System
SPOOL-TYPE (A8) z/OS, z/VSE

Spooling system type.

Field Name Type/Length Operating System
STARTUP-PARM (A80) z/OS, z/VSE, BS2000

Entire System Server startup parameters. To obtain all startup parameters, use a processing loop in Natural.

Field Name Type/Length Operating System
SYSTEM-BASE-ADDRESS (A8) BS2000

Gives the start address of the virtual system address space.

Field Name Type/Length Operating System
SYSTEM-ID (A16) z/VSE

POWER-ID.

Field Name Type/Length Operating System
SYSTEM-NAME (A8) z/OS

SMF system name.

Field Name Type/Length Operating System
SYSTEM-RELEASE (A8) z/OS, z/VSE, BS2000

Operating system release number.

Field Name Type/Length Operating System
SYSTEM-TYPE (A8) z/OS, z/VSE, BS2000

Operating system type. For compatibility reasons, MVS/ESA is returned on a z/OS system, and DOS is returned on a z/VSE system. Use the field PRODUCT-NAME to determine the name of the product as defined in the operating system. Possible options:

Option Explanation
DOS  Old notation for z/VSE .
BS2000   
MVS/ESA  Old notation for z/OS

Example 1:

The following example displays system information on the Entire System Server with Node Number 148: 

PROCESS SYSTEM-INFO WITH NODE = 148
  DISPLAY SYSTEM-TYPE SYSTEM-RELEASE
          PRODUCT-NAME (EM=X(8)) PRODUCT-VERSION SPOOL-TYPE

Sample output from above program: 

SYSTEM-TYPE SYSTEM-RELEASE PRODUCT-NAME PRODUCT-VERSION SPOOL-TYPE
----------- -------------- ------------ --------------- ----------

MVS/ESA     SP7.0.2        z/OS         01.02.00        JES2

Example 2:

The following example displays spool information and the startup parameter with the keyword SPOOL of the Entire System Server with Node Number 85: 

PROCESS SYSTEM-INFO WITH NODE = 85
                      AND STARTUP-PARM = '*SPOOL=*'
  DISPLAY SPOOL-TYPE SPOOL-RELEASE STARTUP-PARM (EM=X(18))
Sample output from above program: 
SPOOL-TYPE SPOOL-RELEASE STARTUP-PARM
---------- ------------- ------------------

JES3       OS2.10.0         SPOOL=JES3