CBL_GET_OS_INFO

Returns information about the operating system environment.

Syntax:

call "CBL_GET_OS_INFO" using     parameter-block
                       returning status-code

Parameters

parameter-block

Group predefined as cblt-os-info-params containing

01 cblt-os-info-params               typedef.
  03 cblte-osi-length                cblt-x2-compx.	 *> pic x(2) comp-x value 28.
  03 cblte-osi-os-type               cblt-x1-compx. 	*> pic x comp-x.
  03 cblte-osi-os-version            cblt-x4-compx. 	*> pic x(4) comp-x.
  03 cblte-osi-dbcs-support          cblt-x1-compx. 	*> pic x comp-x.
  03 cblte-osi-char-coding           cblt-x1-compx. 	*> pic x comp-x.
  03 cblte-osi-country-id            cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-code-page             cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-process-type          cblt-x1-compx. 	*> pic x comp-x.
  03 cblte-osi-rts-capabilities      cblt-x4-compx. 	*> pic x(4) comp-x.
  03 cblte-osi-product               cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-product-version       cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-product-revision      cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-product-sp            cblt-x2-compx. 	*> pic x(2) comp-x.
  03 cblte-osi-fixpack               cblt-x2-compx. 	*> pic x(2) comp-x.

status-code

See Library Routines - Key.

On Entry:

cblte-osi-os-length: Length of the information expected to be returned.

On Exit:

cblte-osi-os-length

Length of the information returned; this can be less than or equal to the length on entry

cblte-osi-os-type

131 for Windows systems, 128 for COBOL systems on UNIX

cblte-osi-os-version

Use is specific to the operating system. Can include information such as chip type and the operating system version number. For Windows the third and fourth bytes contain the minor and major release operating system version numbers respectively.

cblte-osi-dbcs-support

DBCS support flag:

Bit 0

0	if DBCS validation unsupported
1	if DBCS validation supported

Bit 1

0	if PIC N data-type unsupported
1	if PIC N data-type supported

cblte-osi-char-coding

Character encoding:

0	ASCII
1	Shift-JIS
2	EUC Japan
3	BIG-5 (Traditional Chinese)
4	5550 (Traditional Chinese)
5	GB (Simplified Chinese)
6	KS-CODE (Korean)
7	PC-CODE (Korean)
8	EUC Taiwan
9	Other EUC locales

cblte-osi-country-id

Country code. See your operating system documentation for an explanation of country codes.

cblte-osi-code-page

Code page. See your operating system documentation for an explanation of code page codes.

cblte-osi-process-type

Process type:

0	Process is running in a full screen session
3	Process is running as a true graphical application

cblte-osi-rts-capabilities

Characteristics of run-time system. Set as follows:

Bit	Description
0	multi-threading multi-threaded rts
1	Mainframe offloading capabilities, namely mainframe pointer emulation
2	64-bit capability; the run-time system supports the running of 64-bit applications
3	Indicates whether the program is running under the control of Enterprise Server
4	Indicates that the run-time system is running in Enterprise Server mode
5	Indicates whether the program is running under the CLR (Common Language Runtime)
6	Indicates whether the program is running under a JVM (Java Virtual Machine)
7	Indicates whether the program is running within a Docker container. Restriction: This bit is not applicable to managed COBOL programs.
8	Indicates whether this is a single bit-ism native platform
9-23	Reserved for future use and will be set to 0 by this routine
24	Indicates whether the program is running in Microsoft SQL Server (.NET only)
25	Indicates whether the program is running in Microsoft Azure (.NET only)
26	Indicates whether the program is running in an Enterprise Java Bean (JVM only)
27-31	Reserved for future use and will be set to 0 by this routine

cblte-osi-product

Product identifier:

0	Unknown (backward compatibility)
1	Server Express
2	Net Express
3	Mainframe Express (up to V3.0)
4	Mainframe Express (V3.01 or later)
5	Visual COBOL

cblte-osi-product-version

Product version, for example, for the COBOL development system 4.0, this field would be set to 4

cblte-osi-product-revision

Product revision, for example, for the COBOL development system 4.5, this field would be set to 5

cblte-osi-product-sp

Product service pack level, for example, for Server Express 4.0 Service Pack 1, this field would be set to 1

cblte-osi-fixpack

On Windows this field indicates the RTS fixpack version, for example, for the COBOL development system 4.0 RTS09N40 FixPack, this field would be set to 9. On UNIX, where individual component fixpacks are not provided, this field indicates the product fixpack version.