Guardian Application Conversion Guide

All D-Series Systems Must Be Named
Considerations for Migrating Any Application
D–4 096047 Tandem Computers Incorporated
D-Series Systems
Must Be Named
All D-series systems, unlike C-series systems, must be named, even if they are not part
of an Expand network. Migrating your C-series application from an unnamed system
to a named D-series system might cause problems if:
Your application does not expect a file name to contain a system (node) name.
The D-series system to which your C-series application is migrated is configured
with 8-character (including the dollar sign, $) device names or 6-character
(including the dollar sign, $) process names.
Your program calls the DEFINEREADATTR procedure or the DEFINEINFO
procedure.
File Names Always Include
a System Name
If your C-series application does not expect file names returned to Guardian
procedures to include a system (node) name, buffers allocated for file names might not
be large enough to include the system (node) name.
For example, your C-series application might use the FNAMECOLLAPSE procedure
to convert the internal format of a file name into its external format. If your
application assumes that it is running on an unnamed system, it might allocate
insufficient buffer space for the fully-qualified file name returned by the procedure.
To ensure that your C-series application runs successfully on a D-series system,
modify your application to allow room for the system (node) name in buffers that
might contain a file name returned from a Guardian procedure.
Device Names Should Not
Exceed 7 Characters
Some applications will work incorrectly when the system is given a name, if the
application provides for device names or process names that exceed 7 characters
(including the dollar sign, $).
To ensure that your C-series application runs successfully on a D-series system,
modify your application and your system configuration so that device names and
process names do not exceed 7 characters, including the dollar sign ($).
DEFINEREADATTR and
DEFINEINFO Return a
System Name
The D-series DEFINEREADATTR and DEFINEINFO procedures always include the
system (node) name in file names returned to an application. The =_DEFAULTS
VOLUME attribute is unchanged.
C-series DEFINEREADATTR and DEFINEINFO procedures return the system (node)
name only for remote systems.
To ensure that your C-series application runs successfully on a D-series system,
modify your application to allow room for the system (node) name in buffers that
might contain a file name returned from a DEFINEREADATTR or DEFINEINFO
procedure.