acldeleteentry


>>-acldeleteentry--variable--stem------------------------------><

Function

acldeleteentry deletes a specific entry in the access control list (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)

Usage notes

The entry to delete is identified by the entry type and ID, and is contained in stem.
If the entry does not exist, the service will return retval= -1 and errno=enoent

Example

To delete the ID in an ACL, this example assumes the user has set the appropriate stem variable before the call:

 "acldeleteentry tokenvar acl." acli_id

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.