SYSTEM-INFO

File 26
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.


Fields

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      
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  
SYSTEM-NAME A8   D  
SMF-RECORD N3   D  
APF N3   D  

Field Descriptions

Field Name Type/Length
APF (A3)

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
AUTO-LOGON (A3)

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
CPU-ID (A12)

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
CPU-UTILIZATION (N3)

Percentage of time the CPU is busy.

Field Name Type/Length
ESY-VERSION (A8)

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

Field Name Type/Length
GMT-DIFFERENCE (N3)

Time difference in hours between local time and GMT.

Field Name Type/Length
JOBNAME (A8)

Job name of the Entire System Server node.

Field Name Type/Length
LAST-IPL-DATX (D)

Date in Natural format of last system IPL.

Field Name Type/Length
LAST-IPL-TIMX (T)

Time in Natural format of last system IPL.

Field Name Type/Length
LOCAL-DATX (D)

Current date in Natural format.

Field Name Type/Length
LOCAL-TIMX (T)

Current time of day in Natural format.

Field Name Type/Length
NODE-ID (A50)

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

Field Name Type/Length
NODE-NAME-LIST (A16)

Lists entries of Entire System Server Nodes.

Field Name Type/Length
PRODUCT-NAME (A16)

The name of the product as defined in the operating system. Possible value: z/OS.

Field Name Type/Length
PRODUCT-VERSION (A8)

The version of the product as defined in the operating system. This will be in the format vv.rr.mm.

Field Name Type/Length
SECURITY (A4)

Security system defined in Entire System Server startup parameters.

Field Name Type/Length
SMF-RECORD (N3)

SMF record number written by the Entire System Server.

Field Name Type/Length
SPOOL-RELEASE (A8)

Spooling system release number.

Field Name Type/Length
SPOOL-TYPE (A8)

Spooling system type.

Field Name Type/Length
STARTUP-PARM (A80)

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

Field Name Type/Length
SYSTEM-NAME (A8)

SMF system name.

Field Name Type/Length
SYSTEM-RELEASE (A8)

Operating system release number.

Field Name Type/Length
SYSTEM-TYPE (A8)

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

Option Explanation
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

On this page