1 02/08/84  mdc_
  2 
  3 The mdc_ subroutine (actually a ring 1 gate) provides a series of entry
  4 points for manipulation of master directories.
  5 
  6 
  7 Entry points in mdc_:
  8    (List is generated by the help command)
  9 
 10 
 11 :Entry:  create_dir:  02/08/84 mdc_$create_dir
 12 
 13 
 14 Function:  This entry point is used to create a new master directory.
 15 Its arguments are roughly analogous to the hcs_$append_branchx entry
 16 point.
 17 
 18 
 19 Syntax:
 20 declare mdc_$create_dir entry (char(*), char(*), char(*), fixed bin(5),
 21      (3) fixed bin(3), char(*), fixed bin, fixed bin(35));
 22 call mdc_$create_dir (dir_name, entryname, volume, mode, rings,
 23      user_id, quota, code);
 24 
 25 
 26 Arguments:
 27 dir_name
 28    is the pathname of the containing directory.  (Input)
 29 entryname
 30    is the entryname of the subdirectory.  (Input)
 31 volume
 32    is the name of the logical volume that is to contain segments
 33    created in the new directory.  (Input)
 34 mode
 35    is the user's access mode.  (Input)
 36 rings
 37    are the ring brackets of the directory.  (Input) Only the first
 38    values are used.
 39 
 40 
 41 user_id
 42    is an access control name.  (Input)
 43 quota
 44    is the quota to be placed on the new directory.  (Input)
 45 code
 46    is a standard status code.  (Output)
 47 
 48 
 49 :Entry:  create_dirx:  02/08/84 mdc_$create_dirx
 50 
 51 
 52 Function:  This entry point is an extension of the mdc_$create_dir
 53 entry point, which is similiar to hcs_$create_branch_ entry point.
 54 
 55 
 56 Syntax:
 57 declare mdc_$create_dirx entry (char(*), char(*), char(*), ptr,
 58      fixed bin(35));
 59 call mdc_$create_dirx (dir_name, entryname, volume, info_ptr, code);
 60 
 61 
 62 Arguments:
 63 dir_name
 64    is the pathname of the containing directory.  (Input)
 65 entryname
 66    is the entryname of the subdirectory.  (Input)
 67 volume
 68    is the name of the logical volume that is to contain segments
 69    created in the new directory.  (Input)
 70 info_ptr
 71    is a pointer to the create_branch_info structure as described under
 72    the hcs_$create_branch_ entry point.  (Input)
 73 
 74 
 75 :Entry:  delete_dir:  02/08/84 mdc_$delete_dir
 76 
 77 
 78 Function:  This entry point is used to delete a master directory.
 79 
 80 
 81 Syntax:
 82 declare mdc_$delete_dir entry (char(*), char(*), fixed bin(35));
 83 call mdc_$delete_dir (dir_name, entryname, code);
 84 
 85 
 86 Arguments:
 87 dir_name
 88    is the pathname of the containing directory.  (Input)
 89 entryname
 90    is the entryname of the subdirectory.  (Input)
 91 code
 92    is a standard status code.  (Output)
 93 
 94 
 95 :Entry:  pvname_info:  02/08/84 mdc_$pvname_info
 96 
 97 
 98 Function:  This entry point gets various kinds of information about a
 99 specified storage-system physical volume.
