NCLHELP.HLB  —  Directory Module, DSA  Status
 Status attributes provide you with information about a specified
 DSA. Status attributes are read only.

 All status attributes can be displayed using the SHOW directive.

 Syntax:
                 SHOW DSA <attr>

 You can display the value of multiple status attributes as part
 of one SHOW directive by separating the attributes with a comma.
 For example:
                 SHOW DSA <attribute1>, <attribute2>

 Similarly, you can display all status attributes using the ALL
 STATUS qualifier. For example:

                 SHOW DSA ALL STATUS

1  –  Accounting State 

 The Accounting State status attribute is no longer used by the DSA.
 Refer to the help for the Accounting Facility characteristic
 attribute.

2  –  Attribute Count 

 The Attribute Count status attribute specifies the total
 number of attributes in all of the entries in the DSA's
 database. This attribute is set by the DSA.

 Syntax:
 	SHOW DSA ATTRIBUTE COUNT

 By dividing the number of attributes by the Entry Count,
 you can estimate the number of attributes per entry.

3  –  DIT Memory Occupancy 

 The DIT Memory Occupancy attribute specifies approximately the
 number of bytes of memory currently needed to hold the DSA
 database. This attribute is set by the DSA.

 Syntax:
 	SHOW DSA DIT MEMORY OCCUPANCY

 By dividing the DIT memory occupancy by the Entry Count,
 you can estimate the amount of memory required by a typical
 entry. This may enable you to estimate how many more entries
 the DSA could hold before memory resources are exhausted. It
 may also indicate how much memory would be required by a
 DSA that takes a shadow copy of this DSA's information.

 Memory occupancy may vary for different operating systems.

4  –  Entry Count 

 The Entry Count status attribute specifies the number of
 entries in this DSA's database. This attribute is set and
 maintained by the DSA. The number is the total number of
 entries and shadow entries held by the DSA.

 Syntax:
 	SHOW DSA ENTRY COUNT

5  –  Entry Limit 

 The Entry Limit status attribute specifies the number of
 entries that the DSA's license allows you to create. If
 the DSA exceeds its entry limit, the Resource Exhausted
 event is generated stating Insufficient License Capacity.

 As long as the entry limit is exceeded, you will be unable
 to create new entries in the DSA. However, if the DSA is
 a consumer DSA, its ability to receive entries from its
 supplier DSAs is unaffected.

 Refer to HP Enterprise Directory  - Problem Solving
 for details of the entry limit.

6  –  Examples 

 	> SHOW DSA ALL STATUS

 	This command displays the value of all status attributes.

 	> SHOW DSA DIT MEMORY OCCUPANCY

 	This command displays the amount of memory in bytes,
 	currently used to store the DSA database.

7  –  State 

 The State status attribute indicates the current state of a DSA
 entity. A DSA may be in one of the following states at any one
 time:

 -       CREATING     The DSA has received a CREATE directive,
                      and is in the process of creating.
 -	OFF	     The DSA has either been disabled or just
                      created. It is unavailable for communication
                      with applications or other DSAs. It is available
                      for most management directives.
 -	ENABLING     An ENABLE directive has been issued and the DSA
 	 	     is making itself available for communication.
                      It is the transition between the OFF and ON
                      states.
 -	ON	     The DSA has been enabled and is ready for use.
                      The DSA can now communicate with
                      applications and other DSAs.
 -	DISABLING    A DISABLE directive has been issued and the DSA
                      is disabling itself from service. It is the
                      transition between the ON and OFF states.
 -       UPDATING     The DSA is in the processing of replicating
                      information with another DSA. The DSA is either
                      supplying or consuming naming contexts.

 Syntax:
 	SHOW DSA STATE

8  –  UID 

 The UID status attribute contains the unique identifier of a DSA
 entity. The UID is created and assigned when the DSA entity is
 created (See the CREATE directive). Use of this attribute is
 deprecated, and the attribute will be removed in a future version.

 Syntax:

 	SHOW DSA UID

9  –  Unique Value Count 

 The Unique Value Count status attribute specifies the number
 of unique attribute values present in the DSA's database. This
 attribute is set by the DSA. A DSA stores a given attribute
 value only once, to save space and improve the performance of
 user requests.

 Syntax:
 	SHOW DSA UNIQUE VALUE COUNT
Close Help