Skip to main content


Create a new role.


[Actions]   CreateRole:Name=RoleName,Resources=ResourceName(s)[,Additional Properties]


CreateRole defines a role. InterSystems IRIS® data platform creates that role when processing the [Actions] section during a configuration merge.

You can specify any possible role properties in the CreateRole definition. During the merge, InterSystems IRIS runs Security.Roles.Create() to create the role defined by CreateRole. The complete list of role properties is available in the class reference.

Changing This Operation

This operation is designed to be used during a configuration merge. You can change CreateRole by editing the merge file in a text editor (as described in Editing the Active CPF).

For information about creating roles from the Management Portal, see Create Roles.