Next: PSX_RAND - Generate a random number
Up: Routine Descriptions
Previous: PSX_MALLOC - Allocate virtual memory
PSX_PUTENV
- Set a new environment variable value
- Description:
- The routine sets the specified environment variable to the
supplied value. If it fails it sets STATUS to PSX__NOMEM.
- Invocation:
- CALL PSX_PUTENV( NAME, VALUE, STATUS )
- Arguments:
-
-
NAME = CHARACTER * ( * ) (Given)
-
Name of the environment variable to be set.
-
VALUE = CHARACTER * ( * ) (Given)
-
The new value of the environment variable.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Examples:
-
- CALL PSX_PUTENV( 'DATADIR', DIR, STATUS )
- Set the DATADIR environment variable to the value stored
in the DIR character string.
-
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) 2003 Particle Physics and Astronomy Research Council
Next: PSX_RAND - Generate a random number
Up: Routine Descriptions
Previous: PSX_MALLOC - Allocate virtual memory
PSX POSIX interface routines
Starlink User Note 121
P M Allan
A J Chipperfield
10 April 2003
E-mail:ussc@star.rl.ac.uk
Copyright © 2000 Council for the Central Laboratory of the Research Councils