Use this directive to create a Subordinate Reference entity
of the specified name.
Syntax:
CREATE DSA SUBORDINATE REFERENCE <name> <argument> <value>
1 – Arguments
The CREATE directive has an identifier and two arguments:
- ACCESS POINT
- COPY ACCESS POINT
The identifier specifies the name of this
Subordinate Reference entity. This is in the form of a
distinguished name.
The ACCESS POINT argument identifies the DSA holding the master copy
of the naming context for which this entity provides a reference.
The attribute is single-valued. Specify the ACCESS POINT argument
in the following format:
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>']}
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 DSA in an access point. This
improves the network efficiency of the DSA, ensuring that if
a connection to the relevant DSA already exists, it is always
re-used.
Refer to DSA Common_Datatypes for more information
on how to specify an AE Title and a Presentation Address.
The COPY ACCESS POINT is optional and specifies one or more DSAs
that hold a copy of the naming context to which this entity
provides a reference. Specify the COPY ACCESS POINT argument
in the following format:
COPY ACCESS POINT <access point>
where <access point> is the access point of the DSA and is
specified as shown in the preceding description of the
ACCESS POINT argument.
2 – Errors
The CREATE directive returns one of the following errors:
REASON: Already Exists
DESCRIPTION: This Subordinate Reference entity already exists.
REASON: Invalid Name
DESCRIPTION: The entity name is not a valid directory name.
The name of the entity must be in the form of a
distinguished name. The response shows the
invalid name.
REASON: Not Master
DESCRIPTION: Cannot create a Subordinate Reference in a
shadow Naming Context.
You cannot create a Subordinate Reference entity
within a shadow Naming Context. You must
create a Subordinate Reference entity on the DSA
that is listed as being the master DSA for the
naming context that should contain this reference,
and then replicate the new reference to all
shadow DSAs for that naming context. The response
identifies the master DSA for the naming context.
REASON: Entry Already Exists
DESCRIPTION: The DSA already holds an entry with the specified
name.
If an entry already exists with the name that
you specify, then it would be inappropriate to
create a Subordinate Reference entity of the same
name. The Subordinate Reference entity marks the
termination of a naming context, but the existence
of an entry already in that place indicates
that some naming context extends beyond the
proposed termination point.
REASON: Alias Entry Already Exists
DESCRIPTION: The DSA already holds an alias entry with the
specified name.
An alias entry already exists with the same
name. An alias entry cannot have subordinate
entries, so it is inappropriate to create a
reference downwards from this position in the DIT.
REASON: Naming Context Already Exists
DESCRIPTION: The DSA already holds a Naming Context entity
with the specified name.
A Naming Context entity already exists at this
position in the DIT. A Subordinate Reference
entity cannot be created if a Naming Context
entity already exists at that location. If a
Subordinate Reference entity is really required
at this position, to terminate some higher
naming context, then it must be created before the
creation of the Naming Context entity with which
it might then coexist. To reduce the chances of
invalid configurations, the DSA requires you to
create entities in a logical order, marking the
termination of one context before allowing the
creation of another.
REASON: Has Subordinates
DESCRIPTION: The DSA already holds entries or entities
subordinate to the entity being created.
Subordinate entries exist below the proposed
location of the Subordinate Reference entity.
To create a Subordinate Reference entity in
the proposed position would leave these entries
beyond the termination point of whichever naming
context they are part of.
REASON: Below Subordinate Reference
DESCRIPTION: The directly superior entity is another Subordinate
Reference.
There is already a Subordinate Reference entity
higher up the DIT. You cannot create consecutive
Subordinate Reference entities.
REASON: DIT Root
DESCRIPTION: Cannot create a Subordinate Reference at the root of
the DIT.
You cannot create a Subordinate Reference entity
directly on the root entry of a DIT (/). A
Subordinate Reference entity must have a
distinguished name that contains at least one
relative distinguished name.
REASON: Alias entry
DESCRIPTION: Alias entry prevents creation.
The identifier you specified for the Subordinate
Reference entity is an alias name, not a
distinguished name. The DSA does not support the
use of alias names when creating entities. Specify
the distinguished name of the entry at the top
of the naming context to which this entity
provides a reference. 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, ENABLING, DISABLING
or OFF when you create a Subordinate Reference
entity. The response shows the current state of
the DSA.