 |
HP OpenVMS DCL Dictionary
F$PRIVILEGE
Returns a string value of either TRUE or FALSE, depending on whether
your current process privileges match those specified in the argument.
You can specify either the positive or negative version of a privilege.
Format
F$PRIVILEGE (priv-states)
Return Value
A character string containing the value TRUE or FALSE. The F$PRIVILEGE
function returns the string FALSE if any one of the privileges in the
priv-states argument list is false.
Arguments
priv-states
Specifies a character string containing a privilege, or a list of
privileges separated by commas (,). For a list of process privileges,
see the HP OpenVMS Guide to System Security. Specify any one of the process privileges except
[NO]ALL.
Description
Use the F$PRIVILEGE function to identify your current process
privileges.
If "NO" precedes the privilege, the privilege must be
disabled in order for the function to return a value of TRUE. The
F$PRIVILEGE function checks each of the keywords in the specified list,
and if the result for any one is false, the string FALSE is returned.
Example
|
$ PROCPRIV = F$PRIVILEGE("OPER,GROUP,TMPMBX,NONETMBX")
$ SHOW SYMBOL PROCPRIV
PROCPRIV = "FALSE"
|
The F$PRIVILEGE function is used to test whether the process has OPER,
GROUP, and TMPMBX privileges and if you do not have NETMBX privileges.
The process in this example has OPER (operator), GROUP, TMPMBX
(temporary mailbox), and NETMBX (network mailbox) privileges.
Therefore, a value of FALSE is returned because the process has NETMBX
privilege, but NONETMBX was specified in the priv-states list. Although
the Boolean result for the other three keywords is true, the entire
expression is declared false because the result for NONETMBX was false.
|
