NCLHELP.HLB  —  Directory Module, DSA  Subordinate Reference, Characteristics
 Each Subordinate Reference entity has two characteristic attributes:

 -	Access Point
 -	Copy Access Point

 You can use the ADD, SET, SHOW and REMOVE directives on both these
 attributes.

 Syntax:

 ADD    DSA SUBORDINATE REFERENCE <name> <attr> {<value>,...}
 REMOVE DSA SUBORDINATE REFERENCE <name> <attr> {<value>,...}
 SET    DSA SUBORDINATE REFERENCE <name> <attr> {<value>,...}
 SHOW   DSA SUBORDINATE REFERENCE <name> <attr>

 where <attr> is the characteristic attribute name and
 <value> is the value.

 The Access Point attribute is single-valued.

 You can display the value of both attributes in one SHOW
 directive by separating the attributes with a comma. For example:

 SHOW DSA SUBORDINATE REFERENCE <name> <attribute1>, <attribute2>

 Similarly, you can achieve the same result by using the ALL
 CHARACTERISTICS qualifier with the SHOW directive. For example:

 SHOW DSA SUBORDINATE REFERENCE <name> ALL CHARACTERISTICS

1  –  Access Point

 This specifies the Access Point of the DSA which holds the master
 copy of a directory entry subordinate to the current entry. There
 is no default value.

 Syntax:

 ADD    DSA SUBORDINATE REFERENCE <name> ACCESS POINT {<value>,...}
 REMOVE DSA SUBORDINATE REFERENCE <name> ACCESS POINT {<value>,...}
 SET    DSA SUBORDINATE REFERENCE <name> ACCESS POINT {<value>,...}
 SHOW   DSA SUBORDINATE REFERENCE <name> ACCESS POINT

 where <value> 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.

2  –  Copy Access Point

 This specifies the DSA which holds a copy of a directory
 entry subordinate to the current entry. There is no default
 value.

 Syntax:

 ADD DSA SUBORDINATE REFERENCE <name> COPY ACCESS POINT {<value>,...}

 REMOVE DSA SUBORDINATE REFERENCE <name> COPY ACCESS POINT {<value>,...}

 SET DSA SUBORDINATE REFERENCE <name> COPY ACCESS POINT {<value>,...}

 SHOW DSA SUBORDINATE REFERENCE <name> COPY ACCESS POINT

 where <value> is the access point of a DSA to which the
 Subordinate Reference refers, and is specified as follows:

    [ae title  = "<distinguished name of DSA>",
      presentation address = '<presentation address>']

 The AE Title and the presentation address are both mandatory.
 Note that the order of the AE Title and presentation
 address must be the same as that 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.
Close Help