(go to: table of contents, index, list of vms_sys, prev: CLREF, next: CRELNT)
vms_sys.crelnm() does _not_ raise an exception when the SYS$CRELNM routine
returns an error. You must check 'status' in the dictionary that is returned.
Format:
It is only put into the dictionary, when SYS$CRELNM returns a success status.
CRELNM - Create Logical Name
Creates a logical name and specifies its equivalence names.
29-NOV-1998 ZE.
dict = vms_sys.crelnm ([attr] ,tabnam ,lognam \
,[acmode] ,[itmlst])
Returns:
Arguments:
Examples:
$ set PROCESS /PRIVILEGE= SYSNAM
>>> import vms_sys
>>> import vms_lnmdef
>>> PSL_C_SUPER = 2
>>>
>>> dict = vms_sys.crelnm (vms_lnmdef.LNM_M_CONFINE, \
... 'LNM$JOB', 'LNM1', PSL_C_SUPER, \
... ( ('LNM$_STRING', 'VALUE'), \
... ('LNM$_TABLE', None )
... )
... )
>>>
>>> for k in dict.keys():
... print k, dict.get(k)
...
LNM$_TABLE LNM$JOB_814E29C0
status 1
>>>
>>> import os
>>> os.system ('show logical /job /full LNM1*')
(LNM$JOB_814E29C0) [kernel] [shareable] [Quota=(928,2048)]
[Protection=(RWCD,RWCD,,)] [Owner=[HOME,ZESSIN]]
"LNM1" [super] = "VALUE"
1 <-- return status from os.system()
>>>
>>> dict = vms_sys.crelnm (vms_lnmdef.LNM_M_CONFINE, \
... 'LNM$GROUP', 'LNM1', PSL_C_SUPER, \
... ( ('LNM$_ATTRIBUTES', vms_lnmdef.LNM_M_CONCEALED), \
... ('LNM$_STRING', 'VALUE1'), \
... ('LNM$_ATTRIBUTES', 0), \
... ('LNM$_STRING', 'VALUE2'), \
... ('LNM$_TABLE', None )
... )
... )
>>>
>>> for k in dict.keys():
... print k, dict.get(k)
...
LNM$_TABLE LNM$GROUP_010040
status 1
>>>
>>> import os
>>> os.system ('show logical /group /full LNM1*')
(LNM$GROUP_010040) [kernel] [shareable,group]
[Protection=(RWCD,R,R,)] [Owner=[HOME,*]]
"LNM1" [super] = "VALUE1" [concealed]
= "VALUE2"
1 <-- return status from os.system()
>>>
>>> dict = vms_sys.crelnm (None, \
... 'LNM$PROCESS', 'LNM1', PSL_C_SUPER, \
... ( ('LNM$_STRING', 'VALUE'), \
... ('LNM$_TABLE', None )
... )
... )
>>>
>>> for k in dict.keys():
... print k, dict.get(k)
...
LNM$_TABLE LNM$PROCESS_TABLE
status 1
>>>
>>> dict = vms_sys.crelnm (None, \
... 'LNM$PROCESS', 'LNM1', PSL_C_SUPER, \
... ( ('LNM$_STRING', 'VALUE'), \
... ('LNM$_TABLE', None )
... )
... )
>>>
>>> status = dict.get('status')
>>> status
1585
>>> vms_sys.getmsg (status)
('%SYSTEM-S-SUPERSEDE, logical name superseded', (0, 0, 0, 0))
>>>
------------------------------
>>> dict = vms_sys.crelnm (None, \
... 'LNM$PROCESS', 'LNM1', PSL_C_SUPER, \
... ( ('LNM$_STRING', 'VALUE'), \
... ('LNM$_ACMODE',3),
... ('LNM$_TABLE', None )
... )
... )
>>>
>>> for k in dict.keys():
... print k, dict.get(k)
...
status 20
>>>
>>> status = dict.get('status')
>>> vms_sys.getmsg (status)
('%SYSTEM-F-BADPARAM, bad parameter value', (0, 0, 0, 0))
>>>
@@ more examples for CRELNM
(go to: table of contents,
index,
list of vms_sys,
prev: CLREF,
next: CRELNT)