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 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.
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. |
|
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. |
|
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. |
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:
(CASP Only) Use the Building
Blocks tab
to navigate to the dialogs for creating and modifying the following CASP objects:
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.
(CASP Only) Use the Subnetworks
tab to navigate to the bridge and subnet utilities records.
(CASP Only) Use the Directory
Services tab
to navigate to the LDAP server, context, and dictionary records.
(CASP Only) Use the Profiles
tab to navigate to the API get, API put, client, business
element, bridge, node, and error profile records.
Use the Directory
Organization
tab to navigate to the Namespace records, the following
Metadata objects: XML Documents, Raw Messages, Shared Fields, and XML
External Entities; and XML conversion maps.
(CASP Only) Use the Application
Management
tab to navigate to Access, HTTP proxy, startup, location, and
audit records.
(CASP Only) Use the Connector
tab to navigate to the native connector record and other CASP
Connector-based products that may also be installed at your site.
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.
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:
ERROR
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:
Edit the record that contains the invalid reference, and make the necessary corrections (either delete the reference or create a new reference to a valid record).
Create the non-existent record if you intended to do so or if the record was accidentally deleted.
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.
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.