NCLHELP.HLB  —  Directory Module, DSA  Superior Reference, Directives  CREATE
 Use this directive to create a Superior Reference entity.

 Syntax:

 	CREATE DSA SUPERIOR REFERENCE <argument> <value>

1  –  Arguments

 The CREATE directive has one argument: ACCESS POINT. This argument
 is optional, although a Superior Reference entity without an
 Access Point attribute serves no purpose. You can specify the
 Access Point attribute using the SET directive instead.

 The ACCESS POINT argument identifies a DSA holding a naming context
 which is superior to all the naming contexts contained within this
 DSA. 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 the DSA in the 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  –  Errors

 The CREATE directive returns one of the following errors:

 REASON:         Already Exists
 DESCRIPTION:    The Superior Reference entity already exists.

 REASON:         Wrong State
 DESCRIPTION:    The DSA entity is not in the correct state.

 The DSA entity must be in state ON, ENABLING, DISABLING
 or OFF when you create a Superior Reference entity.
 Any other state causes a failure. The response indicates the
 current state of the DSA.
Close Help