Set Commands

The dicfg set commands set information about the DiveLine server configuration and resources, such as the server authentication type and security level, user password requirements, default and object ACL settings, and user and group settings. The sub-commands of the set command use one of the following syntax structures:

  • The sub-command is set directly and supports one value:

    dicfg set <sub-command name> <value>

  • The sub-command is set directly and supports one or more keyword-value pairs:

    dicfg set <sub-command name> -<keyword> <value>

  • The sub-command sets a Boolean value with the set boolean command:

    dicfg set boolean -name <sub-command name> -value <TRUE | FALSE>

  • The sub-command sets an integer value with the set integer command: 

    dicfg set integer -name <sub-command name> -value <integer>

  • The sub-command sets a string value with the set string command: 

    dicfg set string -name <sub-command name> -value <string>

The dicfg set command has the following sub-commands. Click a command name to display a description, including any additional command options.

Sample set commands:

dicfg set default_acl -object hr -user bob -access r

dicfg set user -user bob -homedir /home/$USER

 

dicfg -dataroot c:\di\solution\dl-dataroot set acl -object /local_data/demo_drs.mdl -user test -append -limits "Product

Family(\"Butter\",\"Cheese\",\"Cream\",\"Egg\",\"Milk\",\"Yogurt")"

NOTE: You must use escaped quotes around the dimension values, as well as quotes around the whole limit string, when multiple values separated by commas are included in the same dimension value block, as in the example. However, if only one value is included, it can be entered as: -limits "<name>(<value>)".

 

dicfg set default_acl -object hr -user bob -limits "Hospital(Paoli,Powers)"

dicfg set default_acl -object /demo_drs.mdl -user "test" -limits "Product Family(Butter)"

 

dicfg set user -user Larry -licensing ProDiver,DivePort

dicfg set user -user Doug -licensing Developer

dicfg set user -user bob -homedir /home/$USER -licensing Developer -admin_flag TRUE

dicfg set user -user bob -encrypt_password "$.....="

dicfg set string -name "welcome_message" -value "New text"

dicfg set string -name "message_of_the_day" -value "New text"

 

If the subadmin_flag option is set to TRUE, non-administrative users can perform the following administrative tasks:

  • Change user attributes of users that they own.
  • Add or delete users from groups that they own.
  • Use proxy logon in DivePort and ProDiver.
  • Update permissions on existing ACLs for a user or group that they own.

See also Command Line Utility dicfg.exe.