aclgetentry


>>-aclgetentry--variable--stem--+-------+----------------------><
                                '-index-'

Function

aclgetentry reads an access control list (ACL) entry from the ACL represented by variable.

Parameters

variable

The name of a REXX variable that contains a token to access an ACL.

stem

The name of a stem variable that contains an ACL entry. STEM.0 contains a count of the number of variables set in the stem. The following variables may be used to access the stem variables. The number in parentheses is the actual value of the variable:

Variable	Description
ACL_ENTRY_TYPE (1)	Indicates the type of ACL entry: ACL_ENTRY_USER (1) (User ACL) ACL_ENTRY_GROUP (2) (Group ACL)
ACL_ID (2)	The numeric id, uid or gid of the entry
ACL_READ (3)	Indicates read access (1 = yes, 0 = no)
ACL_WRITE (4)	Indicates write access (1 = yes, 0 = no)
ACL_EXECUTE (5)	Indicates execute or search access (1 = yes, 0 = no)
ACL_DELETE (6)	Indicates that the ACL entry is deleted (1 = yes, 0 = no)

index

Specifies the relative ACL entry to access. The first entry is 1.

Usage notes

An entry is identified by index, if index is specified. Otherwise, the entry is identified by the type and ID specified in stem.
If the entry does not exist, the service will return retval= -1 and errno=enoent.

Example

To read an ACL entry, this example assumes the user has set the appropriate stem variable before the call:

 "aclgetentry tokenvar acl."

For a complete example that uses several of the ACL services to list ACLs, see List the ACL entries for a file.

For more information about access control lists, see Using access control lists (ACLs) in z/OS UNIX System Services Planning.