The server status is a symbolic integer code which describes the operating status of the server. Possible values are listed in Table 2-33.
Status value |
Meaning |
---|---|
CS_STATUS_ACTIVE |
Server is up and running. |
CS_STATUS_STOPPED |
Server has been taken offline and has not been restarted. |
CS_STATUS_FAILED |
Server is offline because of an error. |
CS_STATUS_UNKNOWN |
Status of the server is unknown. See “Unknown status values” for an explanation. |
The value of the status attribute may be unknown for the following reasons:
The server is an Adaptive Server – SQL Server version 11.0 or earlier does not register its status with the directory service. The status attribute for SQL Server directory entries is always CS_STATUS_UNKNOWN.
Use of the interfaces file in directory lookups – if the directory object being inspected came from the interfaces file, the status attribute is always unknown. The interfaces file does not support status attributes, so the status attribute defaults to CS_STATUS_UNKNOWN when ct_ds_lookup retrieves file entries and converts them to directory objects.
Unregistered Open Server Applications – an Open Server application registers itself to use the directory service as part of its initialization.
If an Open Server registers itself, then Server-Library automatically sets the status attribute value to reflect the current operating condition of the server. If the application does not register itself, its status attribute value will always be CS_STATUS_UNKNOWN.
For more information on how an Open Server registers with the directory service, see the Open Server Server Library/C Reference Manual.