Guardian Application Conversion Guide

New File-Name Format
Conversion Concepts
2–8 096047 Tandem Computers Incorporated
Table 2-1 shows a comparison of the programmatic representation of C-series and
D-series disk file names.
Table 2-1. C-Series and D-Series Programmatic Representation of Disk File Names
Form C-Series Programmatic Representation D-Series Programmatic Representation
Permanent disk file (without
a specified node name)
1
file-name [0:3]
file-name [4:7]
file-name [8:11]
= Volume name
= Subvolume name
= File ID
[[volume.]subvolume.]file-id
Network permanent disk file file-name [0].<0:7>
file-name [0].<8:15>
file-name [1:3]
file-name [4:7]
file-name [8:11]
= ASCII "\"
= System number
= Volume name
2
= Subvolume name
= File ID
[node-name.][[volume.]subvolume.]file-id
3
Temporary disk file (without a
specified node name)
1
file-name [0:3]
file-name [4:11]
= Volume name
= Temporary file ID
[node-name.][volume.]#temporary-file-number
Network temporary disk file file-name [0].<0:7>
file-name [0].<8:15>
file-name [1:3]
file-name [4:11]
= ASCII "\"
= System number
= Volume name
2
= Temporary file ID
[node-name.][volume.]#temporary-file-number
3
1 The D-series operating system expands a partially qualified D-series file name using the current settings, including the node name,
from the =_DEFAULTS DEFINE VOLUME attribute. A file name that does not include a node name is therefore not necessarily a local
file name on a D-series system.
2 On C-series systems, a process can identify a remote volume name with a maximum of six characters. A remote volume name on a
C-series system does not contain a dollar sign in the programmatic representation.
3 On D-series systems, a converted process can identify a remote volume name with two to eight characters including the dollar sign on
other D-series systems but not on C-series systems.
Device Names A device name identifies an I/O device such as a terminal or printer. A D-series
device name uses the same format as a C-series device name, which is a dollar sign
followed by one to seven letters or digits The first alphanumeric character in the name
must be a letter. The device name can also have an optional qualifier, which is a
pound sign (#) followed by one to seven letters or digits, the first of which must be a
letter. Examples of valid D-series device names are:
$TAPE001 ! Device name
$LAZRPTR.#QWERTY ! Device name and qualifier
\TOKYO.$TERM080 ! Node and device name
\NY.$LINEPTR.#ROOM10 ! Node, device name, and qualifier
Note Although logical device numbers are valid for the D-series operating system, Tandem recommends that
you use a logical device name rather than a logical device number whenever possible. Logical device
numbers are often unreliable (for example, with Dynamic System Configuration).