1 07/25/86  initiate, in
 2 
 3 Syntax as a command:  in path {ref_names} {-control_args}
 4 
 5 
 6 Function: initiates segments or multisegment files.
 7 
 8 
 9 Arguments:
10 path
11    is the pathname of a segment or MSF or, a link to a segment or MSF.
12    The star convention is NOT allowed.
13 ref_names
14    are optional reference names by which to initiate the file.
15    If no ref_names are specified, the file is initiated by the
16    entryname portion of path.
17 
18 
19 Control arguments:
20 -all, -a
21    initiates the file by all its names.
22 -brief, -bf
23    does not print a message giving the segment number. (Default)
24 -chase
25    used with -all on a link pathname, initiates the target file by all
26    the names on the target segment. (Default)
27 -force, -fc
28    terminates each reference name first if it is already known.
29 
30 
31 -long, -lg
32    prints a message giving the segment number assigned.
33 -no_chase
34    used with -all on a link pathname, initiates the target file by all
35    the names on the link.
36 -no_force, -nfc
37    prints an error message if a ref_name is already known. (Default)
38 
39 
40 Access required: nonnull.
41 
42 
43 Notes: Initiating a multisegment file involves initiating component 0 of
44 the MSF with the reference names specified.