(PYVMS LOGO) Python on OpenVMS

(go to: table of contents, index, list of vms_lib, prev: DELETE_FILE, next: DELETE_SYMBOL)


DELETE_LOGICAL - Delete Logical Name


Format:
    vms_lib.delete_logical (logical-name [,table-name])
Returns:

None

Arguments:

logical-name
The logical name to be deleted.
table-name
Logical name table from which the logical name is to be deleted. This parameter is optional. The default value is "LNM$PROCESS" which indicates the process logical name table.
Examples:
$ DEFINE /PROCESS LNM_PROCESS "process"
$ DEFINE /PROCESS LNM_DEFAULT "default"
$ DEFINE /PROCESS LNM_NONE    "none"
$ DEFINE /JOB     LNM_JOB     "job"
$ SHOW LOGICAL LNM_*

(LNM$PROCESS_TABLE)

  "LNM_DEFAULT" = "default"
  "LNM_NONE" = "none"
  "LNM_PROCESS" = "process"

(LNM$JOB_8152D800)

  "LNM_JOB" = "job"

(LNM$GROUP_010040)

(LNM$SYSTEM_TABLE)

(DECW$LOGICAL_NAMES)
$

>>> import vms_lib

>>> vms_lib.delete_logical ('LNM_PROCESS', 'LNM$PROCESS')
>>> vms_lib.delete_logical ('LNM_JOB',     'LNM$JOB')
>>> vms_lib.delete_logical ('LNM_NONE',    None)
>>> vms_lib.delete_logical ('LNM_DEFAULT')

$ SHOW LOGICAL LNM_*

(LNM$PROCESS_TABLE)

(LNM$JOB_8152D800)

(LNM$GROUP_010040)

(LNM$SYSTEM_TABLE)

(DECW$LOGICAL_NAMES)
%SHOW-S-NOTRAN, no translation for logical name LNM_*
$

>>> logical_name = 'S' * 257
>>> vms_lib.delete_logical (logical_name)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (340, '%SYSTEM-F-IVLOGNAM, invalid logical name')
>>>

>>> vms_lib.delete_logical ('NO_LOGICAL')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (444, '%SYSTEM-F-NOLOGNAM, no logical name match')
>>>

>>> vms_lib.delete_logical ('NO_LOGICAL','NO_TABLE')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (444, '%SYSTEM-F-NOLOGNAM, no logical name match')
>>>

>>> vms_lib.delete_logical ()
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: function requires at least 1 argument; 0 given
>>>

>>> vms_lib.delete_logical (1)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, int found
>>>

>>> s= 65536*'*'
>>> vms_lib.delete_logical (s)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
ValueError: argument 1: logical-name - string size limited to\
 65535 characters
>>>

>>> vms_lib.delete_logical ('X',s)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
ValueError: argument 2: table-name - string size limited to\
 65535 characters
>>>

(go to: table of contents, index, list of vms_lib, prev: DELETE_FILE, next: DELETE_SYMBOL)

01-DEC-1998 ZE.