(go to: table of contents, index, list of vms_sys, prev: READEF, next: REM_IDENT)
Format:
None
Arguments:
REM_HOLDER - Remove Holder Record from Rights Database
Deletes the specified holder record from the target identifier's list
of holders.
28-SEP-1998 ZE.
vms_sys.rem_holder (id, holder)
Returns:
Examples:
The Python function only accepts a tuple of 2 integers - not a quadword
represented by a Python long integer. For OpenVMS V6.1 the first element is the
holder's UIC identifier, the second element must be 0. Check the system services
reference manual for your version of OpenVMS.
UAF> add /identifier ID_1 /attributes=resource
%UAF-I-RDBADDMSG, identifier ID_1 value %X80010011 added to rights \
database
UAF> add /identifier ID_2 /attributes=(dynamic,resource)
%UAF-I-RDBADDMSG, identifier ID_2 value %X80010012 added to rights \
database
UAF> grant /identifier ID_1 SYSTEM /attributes=resource
UAF> grant /identifier ID_1 ZESSIN /attributes=resource
%UAF-I-GRANTMSG, identifier ID_1 granted to SYSTEM
UAF> grant /identifier ID_2 SYSTEM /attributes=(dynamic)
UAF> show /identifier /full ID_1
Name Value Attributes
ID_1 %X80010011 RESOURCE
Holder Attributes
SYSTEM RESOURCE
ZESSIN RESOURCE
UAF> show /identifier /full ID_2
Name Value Attributes
ID_2 %X80010012 RESOURCE DYNAMIC
Holder Attributes
SYSTEM DYNAMIC
UAF>
>>> import vms_sys
>>> import vms_kgbdef
>>> id_1 = 0x80010011 # identifier ID_1
>>> id_2 = 0x80010012 # identifier ID_1
>>> uic = 0x10004 # UIC [1,4] (user SYSTEM)
>>> vms_sys.rem_holder (id_1, (uic,0))
UAF> show /identifier /full ID_1
Name Value Attributes
ID_1 %X80010011 RESOURCE
Holder Attributes
ZESSIN RESOURCE
UAF>
>>> id_x = 0x80012345 # ungranted identifier
>>> vms_sys.rem_holder (id_x, (uic,0))
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_sys.error: (8684, '%SYSTEM-F-NOSUCHID, unknown rights identifier')
>>>
>>> uic_x = 0x30003 # UIC without name
>>> vms_sys.rem_holder (id_1, (uic_x,0))
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_sys.error: (8684, '%SYSTEM-F-NOSUCHID, unknown rights identifier')
>>>
>>> vms_sys.rem_holder (id_1, 'X')
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 2: holder - must be a tuple of 2 integers
>>>
>>> vms_sys.rem_holder (id_1, (0,'X'))
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 2: holder - tuple-element:1 is not an integer
>>>
>>> vms_sys.rem_holder (id_1, ('X',0))
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 2: holder - tuple-element:0 is not an integer
>>>
(go to: table of contents,
index,
list of vms_sys,
prev: READEF,
next: REM_IDENT)