1 07/25/86  where, wh
 2 
 3 Syntax as a command:  wh names {-control_args}
 4 
 5 
 6 Syntax as an active function:  [wh name {-control_args}]
 7 
 8 
 9 Function: uses the standard search rules to search for a given file
10 or entry point.
11 
12 
13 Arguments:
14 names
15    are file and entry point names.  You can't use the star
16    convention.
17 
18 
19 Control arguments:
20 -all, -a
21    lists the pathnames of all files and entry points with the
22    specified names that you can find using the current search rules,
23    your effective access to each segment or entry point, and the name
24    of the search rule used to find each file or entry point.  It is
25    incompatible with -long.
26 -brief, -bf
27    prints only the pathname of each entry found.  (Default)
28 -entry_point, -ep
29    searches for entry points.  If a name argument does not contain a
30    dollar sign, the command searches for the entry point name$name.
31 
32 
33 -inhibit_error, -ihe
34    does not print an error message if no files can be found for a
35    given name.  For the command no output is printed, for the active
36    function the null string is returned.
37 -long, -lg
38    prints the pathname, the name of the search rule used to find each
39    segment or MSF, and your effective access to the file.
40 -no_inhibit_error, -nihe
41    prints an error message if no segments or MSFs can be found for a
42    given name.  (Default)
43 -segment, -sm, -file
44    searches for segments or MSFs.  (Default, unless name contains a $)
45 
46 
47 Notes:  The command prints out the full pathname of the file, using
48 its primary name, and the entry point name if you request one.  If the
49 file or entry point is not in the search path, an error message is
50 printed.
51 
52 The primary name of a storage system entry is the name that is first in
53 the list of names on that entry.
54 
55 If you supply -all, where prints information only about the first
56 matching file or entry point encountered.
57 
58 
59 
60 The -entry_point and -file control arguments are mutually exclusive.
61 If you provide one of them, all the name arguments are assumed to be of
62 the type specified.  If you give neither -entry_point nor -file,
63 where scans the name arguments:  any name arguments that contain a
64 dollar sign are assumed to be names of entry points; all others, names
65 of files.
66 
67 See "Search Rules" in the Programmer's Reference Manual.
68 
69 
70 Notes on active function:  The active function returns the pathname of
71 the file.  You can't use -all, -brief, and -long.  Unless you supply
72 -inhibit_error, an error occurs if no segment or MSF can be found.