The dicfg command can be used in a number of ways to accomplish various tasks. The following examples show some of the more common usage.
Create a group
This command creates the group Sales.
dicfg.exe -remote admin:admin@localhost:2130 add group -group Sales
Create a user and add the new user to an existing group
This command creates the user jsmith and then adds jsmith to the group Sales.
dicfg.exe -remote admin:admin@localhost:2130 add user -user jsmith -groups Sales
Add a user description
This command adds the description of non-administrative sales user to the profile for user jsmith.
dicfg.exe -remote admin:admin@localhost:2130 set user -user jsmith -description "non-administrative sales user"
Specify and apply an ACL for an existing DiveLine user
These commands set a limit on the Salesperson dimension in demo-sales.mdl, for dimension values Arber and Baker for the existing DiveLine user jsmith.
dicfg.exe -remote admin:admin@localhost:2130 set acl -object data\demo-sales.mdl -user jsmith -access rwlm -limits "Salesperson(\"Arber\",\"Baker\")"
OR
dicfg.exe -dataroot c:\di_solution\dl-dataroot set acl -object data\demo-sales.mdl -user jsmith -access rwlm -limits "Salesperson(\"Arber\",\"Baker\")"
Set limits on Dimension values that include commas
This command sets limits on a specified model for a specified user. Note the quotes around the whole limit string and the escaped quotes around the dimension values. The ACL results include DimName="Customer", DimVals={"Foo, Bar", "Baz, Quux"}.
dicfg set acl -object <model> -user <name> -limits "Customer(\"Foo, Bar\",\"Baz, Quux\")"
Output user detail to a text file
This command outputs all DiveLine user information to a tab-delimited text file called myusersdetail.txt. The text file can then be used to build a model or cBase, if desired, for further analysis of DiveLine users.
dicfg.exe -remote admin:admin@localhost:2130 list users_detail > myusersdetail.txt
Check User Stats
This command outputs the contents of the userstat.dat file for port 2130.
dicfg get userstats
The format of the output is tab-delimited text with headers, one column per piece of data stored—reformatted here for clarity.
