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
-
POSIX standard (1988), section 4.6.1
-
ANSI C standard (1989), section 4.10.4.4
Copyright
Copyright (C) 1991 Science & Engineering
Research Council
Copyright © 2000 Council for the Central Laboratory of the Research Councils, 2006 Particle Physics
and Astronomy Research Council