Guardian Application Conversion Guide

Program Elements Affected by D-Series System Enhancements
Converting C Applications
5–8 096047 Tandem Computers Incorporated
Therefore, you might need to declare your network file-name variables large enough
to include this extra character and the terminating null character. To ensure that your
declaration is long enough, use the ZSYS_VAL_LEN_FILENAME constant from the
ZSYSC file and add one for the null character. For example:
char employee[ZSYS_VAL_LEN_FILENAME + 1] =
"\\newyork.$payroll.july1990.employee";
char managers[ZSYS_VAL_LEN_FILENAME + 1] =
"\\newyork.$disk4.level1.managers";
Device Names. Your existing program might declare a variable for a Guardian device
name. The largest D-series device names are:
Device name without a node name or qualifier 8 characters
Device name without a node name but with a qualifier 17 characters
Network device name without a qualifier 17 characters
Network device name with a qualifier 26 characters
When accessing devices on remote D-series systems in a network, a converted
program can use eight-character network device names (one to seven characters after
the dollar sign). A C-series network device name allows a maximum of six characters
after the dollar sign.
Therefore, you might need to declare your network device names large enough to
include this extra character and the terminating null character. If you use the ZSYSC
file, use the ZSYS_VAL_LEN_FILENAME constant and add one for the null character.
For example:
/* Network device name without a qualifier */
char device_name[19] = "\\hamburg.$term001";
/* Network device name with a qualifier */
char network_device_name[ZSYS_VAL_LEN_FILENAME + 1] =
"\\hamburg.$lineptr.#room025";
Process File Names. Your existing program might declare a variable for a C-series
process file name. The D-series operating system uses D-series process file names
instead of C-series process file names. Use C-series process file names for
compatibility with unconverted C-series procedures.
D-series process files names are variable-length string data items with their lengths
specified as separate data items. The following example uses declarations from the
ZSYSC file to declare a process file name:
/* process file name: */
char process_filename[ZSYS_VAL_LEN_FILENAME + 1];
The process-file-name declaration has an extra byte for the terminating null character.