Guardian Procedure Calls Reference Manual
volume
specifies the name of the volume on which the file resides. A volume name consists of a dollar
sign ($) followed by one to seven alphanumeric characters (one to six if you also specify
system); the first alphanumeric character must be a letter.
subvol
specifies the name of the subvolume on which the file resides. A subvolume name has one to
eight alphanumeric characters; the first character must be a letter.
file-id
specifies the file identifier (or name) of a permanent disk file. A permanent-file identifier has
one to eight alphanumeric characters; the first character must be a letter.
temp-file-id
specifies the file identifier (or name) of a temporary disk file. A temporary-file identifier consists
of a pound sign (#) followed by four digits. The operating system assigns file identifiers to
temporary files.
Example
This is an example of a fully qualified external disk file name:
\hdq.$mkt.reports.finance
Nondisk File Names
A nondisk file name can identify a device or a process. The syntax for the external form of a nondisk
file name is:
[system.]{ process-name }[.qual-1[.qual-2]]
{ device-name }
{ ldev-number }
system
specifies the name of the system on which the process or device resides. A system name consists
of a backslash (\) followed by one to seven alphanumeric characters; the first alphanumeric
character must be a letter.
When system is included in a file name, it is called a network file name; when system is
not included, it is called a local file name.
process-name
specifies the name of a process. A process name consists of a dollar sign ($) followed by one
to five alphanumeric characters (one to four if you also specify system); the first alphanumeric
character must be a letter.
device-name
specifies the name of a device. A device name consists of a dollar sign ($) followed by one
to seven alphanumeric characters (one to six if you also specify system); the first alphanumeric
character must be a letter.
ldev-number
specifies a logical device number. A logical device number consists of a dollar sign ($) followed
by one to four digits. The logical device number 0 (represented "$0") is reserved for the Event
Management Service (EMS) collector process.
qual-1 and qual-2
are optional qualifiers. qual-2 cannot be used in combination with device-name; neither
qualifier can be used in combination with ldev-number.
qual-1 consists of a pound sign (#) followed by one to seven alphanumeric characters; the
first alphanumeric character must be a letter.
qual-2 contains one to eight alphanumeric characters; the first character must be a letter.
C-Series Syntax 1541