100 
101 
102 Syntax:
103 declare mdc_$pvname_info entry (char (*), bit (36) aligned, char (*),
104      bit (36) aligned, fixed bin, fixed bin (35));
105 call mdc_$pvname_info (pvname, pvid, lvname, lvid, device_type, code);
106 
107 
108 Arguments:
109 pvname
110    is the name of the physical volume about which information is to be
111    returned.  (Input)
112 pvid
113    is the physical volume id of the specified volume.  It can be used
114    as a parameter to ring-zero volume and partition interfaces.
115    (Output)
116 lvname
117    is the name of the logical volume to which the physical volume
118    belongs.  (Output)
119 lvid
120    is the logical volume id of the logical volume to which the physical
121    volume belongs.  (Output)
122 
123 
124 device_type
125    is a number indicating what type of device the specified physical
126    volume is mounted on.  The names and characteristics of these
127    devices are listed in various arrays declared in the include file
128    fs_dev_types.incl.pl1.  (Output)
129 code
130    is a standard system-status code.  It is nonzero if the information
131    about the volume cannot be obtained or if the volume does not exist.
132    (Output)
133 
134 
135 :Entry:  set_mdir_account:  02/08/84 mdc_$set_mdir_account
136 
137 
138 Function:  This entry point is used to set the quota account of a
139 master directory.
140 
141 
142 Syntax:
143 declare mdc_$set_mdir_account entry (char(*), char(*), char(*),
144      fixed bin(35));
145 call mdc_$set_mdir_account (dir_name, entryname, account, code);
146 
147 
148 Arguments:
149 dir_name
150    is the pathname of the containing directory.  (Input)
151 entryname
152    is the entryname of the subdirectory.  (Input)
153 account
154    is the name of the new quota account.  The directory quota is
155    returned to the old account and redrawn from this new account.
156 code
157    is a standard system status code.  (Output)
158 
159 
160 :Entry:  set_mdir_owner:  02/08/84 mdc_$set_mdir_owner
161 
162 
163 Function:  This entry point is used to set the owner name of a master
164 directory.
165 
166 
167 Syntax:
168 declare mdc_$set_mdir_owner entry (char(*), char(*), char(*),
169      fixed bin(35));
170 call mdc_$set_mdir_owner (dir_name, entryname, owner, code);
171 
172 
173 Arguments:
174 dir_name
175    is the pathname of the containing directory.  (Input)
176 entryname
177    is the entryname of the subdirectory.  (Input)
178 owner
179    is the new owner name of the master directory, in the form
180    Person_id.Project_id.tag.  (Input)
181 code
182    is a standard system status code.  (Output)
183 
184 
185 :Entry:  set_mdir_quota:  02/08/84 mdc_$set_mdir_quota
186 
187 
188 Function:  This entry point is used to set the quota on a master
189 directory.
190 
191 
192 Syntax:
193 declare mdc_$set_mdir_quota entry (char(*), char(*), bit(1) aligned,
194      fixed bin, fixed bin(35));
195 call mdc_$set_mdir_quota (dir_name, entryname, sw, quota, code);
196 
197 
198 Arguments:
199 dir_name
200    is the pathname of the containing directory.  (Input)
201 entryname
202    is the entryname of the subdirectory.  (Input)
203 sw
204    is a switch indicating the kind of quota change.  (Input)
205    "0"b sets the directory quota to the quota parameter.
206    "1"b algebraically adds the quota parameter to the current directory
207         quota.
208 quota
209    is the quota to be placed on the new directory.  (Input)
210 code
211    is a standard system status code.  (Output)
212 
213 
214 :Entry:  set_volume_quota:  02/08/84 mdc_$set_volume_quota
215 
216 
217 Function:  This entry point is used to set the volume quota for a quota
218 account on a logical volume.
219 
220 
221 Syntax:
222 declare mdc_$set_volume_quota entry (char(*), char(*), bit(1) aligned,
223      fixed bin, fixed bin(35));
224 call mdc_$set_volume_quota (volume, account, sw, quota, code);
225 
226 
227 Arguments:
228 volume
229    is the name of the logical volume that is to contain segments
230    created in the new directory.  (Input)
231 account
232    is the name of the quota account in the form
233    Person_id.Project_id.tag.  The quota account name may contain stars.
234    (Input)
235 sw
236    is a switch indicating the kind of quota change.  (Input)
237    "0"b sets the directory quota to the quota parameter.
238    "1"b algebraically adds the quota parameter to the current directory
239         quota.
240 
241 
242 quota
243    is the quota to be placed on the new directory.  (Input)
244 code
245    is a standard system status code.  (Output)