Copyright Digital Equipment Corp. All rights reserved.

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 VSI
   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.