1 – Acl
Acl[=(ace[,...])]
Specifies one or more ACEs to be modified. When no ACE is
specified, the entire ACL is affected. Separate multiple ACEs
with commas. When you include the Acl qualifier, the specified
ACEs are inserted at the top of the ACL unless you also specify
the After qualifier. You cannot specify the Acl qualifier and the
Acl_File qualifier on the same RMU command line.
The format of an ACE is as follows:
(Identifier=user-id, Access=access_mask)
The user-id must be one of the following types of identifier:
o A user identification code (UIC) in [group-name,member-name]
alphanumeric format
o A user identification code (UIC) in [group-number,member-
number] numeric format
o A general identifier, such as SECRETARIES
o A system-defined identifier, such as DIALUP
o Wildcard characters in [*,*] format
Names are not case sensitive. In addition, the Identifier and
Access keywords can be abbreviated to one character. For example,
the following ACE is valid:
(I=isteward, A=RMU$ALL)
The access_mask can be any of the following:
o One or more of the Oracle RMU privileges listed in the Oracle
Rdb7 Oracle RMU Reference Manual
If more than one privilege is specified, a plus sign (+) must
be placed between the privileges.
o The keyword RMU$ALL
These keywords indicate that you want the user to have all of
the RMU privileges. (This keyword has no effect on system file
privileges.)
o The keyword None
This keyword indicates that you do not want the user
to have any RMU or OpenVMS privileges. If you specify
Acl=(id=username, access=READ+NONE), the specified user will
have no RMU privileges and no READ privileges for the database
files.
2 – Acl File
Acl_File=filename
Specifies a file containing a list of ACEs, with one ACE
specified per line. You can use continuation characters to
continue an ACE on the next line, and you can include commented
lines within the file. Within this file, use the dash (-) as a
continuation character and the exclamation point (!) to indicate
a comment.
You cannot specify the Acl_File qualifier and the Acl qualifier
on the same RMU command line.
3 – After
After=ace
Indicates that all ACEs specified with the Acl qualifier are to
be added after the ACE specified with the After qualifier. By
default, any ACEs added to the ACL are always placed at the top
of the list.
You cannot use this qualifier with the Edit qualifier.
4 – Delete
Delete[=All]
Indicates that the ACEs specified with the Acl qualifier are
to be deleted. If no ACEs are specified with the Acl qualifier,
the entire ACL is deleted. If you specify an ACE that was not
specified with the Acl qualifier, you are notified that the ACE
does not exist, and the delete operation continues.
You cannot use this qualifier with the Edit qualifier.
5 – Edit
Edit
Invokes the ACL editor and allows you to use the Journal,
Keep, Mode, or Recover qualifiers. Oracle RMU ignores any other
qualifiers you specify with the Edit qualifier.
The RMU Set Privilege command with the Edit qualifier only
functions off line. If you attempt it on line, an error message
is generated. This restriction is necessary because the ACL
editor requests exclusive write access to the database.
To use the Edit qualifier, the SYS$SHARE:ACLEDTSHR.EXE image
must be installed at system startup time, or, be installed by
RMONSTART.COM. Contact your system manager if this image is not
installed as needed.
For more information on the ACL editor, see the OpenVMS
documentation set.
6 – Journal
Journal[=file-spec]
Nojournal
Controls whether a journal file is created from the editing
session. By default, a journal file is created if the editing
session ends abnormally.
If you omit the file specification, the journal file has the
same name as the root file and a file type of .tjl. You can use
the Journal qualifier to specify a journal file name that is
different from the default. No wildcard characters are allowed in
the Journal qualifier file-spec parameter.
You must specify the Edit qualifier to use this qualifier.
7 – Keep
Keep[=(Recovery,Journal)]
Determines whether the journal file, the recovery file, or both,
are deleted when the editing session ends. The options are:
o Recovery-Saves the journal file used for restoring the ACL.
o Journal-Saves the journal file for the current editing
session.
You can shorten the Journal and Recover options to J and R,
respectively. If you specify only one option, you can omit the
parentheses.
You must specify the Edit qualifier to use this qualifier. If you
specify the Edit qualifier but do not specify the Keep qualifier,
both the journal file for the current editing session and the
journal file used for restoring the ACL are deleted when the
editing session ends.
8 – Like
Like=source-root-file-spec
Indicates that the ACL of the root file specified with the Like
qualifier is to replace the ACL of the root file specified with
the root-file-spec parameter of the RMU Set Privilege command.
Any existing ACEs are deleted before the root file ACL specified
by the Like qualifier is copied.
You cannot use this qualifier with the Edit qualifier.
9 – Log
Log
Nolog
Directs the RMU Set Privilege command to return both the name of
the root file that has been modified by the command and the ACL
associated with the database. The default of Nolog suppresses
this output.
You cannot use this qualifier with the Edit qualifier.
10 – Mode
Mode=[No]Prompt
Determines whether the ACL editor prompts for field values. By
default, the ACL editor selects prompt mode.
You must specify the Edit qualifier to use this qualifier.
11 – New
New
Indicates that any existing ACE in the ACL of the root file
specified with RMU Set Privilege is to be deleted. To use the
New qualifier, you must specify a new ACL or ACE with the Acl,
Like, or Replace qualifiers.
You cannot use this qualifier with the Edit qualifier.
12 – Recover
Recover[=file-spec]
Norecover
Specifies the name of the journal file to be used in a recovery
operation. If the file specification is omitted with the Recover
qualifier, the journal is assumed to have the same name as the
root file and a file type of .tjl. No wildcard characters are
allowed with the Recover qualifier file-spec parameter.
The default is the Norecover qualifier, where no recovery is
attempted when you invoke the ACL editor to edit a root file ACL.
You must specify Edit to use this qualifier.
13 – Replace
Replace=(ace[,...])
Deletes the ACEs specified with the Acl qualifier and replaces
them with those specified with the Replace qualifier. Any ACEs
specified with the Acl qualifier must exist and must be specified
in the order in which they appear in the ACL.
This qualifier cannot be used with the Edit qualifier.