OS-GETENV function

Returns a string that contains the value of the desired environment variable in the environment in which the ABL session is running.

Syntax

OS-GETENV ( environment-variable )

environment-variable

The name of the environment variable whose value you want to find.

Example

This procedure prompts a user for a report name. It then builds the full pathname where the report will be stored, using OS-GETENV to find the DLC directory. Finally, the procedure displays the full pathname.

r-os-env.p

DEFINE VARIABLE pathname    AS CHARACTER NO-UNDO FORMAT "x(32)"
  LABEL "The report will be stored in ".
DEFINE VARIABLE report_name AS CHARACTER NO-UNDO FORMAT "x(32)"
  LABEL "Please enter report name." .

UPDATE report_name.
pathname = OS-GETENV("DLC") + "/" + report_name.
DISPLAY pathname WITH FRAME b SIDE-LABELS.

Notes

• If the environment variable is not defined, this statement returns the Unknown value (?).
• This function returns the value of an environment variable defined before the ABL session started, not a variable defined during the session.
• Since environment variables are case sensitive in some environments, make sure that the name you supply is the correct case.