Guardian Application Conversion Guide

Managing Your Disk Files
Converting Other Parts of an Application
8–2 096047 Tandem Computers Incorporated
Managing Your
Disk Files
This subsection describes how to convert an application that calls Guardian file-system
procedures to:
Manipulate and edit disk file names
Manage disk files and volumes
Converting an application to use D-series file-system procedures is usually optional.
However, you might want to convert it because:
D-series file-system procedures accept and return file-name string parameters
rather than internal-format file-name parameters. You are not required to convert
the name from external to internal format before you call a D-series procedure.
D-series file-system procedures automatically expand a partially qualified file
name to a fully qualified file name using the current settings, including the node
name, from the =_DEFAULTS DEFINE VOLUME attribute. You are not required
to expand the name before you call a D-series procedure.
D-series file-system procedures allow access to remote disk files on other D-series
systems in a network with eight-character volume names (seven alphanumeric
characters after the dollar sign). C-series procedures can access remote files with
volume names that have a maximum of six characters after the dollar sign.
D-series file-system procedures return a file-system error value rather than a
condition code, which not only makes error checking easier but also simplifies
calling file-system procedures from C programs.
The D-series FILE_GETINFOLIST_ and FILE_GETINFOLISTBYNAME_
procedures can return more information about a file than the superseded C-series
procedures can return.
Manipulating and Editing
Disk File Names
The D-series operating system provides new file-system procedures to manipulate
disk file names, including:
Expanding partially qualified disk file names
Extracting and modifying parts of a file name
Comparing two file names
Using wild-card characters in a file name
Upshifting ASCII strings
Converting file names between C-series and D-series formats
These topics are described in the following subsections.