Introduction

Use Candle's Directory Administrator to create and modify records in a central LDAP directory, a local LDIF file, or local configuration file. The actions you can perform are grouped according to a series of tabs as described under Tab View below. Which tabs are displayed will depend on the product you are running.

For detailed information on the CASP directory and how it is used in CASP, please consult the CASP Directory Services User's Guide.

For detailed information on the Message Format Editor and how it is used, please consult the PATHWAI Message Format Editor User's Guide.

The Directory Administrator Window

The Directory Administrator window has a menu, toolbar, and a workspace with three window panes: a tab view, a table view, and a text area for any errors that may exist in the directory. You use the mouse to navigate via pop-up menus and other dialogs.

Menu

File

The File menu has options to Open an LDIF file or LDAP directory, switch to another LDAP directory, and Exit.

Edit

The Edit menu has options to Add, Update, Delete, Rename, Cut, Copy, and Paste directory objects. Additionally, the Paste Special option allows you to create a link to a previously copied object.

Tree

The Tree menu enables you to adjust the display of the directory tree with such options as Expand All, Collapse All, and Refresh. Additionally, you can check the validity of a specific object, one branch, or all objects under a specific tab using the Validate Object, Validate Branch, and Validate Tab options, respectively.

Tools

The Tools menu enables you to Find and Replace objects in the directory, Clear Errors from the error log, and define Preferences for current and subsequent sessions. Also there are several frontends for command line utilities: Cobol Importer, Function Library Importer, Schema Importer, Schema Generator, Metadata Exporter, Metadata Importer.

Help

The Help menu General Help option displays general online help, and the About option displays information about this release of the Directory Administrator.

Toolbar

Open LDAP directory or LDIF file.

Refresh directory display, so that updates to the directory appear.

Cut selected object.

Copy selected object.

Paste data previously selected with Cut or Copy.
Note: Paste is grayed out until you select something to cut or copy.

Paste a link to an existing object (that was previously cut or copied); used with business elements and business components only.

Update the selected object.

Rename the selected object.

Delete the selected object.

Clear the contents of the error log.

Validate the selected object.

Validate all objects in the selected tree branch.

Validate all objects in the currently active tab.

Search for an object in the directory.

Search for and replace an object in the directory.

Customize preferences.

Access general help.

Tab View

Various plug-ins may be loaded into the Directory Administrator depending on the product being executed. Each plug-in loads one or more tabs into the tab view.

(Additional CASP Objects)
You may see additional tabs depending upon which CASP optional add-on features you have installed. If you navigated to this help window via General Help, these add-on features are listed in the left window of this Help panel. Click on the object name to navigate to the help for that feature.

The tabs and the objects to which they pertain are grouped as follows:

Business Service, Client, Message Descriptor, and Node. Inside the Business Service folder are sample business service records and the hierarchical folders for business components and business elements respectively.

Table View

Once you select one of the tabs described above, you navigate to the table view for that function. The table view has two windows: Tree and List. When you click on a tab, the tree window displays the object groupings. Once you expand the view by clicking on Tree->Expand All, or by clicking on the plus (+) sign next to each object group, you can see the hierarchical relationship of objects to each other.

The List window displays detailed information about a selected object in the tree, such as the object's attributes and corresponding values.

The table view for Application Management is shown below. The Access record, kzimb2:389, is selected, and its attributes are displayed in the List window.

Errors

The error log displays configuration errors, warnings, and informational messages about the currently active directory. You can minimize or maximize the error log display by using the small up and down arrows in the upper left-hand corner of the splitter bar. Double click to minimize or maximize the error log. When you minimize the error log, the splitter bar moves to the bottom of the window.

The types of messages you may see are:

Examples:

ERROR: Node:cn=UpdateNode5,dc=Node,dc=roma,dc=candle,dc=com references the non-existent Node Profile: cn=nodeprofile0001,dc=NodeProfile,dc=roma,dc=candle,dc=com

To correct this type of error do one of the following:

WARNING: DOMAIN MISSING, The required Domain structure for the "Business Element Profile" PlugIn is missing. "dc=beprofile,dc=roma,dc=candle,dc=com" is missing or invalid

To correct a MISSING DOMAIN error, use either ldapadd or the Configuration Tool to add the appropriate seed file data to the directory. The syntax for ldapadd is described in the CASP Directory Services User's Guide . The seed files and the Configuration Tool are described in the Installation Guide for the platform you are using.

INFORMATIONAL:No Errors or Warnings Detected

You can clear the error log contents at any time using the Tools->Clear Errors menu option.

Mouse

You can enter different dialogs depending upon how you use the mouse in the workspace Tree view. When using the mouse to select the text or icon associated with a CASP object (client, business element, etc.) please note the following:

A Right-click on the object text or icon causes a pop-up menu to display. This menu has options to add, update, rename, and perform other actions on the selected object.

A Click (single-left-click) on the object text or icon refreshes the data in the List window for that object.

A Double-click on the object text or icon invokes the dialog to update that object.

 

PATHWAI, Candle Application Service Pac, CASP Directory Administrator, CASP Connectors, and CASP are trademarks or registered trademarks of Candle Corporation.

  This product is confidential, proprietary software of Candle Corporation that is licensed for your internal use only. Any unauthorized use, duplication, or disclosure is unlawful.

  Copyright © 1998-2004 Candle Corporation. All rights reserved. International rights secured.