Creating a Role Using the Command Line Interface

Use XML to create a role.

You can include the XML parameters in the xml file, or you can specify them on the command line when they frequently change. For more information on command line parameters and XML elements, see Command Line - Syntax.


  1. Run the qlogin command to log on to the CommServe computer.
  2. Download the create_role_template.xml file to the computer where you will run the command.
  3. To define the parameter values, do either of the following
    • Open the create_role_template.xml file and update the XML parameters.
    • Type the parameters on the command line using the following format: -parameter_name parameter_value.

    For information on supported parameters, see XML Parameters for Roles.

  4. On the command line, go to software_installation_directory/Base and type the following command and include any parameters not defined in the .xml file:

    qoperation execute -af create_role_template.xml

  5. Run the qlogout command to log off the CommServe computer.


The following command creates a new role that includes all of the permissions in the Analytics category. In this example, the parameters are listed on the command line:

qoperation execute -af create_role_template.xml -roleName consultants -categoriesPermissionOperationType ADD -categoryName Analytics

Last modified: 1/8/2018 9:07:51 PM