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

    The Parse Access Encoded Name String routine parses and
    translates a string of access names into a mask for a particular
    ownership category.

    Format

      LIB$PARSE_ACCESS_CODE  access-string, [access-names,]

                             ownership-category, access-mask,

                             [end-position]

1 - Returns

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

2 - Arguments

 access-string

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

    The address of a character-string descriptor pointing to a string
    of access names. Each access name is abbreviated to one letter.
    An example of a valid access string is RWE. Access names are
    specific to each of the different object classes. See the OpenVMS
    Guide to System Security for a complete list of all valid access
    names.

 access-names

    OpenVMS usage:access_names
    type:         array [0..31] of quadword string descriptor
    access:       read only
    mechanism:    by reference

    The address of the access name table for the associated object
    class. For example, it is the value returned by the LIB$GET_
    ACCNAM routine in the accnam longword. This parameter is optional
    and defaults to the access name table for the FILE object class.

 ownership-category

    OpenVMS usage:mask_word
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference

    The address of a word that indicates the ownership category the
    access names refer to:

    Ownership
    Category       Mask Value

    System         0000000000001111
    Owner          0000000011110000
    Group          0000111100000000
    World          1111000000000000

 access-mask

    OpenVMS usage:mask_word
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference

    The address of a word into which this routine writes the access
    mask. In this mask, a set bit means the access was requested for
    the specified ownership. Note that this is the opposite of the
    standard protection format where a set bit means no access.

 end-position

    OpenVMS usage:word_signed
    type:         word (signed)
    access:       write only
    mechanism:    by reference

    The number of characters from access-string processed by
    LIB$PARSE_ACCESS_CODE. In the case of an error in parsing the
    access string, the offset to the offending location is returned.