1 02/22/85  set_resource, setr
 2 
 3 Syntax as a command:  setr type STR1...STRN {-control_args}
 4 
 5 
 6 Function: modifies parameters of a resource.
 7 
 8 
 9 Arguments:
10 type
11    is a resource type defined in the Resource Type Description Table
12    (RTDT).
13 STRi
14    is the unique identifying name of the particular resource being
15    modified.  If STR looks like a control argument (with a preceding
16    hyphen), then use -name (-nm) before it.
17 
18 
19 Control arguments:
20 -access_class accr, -acc accr
21    sets the initial AIM access class parameters, where accr is the
22    access class range; you must supply -priv with it.  If your
23    authorization is within the access class range inclusive, you are
24    allowed to read and write to the resource (provided you also meet
25    other access requirements).
26 -acs_path path
27    specifies the pathname of the access control segment (ACS) for this
28    resource.  The ACS and the desired access control list set are not
29    created by set_resource but by the accounting owner.  If you give no
30    -acs_path, the accounting owner of the resource is given rew access
31    by default.
32 
33 
34 -alloc STR
35    sets the allocation state of the resource to free or allocated,
36    where STR must be either "on" or "off"--on sets the allocation state
37    to allocated, off to free.  If you don't supply -alloc, the
38    allocation state is free.  (The allocation state flag is a
39    convenience to you and is largely ignored by resource management.)
40 -attributes STR, -attr STR
41    specifies the desired values for the attributes of this resource.
42 -charge_type name, -crgtp name
43    specifies the name of the billing algorithm used to account for the
44    use of this resource.
45 -comment STR, -com STR
46    specifies the desired value of the comment string for this resource.
47 
48 
49 -location STR, -loc STR
50    specifies a descriptive location for the resource, to aid the
51    operator in locating the resource when it is stored in a special
52    place (e.g., a vault, a different room, etc.); you must supply -priv
53    with -location.
54 -lock STR
55    locks or unlocks the resource, where STR must be either "on" or
56    "off"--on prevents any use of the resource, off allows its use.  If
57    you don't give -lock, the lock is off.  You must supply -priv with
58    -lock.
59 
60 
61 -priv
62    makes a privileged call to obtain the status of this resource (see
63    "Access required" below).  If you are a privileged user (RCP
64    Administrator), it allows you to set and change certain fields
65    (including the acs_pathname) for this resource in the registry, thus
66    effectively allowing yourself enough access to mount a tape for a
67    write.
68 -release_lock STR, -rll STR
69    specifies whether the resource can be released by the owner or only
70    by a privileged process (see "Access required" below)--on resources
71    can only be released by a privileged process, off resources by the
72    owner.  If you don't supply -release_lock, the resource can be
73    released by the owner.  You must give -priv with -release_lock.
74 
75 
76 Access required: You need write effective access to the resource named
77 to modify its status; execute effective access to the resource named to
78 modify protected attributes (only the accounting owner can modify the
79 ACS path); and execute access to the rcp_admin_ gate to use
80 -access_class, -lock, -location, -priv, and -release_lock.
81 
82 
83 Notes: If you specify multiple resources and an error occurs in the
84 modification of one of them, none are modified.
85