Open System Services Programmer's Guide

Example 14 Using pname to Obtain an OSS Pathname
$ pname \$VOL.ZYQ00000.Z0000DV3
pname: $VOL.ZYQ00000.Z0000DV3 --> /home/henrysp/test
$ pname \\node.\$VOL.ZYQ00000.Z0000DV3
pname: \node.$VOL.ZYQ00000.Z0000DV3 --> /home/henrysp/test
$ pname -s \$VOL.ZYQ00000.Z0000DV3
/home/henrysp/test
$ pname -s '$VOL.ZYQ00000.Z0000DV3'
/home/henrysp/test
File Utility Program (FUP)
The Guardian FUP INFO command with the DETAIL option displays the OSS pathname for a file
next to the PATH: heading, as illustrated in Example 15.
Example 15 FUP INFO DETAIL Display With an OSS File
> fup info \NODE.$ROOT.ZYQ00000.Z0000066, detail
$ROOT.ZYQ00000.Z0000066 12 Apr 2000, 13:01
OSS
PATH: /bin/ls
OWNER -1
SECURITY: -r-xr-xr-x
CREATION DATE: 7 Dec 1998, 10:12
ACCESS TIME: 11 Apr 2000, 10:55
EOF: 89232
In the figure, the OWNER field contains -1 because the owner is the super ID. For other owners,
the field contains the structured form (group_number, member_number) of the NonStop operating
system user ID. The structured form can be converted to the scalar form used as the OSS user ID
(UID) using the following formula:
UID = member_number + (256 * group_number).
Using Guardian Procedures
You can obtain the Guardian filename that corresponds to an OSS pathname with the Guardian
procedure PATHNAME_TO_FILENAME_, and you can obtain the OSS pathname that corresponds
to a Guardian filename with the Guardian procedure FILENAME_TO_PATHNAME_.
Example 16 shows how to use the PATHNAME_TO_FILENAME_ procedure. The program takes
as its input an OSS pathname and prints the corresponding Guardian filename.
The OSS and Guardian File Systems 57