Communicator 3000 MPE/iX Release 6.0 (Platform Software Release C.60.00) (30216-90269)

194 Chapter 10
Technical Articles
CI Enhancements
then the first iteration would call FINFO on a file named 'FILE0' rather
than a file named 'FILE1'. This is because explicit variable
dereferencing is performed early by the CI, well before the setvar()
function is called.
DIRNAME
DIRNAME()—returns the directory components of a POSIX or MPE
filename. String function.
Syntax
DIRNAME(str)
This new function returns the directory components for the passed
filename. str can be any filename in MPE or POSIX syntax. MPE
filenames are converted to POSIX names before extracting the directory
portion of the name.
Examples
CALC dirname('a.b.c')
/C/B
CALC dirname('/a/b/c')
/a/b
CALC dirname('./a/b')
./a
CALC dirname("./a.sl")
.
CALC dirname('/')
/
CALC dirname("*feq")
[empty string]
CALC dirname('$null')
[empty string]
CALC dirname('abc.g')
/SYS/G
CALC dirname(fqualify('./a'))
/ACCOUNT/GROUP # when the CWD is your logon group or
/CWD # when the CWD is a directory
FQUALIFY
FQUALIFY() returns a fully qualified filename. String function.
Syntax
FQUALIFY(str)
This new function returns the qualified filename for the passed
filename in str. str can be any filename in MPE or POSIX syntax. str is
first attempted to be translated into an MPE name. If that fails it is
converted into a POSIX name. POSIX names are prepended with the
CWD for relative pathnames.
Examples