Guardian Application Conversion Guide

Program Elements Affected by D-Series System Enhancements
Converting C Applications
096047 Tandem Computers Incorporated 5–7
Declaring CPU and PIN
Variables
Declare all PIN values, including backup-process PIN values, as short variables.
Declare all CPU values as a separate short variables.
For example:
C-Series Declarations (Superseded) D-Series Declarations
short cpu_pin; short cpu, pin;
char pin;
Declaring and Checking
File-System Error Numbers
A D-series file-system error number can be a maximum of 16 bits. If you call
Guardian procedures, you might need to convert the parts of your program that
declare and check file-system errors.
To accommodate the expanded format, declare a file-system error number as a short
variable:
For example:
C-Series Declaration (Superseded) D-Series Declaration
char fs_error_number; short fs_error_number;
Your program might also include code that sets a maximum value for a file-system
error number (for example, 255). Therefore, make sure that your code does not
exclude any new error numbers. Also, because Tandem might define additional error
numbers in future releases, do not consider currently undefined numbers as invalid.
For a list and description of all file-system error numbers, refer to the Guardian
Procedure Errors and Messages Manual.
Using Guardian File Names Guardian file names include:
Disk file names
Device names (such as a printer or terminal name)
Process file names
You might need to convert the parts of your program that declare and use file-name
variables.
Disk File Names. Your existing program might declare a Guardian disk-file-name
variable. The largest D-series disk file names are:
For permanent files 35 bytes (one byte larger than the external form of a
C-series network file name)
For temporary files 26 bytes (4 bytes larger than the external form of a
C-series network file name)
When accessing Guardian disk files on remote D-series systems in a network, a
converted program can use a network disk file name with an eight-character volume
name (one to seven characters after the dollar sign). A C-series network disk file name
allows a maximum of six characters after the dollar sign in the volume name.