@GetACL

Retrieves the ACL of the database with the OSPATH OSPATH1 or DBHANDLE DBHANDLE1 and returns it split into TEXTLIST USERNAMES, NUMBERLIST USERLEVELS, TEXTLIST USERPRIVILEGES and TEXTLIST PRIVILEGESNAMES.

TESTLIST USERNAMES:
The ACL name entries.

NUMBERLIST USERLEVELS:
The corresponding ACL level.

6=(Manager)   Manager
5=(Developer)   Developer
4=(Editor)   Editor
3=(Author)   Author
2=(Reader)   Reader
1=(Depositor)   Depositor
0=(No Access)   No Access

TEXTLIST USERPRIVILEGES:
The user’s privileges and ACL flags. The individual privileges and ACL flags are separated by commas.
The first 5 ACL privileges are reserved for pre-V3-Notes databases.
Although these privileges can still be queried here and can also be set using the Engine, they should no longer be used (legacy support only!).

Roles/Privileges:
1-5   pre V3 privileges
6-80 >V3 roles

ACL-Flags:
ACC Author can create new documents
CPA Create personal agent allowed
CPF Create personal folder/view allowed
CD Can delete (on a level >= Author)
CF Create Folder allowed
CLS Create Lotus Script allowed
ASRV Admin-Server entry
SRV Server entry
PRS Personen entry
GRP Gruppen entry
RPD Read public documents
WPD Write public documents
MDA The user cannot register monitors for this database
NRC The user can neither copy nor replicate this database
ARA The administration server can modify Reader or Author fields

TEXTLIST PRIVILEGESNAMES:
The names of the privileges.

NUMBER FLAGS:
1   Enforce a consistent ACL across all replicas.

Return:
In case of an error, the @Function returns @ERROR; otherwise, it returns TRUE.

Example: @GetACL(OSPATH1;USERNAMES;USERLEVELS;USERPRIVILEGES;PRIVILEGESNAMES)

OSPATH1:="LOAPI.NSF";
@GetACL(OSPATH1;USERNAMES;USERLEVELS;USERPRIVILEGES;PRIVILEGESNAMES);

Returns (usually) the ACL of the API program control in the variables USERNAMES, USERLEVELS, USERPRIVILEGES and PRIVILEGESNAMES.

Note : This text was machine-translated and may contain inaccuracies.