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 value

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

   Bit    Value                   Description

   0      Reserved to VSI
   1      Reserved to VSI
   2      Reserved to VSI
   3      Reserved to VSI
   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.