IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Agent-based services > Agent Service Interface > Agent Service Interface - Service Interface Request

IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

Agent Service Interface request - Private situation control

Create a service interface <PVTCONTROL> request to start, stop, or recycle a private situation on the monitoring agent.

Private situations start running automatically when the monitoring agent they are written for, whether a Tivoli Enterprise Monitoring Agent or a Tivoli System Monitor Agent, is started. The PVTCONTROL command enables you to start, stop, or recycle the specified situation without having to stop and restart the agent.


Request input


Agent Service Interface <PVTCONTROL> request.

Tag Description
<PVTCONTROL> Specify private situation control request.
<PVTCOMMAND> Specify private situation command.
<PVTSITNAME> Specify private situation name.
<PVTACTION> START – Start a known situation request.
STOP – Stop an active situation.
RECYCLE – Stop and restart an active situation.

Sample request 1: Recycle private situation Check_DiskSpace_Low

    <PVTCONTROL>
 <PVTCOMMAND>
   <PVTSITNAME>Check_DiskSpace_Low</PVTSITNAME>
   <PVTACTION>RECYCLE</PVTACTION>
 </PVTCOMMAND>
</PVTCONTROL>


Report output


Agent Service Interface <PVTCONTROL> request output.

Output tag Description
<STATUS> Return status code bracketed by begin and end tag.

Sample output 1: Recycle private situation Check_DiskSpace_Low returns the command status

    <PVTCONTROL>
 <STATUS>0 Request completed successfully</STATUS> 
</PVTCONTROL>


Parent topic:

Agent Service Interface - Service Interface Request

+

Search Tips   |   Advanced Search