SERVERENV() - Get Server Side O/S Environment Variables

Syntax

SERVERENV(str{,IND=int}{,ERR=lineref})

Description

In BBj 4.0 and higher, the SERVERENV() function returns the value of the specified operating system's environment variable from the server side of a thin client session.

Parameter

Description

str

Operating system environment variable.

IND=int

IND=0 forces the variable lookup to be case sensitive.

IND=1 forces the variable lookup to be case insensitive.

If this parameter is omitted, the variable lookup is case-sensitive on UNIX and Linux and case-insensitive on Window.

ERR=lineref

Branch taken if an error occurs during execution.

If the specified environment variable does not exist, an !ERROR=11 - Missing or Duplicate Key is returned.

Note: From a fat client, an !ERROR=11 - Missing or Duplicate Key is always returned. The -FC option has been obsolete since BBj 5.00.

Example

rem ' Retrieve the name of the client side Windows command processor

PRINT SERVERENV("COMSPEC")

C:\WINNT\SYSTEM32\CMD.EXE

rem ' Retrieve the name of the client side shell on UNIX or Linux
PRINT CLIENTENV("SHELL")

/bin/ksh

See Also

ENV() Function - Get O/S Environment Variables

CLIENTENV() Function - Get Client Side O/S Environment Variables

Functions - Alphabetical Listing