(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_lib, prev: FIND_FILE_END, next: FORMAT_DATE_TIME)


FIND_IMAGE_SYMBOL - Find Universal Symbol in Shareable Image File


Any signals from LIB$FIND_IMAGE_SYMBOL are trapped by an internal condition handler and then are converted to a condition value which is returned in 'status'. An error does _not_ raise a Python exception - you _must_ check 'status'!

Please note, that there is currently (23-MAY-1998) no way to CALL a routine in a shareable image that has been mapped by LIB$FIND_IMAGE_SYMBOL.

Format:

    symbol_value, status = \
        vms_lib.find_image_symbol (filename, symbol [,image_name])
Returns:
symbol_value
the value that LIB$FIND_IMAGE_SYMBOL has located
status
condition value that is returned from LIB$FIND_IMAGE_SYMBOL
Arguments:
filename
only the name of a file specification
no device, type, version
symbol
name of the symbol to look up
image_name
remaining parts of the file specification
default = 'SYS$SHARE:.EXE'
Examples:
>>> import vms_lib

>>> symbol_value, status = vms_lib.find_image_symbol (
...     'EDTSHR', 'EDT$_NONSTDFIL')
>>> print symbol_value, status
8749395 1
>>>

$ SEARCH SYS$MESSAGE:*.EXE NONSTDFIL /WINDOW=0
SYS$COMMON:[SYSMSG]SHRIMGMSG.EXE;1
$! --> these messages are shared by several facilities
$ SET MESSAGE SYS$COMMON:[SYSMSG]SHRIMGMSG.EXE;1
$ WRITE SYS$OUTPUT F$MESSAGE(8749395)
%EDT-I-NONSTDFIL, Input file does not have standard text file format
$

@@ no more tests done, yet (01-MAR-1998) @@
>>>

(go to: table of contents, index, list of vms_lib, prev: FIND_FILE_END, next: FORMAT_DATE_TIME)

30-SEP-1998 ZE.