WBMM> ExecuteAction - second WIMS Manager Interface operation

WBMM> ExecuteAction - second WIMS Manager Interface operation

WBMM> ExecuteAction - second WIMS Manager Interface operation

McDonald, Ira imcdonald at sharplabs.com
Mon Jun 28 18:10:37 EDT 2004


Hi folks,                                          Monday (28 June 2004)

For use with WIMS over non-HTTP bindings (e.g., email - SMTP/IMAP/POP),
here's a second WIMS Manager Interface operation named 'ExecuteAction'.
This new operation would allow all WIMS Actions to be effectively
promoted to become direct WIMS Operations.

Comments?

Cheers,
- Ira

PS - I re-ordered the detail sections the way I think we decided at our
last PWG face-to-face.  I'm not sure about this.  I also corrected the
typos and weak references, Bill, in some Parameters and Returns (cut-and
-pasting from SetSchedule in the 19 May version of WIMS spec).


Ira McDonald (Musician / Software Architect)
Blue Roof Music / High North Inc
PO Box 221  Grand Marais, MI  49839
phone: +1-906-494-2434
email: imcdonald at sharplabs.com


------------------------------------------------------------------------

ExecuteAction (sourceURI : URI, targetURI : URI, action : PlanAction)

    statusString : StatusString,
    unsupportedElements : UnsupportedElements

Method Support:

    WIMS Agent - OPTIONAL to support
    WIMS Manager - OPTIONAL to support

Description:

    Sends a PlanAction containing a single WIMS action to a WIMS Agent.
    The receiving WIMS Agent:
    (a) MUST immediately validate this action request;
    (b) MUST attempt to execute any well-formed action request;
    (c) MUST send a response containing the status of the action; and
    (d) MAY send a SendReport or SendAlert to confirm the action.

Parameters:

    sourceURI : xsd:anyURI
    - URI of the source WIMS Manager - this value MUST use the
      'pwg-wims:' URL scheme (see section 'WIMS URL Scheme') and MUST
      conform to [RFC2396].

    targetURI : xsd:anyURI
    - URI of the destination WIMS Agent - this value MUST use the
      'pwg-wims:' URL scheme (see section 'WIMS URL Scheme') and MUST
      conform to [RFC2396].

    action : pwg-sm:PlanAction
    - single action for immediate execution - this PlanAction instance
      MUST conform to the XML Schema defined in the PWG Semantic Model
      [PWG-SM] module 'Schedule.xsd'.

Returns:

    statusString : pwg-sm:StatusString
      An ASCII string containing a keyword, returned by the Manager
      reflecting the status of the action execution at the time of
      response.  Conforms to definition in the Semantic Model [PWG-SM]
      'PwgCommon.xsd'.

    unsupportedElements : pwg-sm:UnsupportedElements
      An UnsupportedElements list that contains the elements that, as
      specified in the action, are not supported by the WIMS Agent.
      Conforms to definition in the Semantic Model [PWG-SM]
      'PwgCommon.xsd'.  If an element itself is not supported, the
      element is returned with an empty value.  If the element is
      supported but the specified value is not supported, the element is
      returned with the originally specified unsupported value.

------------------------------------------------------------------------



More information about the Wims mailing list