VMS Help RTL Routines, LIB$, LIB$FIND_IMAGE_SYMBOL  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Find Universal Symbol in Shareable Image File routine reads
    universal symbols from the shareable image file. This routine
    then dynamically activates a shareable image into the P0 address
    space of a process.

    Format

      LIB$FIND_IMAGE_SYMBOL  filename ,symbol ,symbol-value

                             [,image-name] [,flags]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 filename

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Name of the file for which LIB$FIND_IMAGE_SYMBOL is searching.
    The filename argument is the address of a descriptor pointing to
    this file name string. This argument may contain only the file
    name. File type cannot be indicated. If any file specification
    punctuation characters (:, [, <, ;, .) are present, the error
    SS$_IVLOGNAM is returned.

    You can specify a file specification for the image name with the
    optional image-name argument. If you do not specify image-name,
    a default file specification of SYS$SHARE:.EXE is applied to the
    file name. If the file is not in SYS$SHARE:.EXE, a logical name
    must be used to direct this routine to locate the correct file.
    Only logical names defined in the system logical name table with
    the /EXEC attribute will be considered while the image activator
    is processing a request from an image that was installed with
    privileges. If the calling image was installed with privileges,
    the image being activated and any shareable images or message
    sections it references must be installed as a known image with
    the INSTALL utility. Running an image to which you have only
    Execute (not Read) access results in the same restrictions on
    logical names and shareable images as does running a privileged
    image.

    On VAX systems, the filename descriptor must be class D, S, or Z.

 symbol

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Symbol for which LIB$FIND_IMAGE_SYMBOL is searching in the
    filename file. The symbol argument is the address of a descriptor
    pointing to the symbol name string. The symbol name string can be
    input in uppercase, lowercase, or mixed case letters.

 symbol-value

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference

    Symbol value that LIB$FIND_IMAGE_SYMBOL has located. The symbol-
    value argument is the address of a signed longword integer
    into which LIB$FIND_IMAGE_SYMBOL returns the symbol value. If
    the symbol is relocatable, the starting virtual address of the
    shareable image in memory is added to the symbol value.

 image-name

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Default file specification applied to the image name. The
    optional image-name argument is a string used as the RMS default
    file specification when parsing filename as the primary filename.
    If image-name is not supplied, then a default file specification
    of SYS$SHARE:.EXE is applied to the image name.

    On VAX systems, the image-name descriptor must be class D, S, or
    Z.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Control flags. The flags argument is the address of a longword
    integer that contains the control flags.

    Bit    Value                   Description

    0      Reserved to Compaq
    1      Reserved to Compaq
    2      Reserved to Compaq
    3      Reserved to Compaq
    4      LIB$M_FIS_MIXEDCASE     Causes LIB$FIND_IMAGE_SYMBOL
                                   to look for the symbol without
                                   converting it to uppercase.

    This is an optional argument. If omitted, the default is 0. If
    omitted, or if LIB$M_FIS_MIXEDCASE (bit 4) is 0, LIB$FIND_IMAGE_
    SYMBOL converts the specified symbol to uppercase before it is
    used.