(PYVMS LOGO) Python on OpenVMS

(go to: table of contents, index, list of vms_sys, prev: READEF, next: REM_IDENT)


REM_HOLDER - Remove Holder Record from Rights Database


Deletes the specified holder record from the target identifier's list of holders.

Format:

    vms_sys.rem_holder (id, holder)
Returns:

None

Arguments:

id
Binary value of target identifier to be removed.
holder
Identifier of holder to be removed.
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.
Examples:
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)

28-SEP-1998 ZE.