Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Operations Manager i10.62

Develop > Web Service Interfaces > Action Web Service Interface > Examples

Examples

The following XML examples show you how to perform a sample workflow using the Action Web Service.

Submit a request (command "ovc") on three nodes, poll for the overall status, retrieve the detailed result as soon as the command has finished for a host.

Start the command:

POST – https://<server>:<port>/opr-web/rest/10.10/direct_execution

<direct_execution xmlns="http://www.hp.com/2009/software/opr/data_model" xmlns:\
xs="http://www.w3.org/2001/XMLSchema">
    <command>ovc</command>
    <tool_type>om_agent_command</tool_type>
    <execution_hosts>
      <execution_host>example.example.net</execution_host>
      <execution_host>ia2.example.net</execution_host>
      <execution_host>asdf</execution_host>
    </execution_hosts>
</direct_execution>

Output:

<tool_execution_context xmlns="http://www.hp.com/2009/software/opr/data_model" x
mlns:xs="http://www.w3.org/2001/XMLSchema">
   <id>ec172b83-277e-4853-90fa-ad7f49ad7262</id>
   <tool_ref>
      <id>79aa0a94-a717-4301-b22d-6c9728d52f93</id>
      <target_id>79aa0a94-a717-4301-b22d-6c9728d52f93</target_id>
      <label>DirectExecution</label>
      <tool_type>om_agent_command</tool_type>
      <has_user_parameter>false</has_user_parameter>
      <requires_run_as_user>true</requires_run_as_user>
   </tool_ref>
   <user_parameters/>
   <tool_execution_result_ref>
      <id>d1714284-5d42-4b45-a95a-ad110555630d</id>
      <execution_host>ia2.example.net</execution_host>
      <tool_command>ovc</tool_command>
      <tool_execution_state>running</tool_execution_state>
      <started>2015-09-30T13:03:56.980+02:00</started>
      <started_text>01:03:56 PM</started_text>
   </tool_execution_result_ref>
   <tool_execution_result_ref>
      <id>1c4b0db4-2e82-4657-a1c6-ecfa1d2a2e29</id>
      <execution_host>asdf</execution_host>
      <tool_command>ovc</tool_command>
      <tool_execution_state>failed</tool_execution_state>
      <started>2015-09-30T13:03:56.378+02:00</started>
     <started_text>01:03:56 PM</started_text>
      <finished>2015-09-30T13:03:56.397+02:00</finished>
      <finished_text>01:03:56 PM</finished_text>
   </tool_execution_result_ref>
   <tool_execution_result_ref>
      <id>3a39dd97-bee1-4acb-a595-18c8b4daeaad</id>
      <execution_host>example.example.net</execution_host>
      <tool_command>ovc</tool_command>
      <tool_execution_state>running</tool_execution_state>
      <started>2015-09-30T13:03:56.984+02:00</started>
      <started_text>01:03:56 PM</started_text>
   </tool_execution_result_ref>
</tool_execution_context>

Get a status overview for all nodes; use the execution context ID from the previous step.

GET - https://<server>:<port>/opr-web/rest/10.10/direct_execution/ec172b83-277e-4853-90fa-ad7f49ad7262

Check the output (also of type <tool_execution_context>) for terminated commands. Repeat the step until the XML tag <tool_execution_state> of one or more nodes changes to "finished" or "failed". To get the details, proceed to step 3. Continue polling the status until the last host is finished.

Get the detailed status of one node. Use the execution context ID and appropriate node-specific result ID.

GET - https://<server>:<port>/opr-web/rest/10.10/direct_execution/ec172b83-277e-4853-90fa-ad7f49ad7262/d1714284-5d42-4b45-a95a-ad110555630d

Output:

<tool_execution_result xmlns="http://www.hp.com/2009/software/opr/data_model" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <id>d1714284-5d42-4b45-a95a-ad110555630d</id>
   <tool_ref>
      <id>3269833c-1818-41dc-bd06-aafb6334088f</id>
      <target_id>3269833c-1818-41dc-bd06-aafb6334088f</target_id>
      <label>DirectExecution</label>
      <tool_type>om_agent_command</tool_type>
      <has_user_parameter>false</has_user_parameter>
      <requires_run_as_user>true</requires_run_as_user>
   </tool_ref>
   <execution_host>ia2.example.net</execution_host>
   <tool_command>ovc</tool_command>
   <user_parameters/>
   <tool_execution_state>finished</tool_execution_state>
   <started>2015-09-30T13:03:56.980+02:00</started>
   <started_text>01:03:56 AM</started_text>
   <finished>2015-09-30T13:03:58.292+02:00</finished>
   <finished_text>01:03:58 AM</finished_text>
   <output>coda        OV Performance Core                 COREXT       (6983)
Running
ompolparm   OM Parameter Handler                AGENT,EA     (8308)   Running
opcacta     OVO Action Agent                    AGENT,EA     (6948)   Running
opcmona     OVO Monitor Agent                   AGENT,EA     (8275)   Running
opcmsga     OVO Message Agent                   AGENT,EA     (8333)   Running
ovbbccb     OV Communication Broker             CORE         (6897)   Running
ovcd        OV Control                          CORE         (6889)   Running
ovconfd     OV Config and Deploy                COREXT       (6917)   Running
</output>
   <result_code>0</result_code>
</tool_execution_result>

Send Help Center feedback