System Environment-Related System Variables

#### Search Results

Search

# System Environment-Related System Variables

This document covers the following topics:

- *CODEPAGE

- *HARDWARE

- *HOSTNAME

- *INIT-ID

- *INIT-PROGRAM

- *LOCALE

- *MACHINE-CLASS

- *OPSYS

- *OS

- *OSVERS

- *TP

- *TPSYS

- *TPVERS

- *WINMGR

- *WINMGRVERS

## *CODEPAGE

Format/length: | A64
Content modifiable: | No

This system variable returns the IANA name of the default code page which is internally used by Natural for conversions to and from Unicode and which is set by the Natural profile parameter `CP`.

Note
`*CODEPAGE` is also the default if a code page is not specified in a `MOVE ENCODED` statement.

Example:

    IBM01141

To display the content of the system variable `*CODEPAGE`, you can use the system command `CPINFO` or the utility `SYSCP`.

## *HARDWARE

Format/length: | A16
Content modifiable: | No

This system variable contains the name of the hardware platform on which Natural is running. This value is supplied by the operating system.

## *HOSTNAME

Format/length: | A64
Content modifiable: | No

The name of the machine Natural runs on.

## *INIT-ID

Format/length: | A8
Content modifiable: | No

`*INIT-ID` contains the terminal ID (defined according to the conventions of the TP system) of the terminal from which Natural was invoked.

In batch mode, `*INIT-ID` contains the step name of the Natural job.

In an asynchronous Natural session under Com-plete, `*INIT-ID` contains the terminal ID of the task that has started the asynchronous session.

In an asynchronous session under CICS, `*INIT-ID` contains the CICS task number of the asynchronous task.

In a server environment, for example, Natural Development Server or Web I/O Interface Server, `*INIT-ID` contains the current session number, which is incremented by one for each new session that is invoked on the server.

## *INIT-PROGRAM

Format/length: | A8
Content modifiable: | No

This system variable contains the name of the program (transaction) that is currently executing as Natural.

In batch mode under z/OS, `*INIT-PROGRAM` contains the name of the job under which the Natural session is running.

Under TSO, `*INIT-PROGRAM` contains the name of the TSO command under which Natural runs. If no command was issued, for example, because the task was started via `CALL`, the module name of the Natural front-end is used instead.

In a Natural Development Server environment using Com-plete or Com-plete/SMARTS, `*INIT-PROGRAM` is set according to the Com-plete/SMARTS startup option `INSTALLATION`. The default content is `********`.

## *LOCALE

Format/length: | A8
Content modifiable: | No

This system variable contains the language and country of the current locale, which specifies the Unicode collation sequence.

Example:

    en_US

To display the content of the system variable `*LOCALE`, you can use the system command `CPINFO` or the utility `SYSCP`.

## *MACHINE-CLASS

Format/length: | A16
Content modifiable: | No

This system variable contains the name of the machine class on which Natural is running.

It can contain one of the following values:

MAINFRAME
PC
UNIX

## *OPSYS

Format/length: | A8
Content modifiable: | No

This system variable contains the Natural name of the operating system that is being used.

It can contain one of the following values:

ATT_OSX | MVS/ESA | WNT-X86
AVIION | NCR 3000 |
BULL/BOS | OS |
DEC-OSF/ | RS_6000 |
DPS300 | SCO |
DRS 6000 | SINIX_52 |
FUJI M73 | SINIX_54 |
HP_HPUX | SUN_SOLA |
MSDOS | SUN_SUNO |
LINUX | WNT-X86

Note
Instead of `*OPSYS`, it is recommended that the system variables `*MACHINE-CLASS`, `*HARDWARE` and `*OS` be used, as they allow a more precise distinction of the environment in which Natural is running.

## *OS

Format/length: | A32
Content modifiable: | No

This system variable contains the name of the operating system under which Natural is running. This value is supplied by the operating system and may be subject to change.

## *OSVERS

Format/length: | A16
Content modifiable: | No

This system variable contains the version number of the operating system under which Natural is running. This value is supplied by the operating system and may be subject to change.

## *TP

Format/length: | A8
Content modifiable: | No

It contains the name of the TP subsystem under which Natural is running. This value is supplied by the operating system and may be subject to change.

## *TPSYS

Format/length: | A8
Content modifiable: | No

This system variable contains the Natural name of the TP monitor or environment that is being used.

It can contain one of the following values:

`AIM/DC`
`CICS`
`COMPLETE`
`IMS TM`
`OS/400`
`SERVSTUB` (Natural Development Server)
`TSO`
`TSS`

On mainframe platforms, `*TPSYS` will be blank in batch mode.

On Windows and Linux platforms, `*TPSYS` will be `NONE`.

## *TPVERS

Format/length: | A8
Content modifiable: | No

It contains the version of the TP subsystem under which Natural is running. This value is supplied by the operating system and may be subject to change.

If no TP monitor is used, `*TPVERS` will be blank.

## *WINMGR

Format/length: | A16
Content modifiable: | No

If a graphical user interface is used, this system variable contains the name of the window manager being used (for example, MOTIF or PM).

If a character-oriented user interface is used, `*WINMGR` will be blank.

The type of user interface is indicated by the value of the system variable `*UI`.

## *WINMGRVERS

Format/length: | A16
Content modifiable: | No

If a graphical user interface is used, this system variable contains the version number of the window manager being used.

If a character-oriented user interface is used, `*WINMGRVERS` will be blank.

The type of user interface is indicated by the value of the system variable `*UI`.

### On this page

- *CODEPAGE
- *HARDWARE
- *HOSTNAME
- *INIT-ID
- *INIT-PROGRAM
- *LOCALE
- *MACHINE-CLASS
- *OPSYS
- *OS
- *OSVERS
- *TP
- *TPSYS
- *TPVERS
- *WINMGR
- *WINMGRVERS