MKS Implementer 2006 Administration Guide

Chapter 6: Third Party Integrations
348
Member (ACLMBR)
If you specified an ACL directive source file name, specify the file member to read.
IMPORTANT Due to OS/400 limitations, the short member name generated by
Implementer is not a valid ACLMBR name due to the tilde (~) character. Thus, if you
are using the #SHORTNM substitution variable for the ACLMBR parameter in a
special command in check out or promotion, each tilde character in the substituted
value automatically translates to the number sign (#) character.
For example, you specify the long file name databasefile.nsf, Implementer
generates the name database~1, and creates the directive source member name
database#1.
Request number (RQSNBR)
If you specified *COMMENT in the ACL directive source (ACLDIR) parameter, specify the
Implementer request number that contains the request comments.
Setting ACLs in Check Out
The IEXCCKOCMD and ISETDOMACL commands are used together to set a Domino ACL
for development use when checking out to a *TST environment. After defining the
ISETDOMACL command within the IEXCCKOCMD command as an environment level
special command for the target environment, the command processes for all appropriate
objects checked out to the environment. If a special command fails during check out, the
process halts and the error displays. After correcting the problem you can retry the check out.
This method requires defining the ACL directives in an existing source physical file.
NOTE
When defining the IEXCCKOCMD command to run the ISETDOMACL
command, to avoid possible errors in the browser if an object does not exist in the
target directory, set the ACTION parameter value to *CHANGE (rather than
*CREATE). This issues the command for only items that are checked out for
change.
The ISETDOMACL command is applicable for setting an ACL on the iSeries
server; however, do no use it in check out if the development (*TST) environment
is on a local PC, for example, \QNTC\DEVDEMO\HOME\TST1.
IEXCCKOCMD and ISETDOMACL Example
In the following example, the special command is set to run after a successful check out.