Using the Command Assistant wizard

Before you start:

Use the Command Assistant wizard to create, modify, and delete the following physical runtime components:

Using the wizard, you access the equivalent command line command through a graphical interface:

The wizard consists of a series of panels that lead you through the task you want to complete. The wizard provides help in the banner at the top of each panel, which indicates what actions you should take to complete the panel and continue. Not every optional parameter on each of these commands is supported through the wizard; if you are using some of the more advanced features (for example, setting or modifying LDAP directory access for a broker), you must use the command line interface.

Use the buttons displayed at the bottom of each panel to move Back to the previous panel, to move to the Next panel, to Finish working with the wizard, or to Cancel the current action and end the wizard.

  1. Switch to the Broker Application Development perspective or the Broker Administration perspective.
  2. Select File > New > Other. The New dialog opens.
  3. Select Command Assistant Wizard within the Broker Administration - Getting Started category and click Next. The wizard opens and displays its first panel.
  4. Select the type of component that you want to work with. The wizard checks which components have been installed on this system. You must select a value from the available list; you cannot enter a different value.
  5. Navigate to the Name input field. If the wizard has found any existing components of the type you entered, it shows these in this field. If there are no existing components of this type, or you want to create a new component, enter a new unique name in this field, following the naming restrictions enforced by the product and any naming conventions that are in use in your environment.

    The name of a resource is case insensitive. If a resource of the same name exists, but with characters in a different case to those you typed into this field, the name you typed is overwritten with the existing name.

  6. Navigate to the Action input field and choose the action you want to complete. The wizard prevents you from entering an invalid action for the resource you have entered in the Name field. For example, if you have entered a name that the wizard has not found on this system, you can only choose to create a new resource. If the resource already exists, you can choose to modify it or to delete it.
  7. If you have more than one installation of the product on this system, you must also select the correct value in the Location field. This field displays the home directory of the installation identified by the wizard:
    • If there is only one installation on this system, the directory is displayed and the field is greyed out.
    • If you have specified an existing, uniquely named, resource in the Name field, the wizard displays the location of the installation associated with that resource and the field is greyed out.
    • If more than one installation exists, and could be the target for your request, you must select the correct location in this field,
  8. Click Next. The wizard displays the next panel, the content of which depends on your choices so far.

    Use the help displayed by the wizard on each panel, and navigate through the entry fields, selecting or entering text where appropriate.

    If you enter a password, the characters are displayed as asterisk characters in the entry field to increase security.

  9. When you have completed the entry field on the panel, click Next. The wizard displays a summary that shows you the commands that will be invoked, and any additional actions that will be taken.
  10. Check the information in the summary; if it is correct, click Next.

    If you want to change anything, click Back to return to a previous panel and change your input.

  11. The wizard starts processing your request. If the action succeeds, the wizard displays messages in the summary panel.

    If an action fails, the wizard reports the error in a message dialog. If you know what is causing the error, and can fix it, correct the error and click Yes. The wizard reissues the command.

    If you do not know what is causing the error, or you cannot fix it, click No. The wizard backs out any actions that have already completed and returns your system to its initial state.

  12. Click Finish to end the wizard, or click Next to return to the first page and select another task to complete.
Related concepts
Brokers
Configuration Manager
User Name Server
Related reference
Considering resource naming conventions
Commands
Characters allowed in commands