1 01/02/90  get_pathname, gpn
 2 
 3 
 4 Syntax as a command:  gpn {-control_arg} arg
 5 
 6 
 7 Syntax as an active function:  [gpn {-control_arg} arg]
 8 
 9 
10 Function:  returns the absolute pathname of the segment designated by a
11 specified reference name or segment number.  (Reference names are
12 discussed in the MPM Reference Guide.)  If the reference name or
13 segment number is not in use, an error message is printed.
14 
15 
16 Arguments:
17 arg
18    is a reference name or octal segment number known to this process.
19 
20 
21 Control arguments:
22 -name, -nm
23    indicates that arg (which happens to look like an octal segment
24    number) is to be interpreted as a reference name.  If this control
25    argument is not specified, the system assumes arg is a reference
26    name only if arg is not a valid octal number.
27 
28 
29 Notes:  Since the pathname is returned in quotes, the command processor
30 treats it as a single argument regardless of special characters in the
31 name.