VMS Help  —  LBR Routines, LBR$OPEN  Arguments
 library_index

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Library control index returned by the LBR$INI_CONTROL routine.
    The library_index argument is the address of a longword
    containing the index.

 fns

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor
    File specification of the library. The fns argument is
    the address of a string descriptor pointing to the file
    specification. Unless the OpenVMS RMS NAM block address was
    previously supplied in the LBR$INI_CONTROL routine and contained
    a file specification, this argument must be included. Otherwise,
    the Librarian returns an error (LBR$_NOFILNAM).

 create_options

    OpenVMS usage:vector_longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Library characteristics. The create_options argument is
    the address of an array of 20 longwords that define the
    characteristics of the library you are creating. If you are
    creating a library with LBR$C_CREATE, you must include the
    create_options argument. The following table shows the entries
    that the array must contain. Each programming language provides
    an appropriate mechanism for accessing the listed symbols.

    Offset
    in
    Longwords Symbolic Name        Contents

    0         CRE$L_TYPE           Library type:
              LBR$C_TYP_UNK (0)    Unknown/unspecified
              LBR$C_TYP_OBJ (1)    VAX object
              LBR$C_TYP_MLB (2)    Macro
              LBR$C_TYP_HLP (3)    Help
              LBR$C_TYP_TXT (4)    Text
              LBR$C_TYP_SHSTB (5)  VAX shareable image
              LBR$C_TYP_NCS (6)    NCS
              LBR$C_TYP_EOBJ (7)   Alpha object
              LBR$C_TYP_ESHSTB     Alpha shareable image
              (8)
              (9-127)              Reserved by HP
              LBR$C_TYP_USRLW      User library types - low end of
              (128)                range
              LBR$C_TYP_USRHI      User library types - high end of
              (255)                range
    1         CRE$L_KEYLEN         Maximum length of ASCII keys or,
                                   if 0, indicates 32-bit unsigned
                                   keys (binary keys)
    2         CRE$L_ALLOC          Initial library file allocation
    3         CRE$L_IDXMAX         Number of library indexes (maximum
                                   of eight)
    4         CRE$L_UHDMAX         Number of additional bytes to
                                   reserve in module header
    5         CRE$L_ENTALL         Number of index entries to
                                   preallocate
    6         CRE$L_LUHMAX         Maximum number of library update
                                   history records to maintain
    7         CRE$L_VERTYP         Format of library to create:
              CRE$C_VMSV2          VMS Version 2.0
              CRE$C_VMSV3          VMS Version 3.0
    8         CRE$L_IDXOPT         Index key casing option:
              CRE$C_HLPCASING      Treat character case as it is for
                                   help libraries
              CRE$C_OBJCASING      Treat character case as it is for
                                   object libraries
              CRE$C_MACTXTCAS      Treat character case as it is for
                                   macro and text libraries
    9-19                           Reserved by HP

    The input of uppercase and lowercase characters is treated
    differently for help, object, macro, and text libraries. For
    details, see the HP OpenVMS Command Definition, Librarian, and
    Message Utilities Manual.

 dns

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor
    Default file specification. The dns argument is the address
    of the string descriptor that points to the default file
    specification. See the OpenVMS Record Management Services
    Reference Manual for details about how defaults are processed.

 rlfna

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Related file name. The rlfna argument is the address of an
    RMS NAM block pointing to the related file name. You must
    specify rlfna for related file name processing to occur. If a
    related file name is specified, only the file name, type, and
    version fields of the NAM block are used for related name block
    processing. The device and directory fields are not used. See the
    OpenVMS Record Management Services Reference Manual for details
    on processing related file names.

 rns

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor
    Resultant file specification returned. The rns argument is the
    address of a string descriptor pointing to a buffer that is to
    receive the resultant file specification string. If an error
    occurs during an attempt to open the library, the expanded name
    string is returned instead.

 rnslen

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference
    Length of the resultant or expanded file name. The rnslen
    argument is the address of a longword receiving the length
    of the resultant file specification string (or the length of
    the expanded name string if there was an error in opening the
    library).
Close Help