@SetACL

Writes the ACL described by PARAMETERS2-5 to the database identified by DBHANDLE DBHANDLE.
This ACL must always contain at least one entry with ACL-LEVEL=6.
The APIEngine server that writes the ACL must have Manager access to the database to which the ACL is to be written.
If the database is opened locally, that is, without a server name before the NOTESPath of the database, this is always the case.
@SetACL returns either 1 (NUMBER) or an error.

PARAMETER2 (data type TEXT or TEXTLIST):
The ACL name entries.

PARAMETER3 (data type NUMBER or NUMBERLIST):
The corresponding ACL-LEVEL.

PARAMETER4 (data type TEXT or TEXTLIST):
The corresponding privileges
1-80

ACC Author can create new documents
CPA Create Personal Agent allowed
CPF Create Personal Folder/View allowed
CD Can Delete (at a level >= Author)
CF Create Folder allowed
CLS Create LotusScript allowed
ASRV Admin Server entry
SRV Server entry
PRS Person entry
GRP Group entry
RPD Read Public Documents
WPD Write Public Documents

PARAMETER5 (data type TEXT or TEXTLIST):
The privilege names.

At least five privileges must be specified; these are the five V2.0/V2.1-compatible privileges.

FLAGS6 (data type FN):
1   Enforce a consistent ACL across all replicas.–

ACL-LEVEL:
6=Manager
5=Developer
4=Editor
3=Author
2=Depositor
1=Reader
0=No Access

Example:

DBHANDLE:=@OpenDB("TEST.NSF");
PARAMETER2:="Manager":"-Default-";
PARAMETER3:=6:0;
PARAMETER4:="1,2,3,4,5":"";
PARAMETER5:="P1":"P2":"P3":"P4":"P5";

Err:=@SetACL(DBHANDLE;PARAMETER2;PARAMETER3;PARAMETER4;PARAMETER5);

@LogReport(Err);

DBHANDLE:=@CloseDB(dbh1);

An ACL is created with a manager named "Manager" and the first five privileges, as well as with Default access set to No Access.

The privileges have the following names:
Privilege 1 = "P1"
Privilege 2 = "P2"
Privilege 3 = "P3"
Privilege 4 = "P4"
Privilege 5 = "P5"

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