Open System Services Programmer's Guide

Table 5 Guardian Filename to OSS Pathname Translation Examples (continued)
OSS PathnameGuardian Filename
/G/p/#pty12$p.#PTY12
/G/pubs/henry/panaceas$pubs.henry.panaceas
Obtaining Corresponding Guardian and OSS Filenames
You can obtain the Guardian filename that corresponds to an OSS pathname and vice-versa with
OSS shell utilities, the Guardian File Utility Program (FUP), or through programmatic interfaces.
Using OSS Shell Utilities
You can obtain the Guardian equivalent of an OSS pathname with the OSS shell utility gname,
and you can obtain the OSS equivalent of a Guardian filename with the OSS shell utility pname.
To display the fully qualified Guardian filename that corresponds to an OSS pathname, enter the
following from the OSS shell:
gname [-s] pathname
where the -s flag displays only the Guardian filename and pathname is an OSS pathname.
Example 13 shows examples of using gname.
Example 13 Using gname to Obtain a Guardian Filename
$ gname test2
gname: test2 --> \NODE.$VOL.ZYQ00000.Z0000KHP
$ gname -s test
\NODE.$VOL.ZYQ00000.Z0000DV3
$ gname /G/zznt/#pty00bk
gname: /G/zznt/#pty00bk --> \NODE.$ZZNT.#PTY00BK
To display the OSS pathname that corresponds to a Guardian filename, enter the following from
the OSS shell:
pname [-s] filename
where the -s flag displays only the OSS pathname and filename is a Guardian fully qualified
or system-qualified filename. Example 14 shows examples of using pname.
NOTE: As shown in Example 14, you must put a backslash (\) before the slash (/), the backslash
(\), and dollar sign ($) characters, or else the shell will interpret them with their special shell
meanings rather than as plain characters. You can also put the filename inside single quotation
marks.
56 Managing Files