GetStatus

Returns the status of the Distributed Connector. The status includes:

  • product name

  • product version

  • build number

  • the ACI port used

  • the service port used

NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the Admin standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

Parameters

Parameter Description Required
ShowChildHealth A Boolean value, default true, that specifies whether to show the status of connectors that have registered with the Distributed Connector. No

Example

/action=GetStatus

Response

The following response is from /action=GetStatus.

<autnresponse xmlns:autn="http://schemas.autonomy.com/aci/"> 
   <action>GETSTATUS</action> 
   <response>SUCCESS</response> 
   <responsedata> 
     <product>DistributedConnector</product> 
     <version>10.8.0</version> 
     <build>1</build> 
     <aciport>10000</aciport> 
     <serviceport>10002</serviceport> 
     <directory>c:\Autonomy\DistributedConnector</directory> 
     <acithreads>4</acithreads> 
     <children> 
       <num_children>1</num_children> 
       <child> 
         <host>10.0.0.1</host> 
         <port>1234</port> 
         <dataport>2345</dataport> 
         <group>FileSystem</group> 
         <priority>0</priority> 
         <active>true</active> 
         <calls>5</calls> 
       </child> 
     </children> 
   </responsedata> 
 </autnresponse> 

There is one <child> element in the response for each registered connector. This shows the following information:

host The machine that hosts the child connector.
port The ACI port of the child connector.
dataport The dataport of the child connector.
group The connector group that the child connector has joined.
priority The priority assigned to the child connector within the connector group.
active A Boolean that indicates whether the child connector is available (responding to actions from the Distributed Connector). To view the availability of the connectors, you must not set EnableConnectorHealthPolling=false.
calls The number of requests made to the child connector since it registered with the Distributed Connector.

The following response is from /action=GetStatus&ShowChildHealth=false:

<autnresponse xmlns:autn="http://schemas.autonomy.com/aci/"> 
   <action>GETSTATUS</action> 
   <response>SUCCESS</response> 
   <responsedata> 
     <product>DistributedConnector</product> 
     <version>10.8.0</version> 
     <build>1</build> 
     <aciport>10000</aciport> 
     <serviceport>10002</serviceport> 
     <directory>c:\Autonomy\DistributedConnector</directory> 
     <acithreads>4</acithreads> 
   </responsedata> 
 </autnresponse>