PSX_GETENV

Translate an environment variable

Description:

The routine tries to get the translation of the environment variable NAME. If it succeeds, it returns the translation in TRANS. If it fails, it sets STATUS to PSX__NOENV and reports an error.

Invocation

CALL PSX_GETENV( NAME, TRANS, STATUS )

Arguments

NAME = CHARACTER ( ) (Given)
Name of the environment variable to be translated.
TRANS = CHARACTER ( ) (Returned)
The translation of the environment variable.
STATUS = INTEGER (Given and Returned)
The global status.

Examples:

CALL PSX_GETENV( USER, TRANS, STATUS )
This will return the value of the environment variable USER, i.e. the username of the current process.

External Routines Used

cnf: cnfCreim, cnfExprt, cnfFree

References

Copyright

Copyright (C) 1991 Science & Engineering Research Council