Open System Services Management and Operations Guide (G06.30+, H06.08+, J06.03+)

Interpreting Guardian Filenames for OSS Files
OSS files have a distinctive form of Guardian filename in the Guardian environment. In addition
to the usual node name and volume name information, the Guardian filename for an OSS file has
the following form:
• Subvolume names begin with ZYQ. These subvolume names correspond to OSS filesets.
The digits that follow ZYQ are the device identifier for the fileset within the ZOSSFSET database
file used by the node. See “The ZOSSFSET File” (page 101) for more information about OSS
device identifiers.
• File identifiers begin with Z0. These file identifiers correspond to OSS file-system inodes.
The rightmost digits in the file identifier correspond to the OSS inode number for the file. (You
can also have files other than OSS files whose file identifiers begin with Z0.) See
“Inconsistencies Checked by FSCK” (page 162) for more information on the use of inode
numbers.
Using the OSS gname Command
To display the Guardian equivalent of an OSS pathname, enter the following command from the
OSS shell:
gname [-s] filename
where the optional -s flag displays only the Guardian filename and filename is an OSS
pathname. You can use shell wildcard characters in the OSS pathname; however, you should not
use wildcard characters in the node-name portion of a pathname that includes the /E directory
because of the potentially large number of files involved.
Example 11 shows examples of using gname.
Example 11 OSS gname Command Examples
$ gname test
gname: test --> \NODE1.$VOL.ZYQ00000.Z0000DV3
$ gname tes*
gname: test2 --> \NODE1.$VOL.ZYQ00000.Z0000KHP
$ gname -s test
\NODE1.$VOL.ZYQ00000.Z0000DV3
$ gname /E/node2/usr/test3
gname: /E/node2/usr/test3 --> \NODE2.$DATA.ZYQ00001.Z0000DV2
When more than one OSS pathname matches the possible wildcard expansion, only the last file
with a matching pathname is listed. Example 11 illustrates this, where both test and test2 are
in the directory /usr on the NonStop node \NODE1 but only test2 is listed for the command
gname tes*.
Using the OSS pname Command
To display the OSS equivalent of a Guardian filename, enter the following command from the
OSS shell:
pname [-s] filename
where the optional -s flag displays only the OSS pathname and filename is a Guardian
system-qualified filename.
Obtaining Information About OSS Files 175