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 or openUTM, *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
VMS

*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	MS_OS/2	UNISYS 5
AVIION	MVS/ESA	UNISYS 6
BS2000	NCR 3000	VSE/ESA
BS2/XS	OS	WNT-X86
BULL/BOS	OS/400
DEC-OSF/	RS_6000
DPS300	SCO
DRS 6000	SINIX_52
FUJI M73	SINIX_54
HP_HPUX	SUN_SOLA
MSDOS	SUN_SUNO

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)
TIAM
TSO
TSS
UTM

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

On Windows, UNIX and OpenVMS 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.