SYSTEM-INFO

File 26
Op-Sys z/OS, z/VSE, BS2000/OSD
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/OSD

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/OSD
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/OSD

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/OSD

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/OSD

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/OSD

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/OSD

Job name of the Entire System Server node.

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

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/OSD

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/OSD

Current date in Natural format.

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

Current time of day in Natural format.

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

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/OSD

Available system main storage in bytes.

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

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/OSD

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/OSD

Lists entries of Entire System Server Nodes.

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

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

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

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/OSD

The serial number of the second CPU.

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

Security system defined in Entire System Server startup parameters.

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

Number of actual BS2000/OSD 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/OSD

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/OSD

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/OSD

Operating system release number.

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

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/OSD   
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