You can use the ADD, CREATE, DELETE, REMOVE, SET, and SHOW directives with the Naming Context entity. The CREATE and DELETE directives are used to create and delete a Naming Context entity. The SET and SHOW directives are used to set or display Naming Context attributes, respectively. The ADD and REMOVE directives are used to add or remove additional values to a Naming Context characteristic attribute.
1 – ADD
Use the ADD directive to add value(s) to a
Naming Context characteristic attribute.
You can use the ADD directive on the Consumer Access
Point characteristic attribute only. The other attributes
of this entity are read-only.
Syntax:
ADD DSA NAMING CONTEXT <name>
CONSUMER ACCESS POINT {<value>,...}
where <value> is the value you want to add to the
attribute.
2 – CREATE
Use this directive to create a Naming Context entity of the specified name at the specified position in the DIT. Syntax: CREATE DSA NAMING CONTEXT <name> <argument> <value>
2.1 – Arguments
The CREATE directive has an identifier and one argument:
- CONSUMER ACCESS POINT
The identifier specifies the name of this Naming Context
entity. This is in the form of a distinguished name.
The CONSUMER ACCESS POINT argument is optional and
identifies the DSA to which this DSA can supply a copy
of this naming context. Specify this argument in the
following format:
CONSUMER ACCESS POINT <access point>
where <access point> is the access point of the DSA and is
specified as follows:
{[ae title = "<distinguished name of DSA>",
presentation address = '<presentation address>']}
You can specify multiple access points as follows:
{[ae title = "<distinguished name of DSA>",
presentation address = '<presentation address>'] ,
[ae title = "<distinguished name of DSA>",
presentation address = '<presentation address>']}
The AE Title and Presentation Address attributes are both mandatory.
Note that you must specify the AE Title and Presentation
Address in the order shown above.
Specify all valid NSAPs for a consumer DSA. This improves the
network efficiency of this DSA, because it ensures that any
existing connection to that DSA will be re-used. It also ensures
the success of the documented method of implementing replication
for the first time.
Refer to DSA Common_Datatypes for more information
on how to specify an AE Title and a Presentation Address.
2.2 – Errors
The CREATE directive can return the following errors:
REASON: Already Exists
DESCRIPTION: This Naming Context entity already exists.
A Naming Context entity already exists at this
position in the DIT. You cannot create a Naming
Context entity where one already exists.
REASON: Cannot open the database
DESCRIPTION: The DSA cannot open the database as it is being
used by another DSA.
REASON: Invalid Name
DESCRIPTION: The entity name is not a valid directory name.
The name must be in the form of a distinguished
name. The response shows the invalid name component.
REASON: Has Subordinates
DESCRIPTION: The DSA already holds entries or entities
subordinate to the entity being created.
You cannot create a Naming Context entity at
this position in the DIT because the name you
have specifed has subordinates. You must create
entities in a hierarchical order (top down).
REASON: Incomplete Naming Context
DESCRIPTION: A superior Naming Context that is not correctly
terminated by a Subordinate Reference prevents
creation.
The DSA failed to create the Naming Context entity
because a superior master Naming Context entity has
not been terminated. A Naming Context must
be terminated by a Subordinate Reference entity if
want to create a further Naming Context entity
beneath it.
The response shows the name of the incomplete naming
context.
REASON: Incomplete Shadow Naming Context
DESCRIPTION: A superior shadow Naming Context that has not been
correctly terminated by a Subordinate Reference
prevents creation.
The DSA failed to create the Naming Context entity
because a superior shadow Naming Context entity has
not been terminated. A Naming Context must
be terminated by a Subordinate Reference entity if
you want to create a further Naming Context entity
beneath it. Because the superior entity is a shadow,
you need to create a Subordinate Reference entity
on the master DSA for the superior naming context,
and then initiate replication so that this DSA
has a copy of the new Subordinate Reference entity.
The response shows the name of the incomplete naming
context, and the name of the master DSA for that
naming context.
REASON: DIT Root
DESCRIPTION: Cannot create a Naming Context at the root of the
DIT.
You cannot create a Naming Context entity directly
on the root entry of the DIT (/). A Naming Context
entity must have a distinguished name that contains
at least one relative distinguished name.
REASON: Entry Already Exists
DESCRIPTION: The DSA already holds an entry of the same name.
An entry already exists with the same name. You
cannot create a Naming Context entity where a
directory entry already exists. That entry must
already be part of a naming context, so it would
be inappropriate to create one at this point in
the DIT.
REASON: Alias Entry Already Exists
DESCRIPTION: The DSA already holds an alias entry of the
same name.
An alias entry already exists with the same name.
You cannot create a Naming Context entity where
an alias entry already exists. That alias entry
must already be part of a naming context.
REASON: Alias Entry
DESCRIPTION: Alias entry prevents creation.
The identifier you specified for the Naming
Context entity is an alias name, not a
distinguished name. The DSA does not support the
use of alias names when managing entities. Specify
the distinguished name of the entry that is to
be at the top of the new naming context.
The response shows the name of the alias entry.
REASON: Wrong State
DESCRIPTION: The DSA entity is not in the correct state.
The DSA must be in state ON, OFF, ENABLING,
or DISABLING when you create a Naming Context
entity.
The response shows the current state of the DSA.
3 – DELETE
Use this directive to delete a Naming Context entity. Syntax: DELETE DSA NAMING CONTEXT <name>
3.1 – Errors
The DELETE directive can return one of the following errors:
REASON: Has Subordinates
DESCRIPTION: The DSA has entries or entities subordinate
to the entity being deleted.
You cannot remove a Naming Context entity if it
contains directory entries or further entities, such
as Subordinate Reference entities. You must delete
everything beneath the Naming Context entity first.
REASON: Not Empty
DESCRIPTION: You cannot delete a Naming Context that contains
entries.
The Naming Context entity coexists with a directory
entry. You cannot delete the entity until you have
deleted the directory entry.
REASON: Contains Alias
DESCRIPTION: The alias entry with the same name must be deleted
before the Naming Context can be deleted.
The Naming Context entity coexists with an alias
entry. You cannot delete the entity until you
have deleted the alias entry using DXIM, or another
directory application.
REASON: Alias Entry
DESCRIPTION: Alias entry prevents deletion.
The identifier you specified for the Naming Context
entity is an alias name, not a distinguished name.
The DSA does not support the use of alias names
when deleting entities. Specify the distinguished
name of the entry that is at the top of the naming
context. The response indicates the name of the
alias entry.
REASON: Wrong State
DESCRIPTION: The DSA entity is not in the correct state.
The DSA entity must be in state ON or OFF when you
delete a Naming Context entity. If the DSA is in
any other state, such as ENABLING or UPDATING, the
command fails. The response indicates the current
state of the DSA.
4 – Examples
> CREATE DSA NAMING CONTEXT "/C=US/O=Abacus/OU=Sales" -
_> CONSUMER ACCESS POINT -
_> {[AE Title = "/C=US/O=Abacus/CN=DSA4", -
_> Presentation Address = -
_> '"DSA"/"DSA"/"DSA"/NS+11002aaa00040008aa21']}
> SHOW DSA NAMING CONTEXT "/C=US/O=Abacus/OU=Sales" -
_> ALL ATTRIBUTES
The first command creates a Naming Context entity and the
second command displays the Naming Context entity.
> DELETE DSA NAMING CONTEXT -
_> "/C=US/O=Abacus/OU=Sales"
This command deletes the Naming Context entity.
5 – REMOVE
Use the REMOVE directive to remove a value from a
characteristic attribute.
You can use the REMOVE directive on the Consumer Access Point
characteristic attribute only. The other characteristic attributes
of this entity are read-only.
Syntax:
REMOVE DSA NAMING CONTEXT <name>
CONSUMER ACCESS POINT {<value>,...}
where <value> is the value you want to remove from the
attribute.
6 – SET
Use the SET directive to change the value of a Naming Context
characteristic attribute.
You can use the SET directive on the Consumer Access Point
characteristic attribute only. The remaining attributes
are read-only characteristic attributes.
Syntax:
SET DSA NAMING CONTEXT <name>
CONSUMER ACCESS POINT {<value>,...}
where <value> is the value you want to set for the Consumer
Access Point attribute.
Specify all valid NSAPs for a consumer DSA. This improves
the efficiency of the DSA, and ensures the success of the
documented method of implementing replication.
7 – SHOW
Use the SHOW directive to display the characteristic attributes of a Naming Context entity. You can use the SHOW directive on all Characteristic attributes of the Naming Context entity. Syntax: SHOW DSA NAMING CONTEXT <name> <attr> where <attr> is the name of the Characteristic attribute you want to display. You can display the values of multiple attributes using one SHOW directive by separating the attributes with a comma, for example: SHOW DSA NAMING CONTEXT <name> <attribute1>, <attribute2> You can also use the wildcard "*" in a SHOW directive, to show details of all naming contexts; for example: SHOW DSA NAMING CONTEXT * <attr>