KPG1_FLPTH

Gets the full path to a file given relative to a specified root directory

Description:

This routine returns the full path to a file specified relative to the $ROOT directory. The supplied file spec should be a UNIX-style file spec., but the returned full file path will be translated into the VMS equivalent if required.

Invocation

CALL KPG1_FLPTH( INSTR, OUTSTR, NC, STATUS )

Arguments

ROOT = CHARACTER ∗ ( ∗ ) (Given)
An environment variable which is to be translated to get the full path to the root directory, such as HOME, KAPPA_DIR. If a blank value is supplied, then the current working directory is used ($PWD on Unix and $PATH on VMS).
INSTR = CHARACTER ∗ ( ∗ ) (Given)
The file spec relative to the root directory. E.g. fred.dat, adam/display.sdf, etc.
OUTSTR = CHARACTER ∗ ( ∗ ) (Returned)
The full file path. For example /home/dsb/fred.dat (DISK$USER:[DSB]FRED.DAT on VMS), or /home/dsb/adam/display.sdf (DISK$USER:[DSB.ADAM]DISPLAY.SDF on VMS). Returned blank if an error occurs.
NC = INTEGER (Returned)
Number of characters used in OUTSTR. Returned equal to 0 if an error occurs.
STATUS = INTEGER (Given and Returned)
The global status.