Hi folks, Tuesday (30 Sept 2003)
[for review at tomorrow's WBMM telecon and next Monday's face-to-face]
In response to some comments from Pete Zehler, I revised my prototype
Schedule XML Schema, based on the IETF Schedule MIB v2 (RFC 3231).
The Schedule XML Schema v0.20 validates without warnings using XSV 2.5
(the free XML Schema Validator) and is posted at:
ftp://ftp.pwg.org/pub/pwg/wbmm/schemas/schedule-20030930.xsd
Below are: (a) change log; (b) use models; (c) defined operations; and
(d) excerpted definition of 'ScheduleEntry' (row in a schedule).
Cheers,
- Ira McDonald
High North Inc
------------------------------------------------------------------------
[changes from v0.10 to v0.20]
(1) Changed 'xsd:integer' (unbounded) to 'xsd:int' (32-bit) to align
with Schedule MIB and for efficient XML processing, per Pete Zehler;
(2) Defined new container elements 'Sched...List' for all multi-valued
elements for efficient XML list processing, per Pete Zehler;
(3) Revised elements to define explicit 'minOccurs' and 'maxOccurs',
for consistency with PWG Semantic Model and XML best practices;
(4) Revised indentation of elements and comments for clarity;
(5) Revised and expanded element documentation.
------------------------------------------------------------------------
[use models]
Use Model 1 (Passive - Required):
A WBMM managed device (or service) creates an HTTP connection (OUTBOUND
across the enterprise network's firewall) to a WBMM management station.
The WBMM managed device (or service) immediately sends a Get-Schedule
request (packaged in a SOAP/1.1 envelope). The WBMM management station
sends a Get-Schedule response containing an XML Schedule object (a list
of scheduled operations and times/intervals).
Later, as each scheduled operation is performed, the WBMM managed device
(or service) may create another HTTP connection to the WBMM management
station and send Send-Report (normal) and/or Send-Alert (exception)
requests, as needed.
Use Model 2 (Active - Optional):
A WBMM management station sends an Execute (or SetSchedule) request
(containing a Schedule object) directly to a WBMM managed device (or
service), for example, by sending a SOAP/1.1 request over email (SMTP).
Later, each scheduled operation is performed by the WBMM managed device
(as described in Use Model 1 above).
------------------------------------------------------------------------
[defined operations]
None - no operation
Other - vendor extension with parameter named 'Operation'
Disable
Enable
Pause
Resume
PauseAndDisable
ResumeAndEnable
PurgeJobs
Restart - reset to same, previous, or factory configuration
Shutdown - stop instance of service/device entirely
Startup - start new instance of service/device
GetElements
SetElements
GetResource
SetResource
Subscribe - for notifications
Unsubscribe
Wakeup - wakeup service/device, which then performs Get-Schedule
------------------------------------------------------------------------
[excerpted definition of 'ScheduleEntry' (row in a schedule)]
<xsd:element name="ScheduleEntry">
<!-- entry for one scheduled management operation -->
<!-- element names ending in 'List' denote multi-valued lists -->
<!-- element names ending in 's' denote single-valued counters -->
<!-- see individual element descriptions for their cardinality -->
<!-- and REQUIRED versus OPTIONAL presence in a schedule entry -->
<!-- see schedEntry - section 4 [RFC3231] -->
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="SchedIndex"
minOccurs="1" maxOccurs="1"/>
<xsd:element ref="SchedDescription"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedState"
minOccurs="1" maxOccurs="1"/>
<xsd:element ref="SchedStateReasonList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedStateMessageList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedOperation"
minOccurs="1" maxOccurs="1"/>
<xsd:element ref="SchedParameterList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedTargetURIList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedObject"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedElementList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedMode"
minOccurs="1" maxOccurs="1"/>
<xsd:element ref="SchedInterval"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedWeekDayList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedMonthList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedDayList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedHourList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedMinuteList"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedTriggers"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedFailures"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedLastError"
minOccurs="0" maxOccurs="1"/>
<xsd:element ref="SchedErrorDate"
minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>