Python on OpenVMS
(go to: table of contents,
index,
list of vms_lib,
prev: GET_MAXIMUM_DATE_LENGTH,
next: GET_USERS_LANGUAGE)
GET_SYMBOL - Get Value of CLI Symbol
Format:
resultant_string, table_type = vms_lib.get_symbol (symbol)
Returns:
- resultant_string
- contents of 'symbol'
- table-type-indicator
- 1 = LIB$K_CLI_LOCAL_SYM - Local symbol table
2 = LIB$K_CLI_GLOBAL_SYM - Global symbol table
Arguments:
- symbol
- name of the symbol
Examples:
$ SYM_LOCAL = "LOCAL_SYMBOL"
$ SYM_GLOBAL == "GLOBAL_SYMBOL"
>>> import vms_lib
>>> LIB_K_CLI_LOCAL_SYM = 1
>>> LIB_K_CLI_GLOBAL_SYM = 2
>>> print vms_lib.get_symbol ('$STATUS')
('%X00000001', 2)
>>>
>>> symbol, table = vms_lib.get_symbol ('$STATUS')
>>> print symbol, '-', table
%X00000001 - 2
>>>
>>> t = vms_lib.get_symbol ('$STATUS')
>>> t
('%X00000001', 2)
>>> type(t)
<type 'tuple'>
>>> print vms_lib.get_symbol ('$STATUS')[0]
%X00000001
>>>
>>> vms_lib.get_symbol ('SYM_LOCAL')
('LOCAL_SYMBOL', 1)
>>> vms_lib.get_symbol ('SYM_GLOBAL')
('GLOBAL_SYMBOL', 2)
>>>
>>> symbol = 'S'
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_lib.error: (1409892, '%LIB-F-NOSUCHSYM, no such symbol')
>>>
>>> symbol = 'S' * 257
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_lib.error: (1409932, '%LIB-F-INVSYMNAM, invalid symbol name')
>>>
>>> symbol = 'S' * 65536
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
File "<stdin>", line 1, in ?
ValueError: argument 1: symbol - string size limited to\
65535 characters
>>>
>>> vms_lib.get_symbol ()
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: function requires exactly 1 argument; 0 given
>>> vms_lib.get_symbol (1)
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, int found
>>> # that means 'string' ------!!!!!!!!!
>>> vms_lib.get_symbol (None)
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, None found
>>>
(go to: table of contents,
index,
list of vms_lib,
prev: GET_MAXIMUM_DATE_LENGTH,
next: GET_USERS_LANGUAGE)
20-DEC-1998 ZE.