SYSTEM-INFO

#### Search Results

Search

# SYSTEM-INFO

File | 26
Op-Sys | z/OS, z/VSE, BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
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

### On this page

- Common Fields for all Operating Systems
- Additional Fields Supported for z/OS, z/VSE
- Additional Fields Supported for z/OS
- Additional Fields Supported for z/VSE
- Additional Fields Supported for BS2000
- Relevant Error Codes
- Field Descriptions