(PYVMS LOGO) Python on OpenVMS

(go to: table of contents, index, list of vms_lib, prev: GET_ACCNAM, next: GET_COMMAND)


GET_ACCNAM_BY_CONTEXT - Get Access Name Table for Protected Object Class


Format:
    accnam = vms_lib.get_accnam_by_context (contxt)
Returns:
accnam
Object of type 'vmsobj__access_names'.
Arguments:
contxt
context value that is returned by vms_sys.get_security() or vms_sys.set_security()
Examples:
----- establish a context first

>>> import vms_sys
>>>
>>> contxt = 0
>>> flags  = 0
>>> itmlst = ( ('OSS$_OWNER',0),)
>>>
>>> dict   = vms_sys.get_security ('FILE', 'DCC_VMS.COM', None, \
...                                flags, itmlst, contxt)
>>>
>>> status = dict.get ('status')
>>> print vms_sys.getmsg (status) [0]
%SYSTEM-W-NOENTRY, access control entry not found
>>>
>>> contxt = dict.get ('contxt')
>>> print contxt
2147235920
>>>


----- get access_names for this context

>>> import vms_lib
>>>
>>> accnam = vms_lib.get_accnam_by_context (contxt)
>>> print accnam
<vmsobj__access_names, ACCESS_NAMES at 0x0029041c>
>>>


----- release the context

>>> import vms_ossdef
>>> contxt = dict.get ('contxt')
>>> flags  = vms_ossdef.OSS_M_RELCTX
>>>
>>> dict   = vms_sys.get_security (None, None, None, flags, \
...                                None, contxt)
>>>
>>> status = dict.get ('status')
>>> print vms_sys.getmsg (status) [0]
%SYSTEM-S-NORMAL, normal successful completion
>>> contxt = dict.get ('contxt')
>>> print contxt
0        <-- context has been released
>>>


----- some error examples

>>> accnam = vms_lib.get_accnam_by_context (0)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (9436, '%SYSTEM-F-NOCLASS, no matching object class\
 was located')
>>>

>>> accnam = vms_lib.get_accnam_by_context (55)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (8996, '%SYSTEM-F-BADCONTEXT, invalid or corrupted\
 context encountered')
>>>

>>> accnam = vms_lib.get_accnam_by_context ('X')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: illegal argument type for built-in operation
>>>

(go to: table of contents, index, list of vms_lib, prev: GET_ACCNAM, next: GET_COMMAND)

19-JUL-1999 ZE.