1 05/13/88  switch_on, swn
 2 
 3 Syntax as a command:  swn keyword paths {-control_args}
 4 
 5 
 6 Function:  turns on a specified switch for one or more
 7 entries--directory, segment, multisegment file (MSF), data mangement
 8 (DM) file, and extended entry.  For an MSF, the switch of the MSF
 9 directory (when possible) and those of all the components are turned
10 on.
11 
12 
13 Arguments:
14 keyword
15    specifies the name of a switch (see "List of Keywords" below).
16 paths
17    are the pathnames of entries for which it is possible to set the
18    specified switch.  You can use the star convention, which includes
19    links only if you give -chase.  You can specify by "-name STR" a
20    pathname that looks like a control argument or contains starname
21    special characters not meant to be matched.
22 
23 
24 Control arguments:
25 -chase
26    includes links and chases them when using the star convention.
27 -interpret_as_extended_entry, -inaee
28    interpret the selected entry as an extended entry type.
29 -interpret_as_standard_entry, -inase
30    interpret the selected entry as a standard entry type.
31 -name STR, -nm STR
32    specifies a pathname that looks like a control argument or contains
33    starname special characters not meant to be matched.
34 -no_chase
35    does not include links when using the star convention.  (Default)
36 
37 
38 List of keywords:
39 audit
40    if ON, all accesses (successful or unsuccessful) of the entry will
41    be audited.
42 copy_switch, csw
43    if ON, allows processes lacking write access to modify a copy of the
44    segment in the process directory.  (Segments)
45 complete_volume_dump_switch, cvds
46    if ON, the entry is dumped during a complete volume dump of the
47    physical volume on which it resides.
48 damaged_switch, dsw
49    if ON, the segment is assumed to have been damaged by a device error
50    or system crash.  (Segments)
51 
52 
53 incremental_volume_dump_switch, ivds
54    if ON, the entry is dumped during an incremental dump cycle of the
55    volume dumper.
56 perprocess_static_switch, ppsw
57    if ON, the segment's internal static storage is not initialized when
58    a run unit is created.  (Object segment)
59 safety_switch, ssw
60    if ON, the delete command and delete_ subroutine query you before
61    deleting the entry.
62 synchronized_switch
63    if ON, writes out to disk the segment's pages only after
64    corresponding pages in an associated before journal are written out.
65    Only authorized users can set this switch.  (Segments)
66 
67 
68 Access required:  You require modify permission on the parent
69 directory.  Setting the audit switch requires access to the
70 system_privilege_ gate.
71 
72 
73 Notes:  The keywords can also include switches defined for particular
74 extended entry types (see describe_entry_type).