semi合集-English.pdf - 第3468页

SEMI E134-0305 © SEMI 2004, 2005 21 9.1.2.7. 6 DCPDeactivated — This class describes a DCP that has be en successfully deactivated on the equipment. 9.1.2.7. 6.1 DCPDeactivated Attribute Defin ition Table Table 26 DCPDea…

100%1 / 7923
SEMI E134-0305 © SEMI 2004, 2005 20
termination request, but the requested plan has not been previously activated by any consumer, the equipment shall
return the DCPNotActive error.
9.1.2.7.2 If the consumer does not have sufficient privilege (see Section 10) to deactivate the requested DCP, the
equipment shall return an UnauthorizedOperation error.
9.1.2.7.3 DeactivatePlan Operation Arguments
Table 25 DeactivatePlan Argument Definitions
Argument Description Kind Form
planId Identifier for the requested plan. in Text, equal to a valid DCP id.
terminate Whether or not the DCP should be
deactivated for all consumers.
in Boolean. See Section 9.1.2.7.4 for more
information.
deactivatedPlan Confirmation that the requested plan has
been deactivated
out Structure, of type DCPDeactivated, described in
Section 9.1.2.7.6.
error The consumer submitting the DCP does
not have sufficient privilege to deactivate
the DCP
error Structured data, of type UnauthorizedOperation,
described in Section 9.1.2.2.5.
error The equipment does not recognize the
requested planId
error Structured data, of type NoSuchPlan, described in
Section 9.1.2.4.3.
error The requested plan is not active. error Structured data, of type DCPNotActive, described
in Section 9.1.2.7.7.
9.1.2.7.4 planId — This operation defines the following reserved planId to name groups of DCPs for deactivation.
This identifier is not valid for use as a DCP id in any operation other than DeactivatePlan.
9.1.2.7.4.1 “urn:semi-org:dcm:allDCPs” — This identifier can be used to request deactivation of all plans that are
currently active for the requesting consumer. If other consumers have activated any of these same plans, those
consumers shall continue to receive DataCollectionReports from those plans. When used together with a request to
terminate (see Section 9.1.2.7.5), the equipment shall terminate all DCPs currently active on the equipment for all
consumers, including those that have been activated by the requesting consumer.
9.1.2.7.5 terminate — If set to “true”, the equipment shall stop buffering/sending all data included in the identified
DCP to all consumers that have previously activated the DCP. The equipment shall discard any buffered data at the
time of the request. The equipment shall notify each such consumer of the reason for the termination using the
DCPDeactivated notification (see Section 15.1.6.2). The consumer must have sufficient privilege (see Section 10)
to request termination of a DCP.
planId
timeDeactivated
deact ivatedBy
reason
DCPDeactivated
Figure 11
DCPDeactivated Class
SEMI E134-0305 © SEMI 2004, 2005 21
9.1.2.7.6 DCPDeactivated — This class describes a DCP that has been successfully deactivated on the equipment.
9.1.2.7.6.1 DCPDeactivated Attribute Definition Table
Table 26 DCPDeactivated Attribute Definition
Attribute Name Definition Form
planId Identifies a plan that has been deactivated. Text, equal to the ‘id’ attribute of the
DataCollectionPlan that was deactivated.
timeDeactivated The date and time at which the DCP was
deactivated.
Text, formatted according to Section 14.5.
deactivatedBy The identity of the consumer that deactivated the
DCP.
Text, equal to a valid identifier for the consumer that
took the action (see Limitations, Section 3.1.2 ). If
the equipment is deactivating the DCP, this field shall
be a URN of the form “urn:semi-org:equipment”.
The valid values to use for this attribute to identify
consumers shall be specified by any adjunct
document defining a technical binding for this
specification.
reason A human-readable description of the reason that the
DCP was deactivated.
Text.
planId
DCPNotActive
Figure 12
DCPNotActive Class
9.1.2.7.7 DCPNotActive — This class describes a DCP that has not been activated, either by a specific consumer, or
by any consumer (see Section 9.1.2.7.1).
9.1.2.7.7.1 DCPNotActive Attribute Definition Table
Table 27 DCPNotActive Attribute Definition
Attribute Name Definition Form
planId Identifies the plan that is not active. Text, equal to the ‘id’ attribute of the
DataCollectionPlan that is not active.
9.1.2.8 DeletePlan — Upon receiving this request, the equipment shall delete the requested plan definition from
non-volatile storage. The equipment shall reject this request if the requested plan is currently active for one or more
consumers. For a plan to be deleted, it must be deactivated (no consumer is currently receiving data produced by the
plan). Note that no consumer can delete built-in DCPs provided with the equipment (see Section 11.1.2.1).
9.1.2.8.1 If the consumer does not have sufficient privilege (see Section 10) to delete the requested DCP, the
equipment shall return an UnauthorizedOperation error.
9.1.2.8.2 DeletePlan Operation Arguments
Table 28 DeletePlan Argument Definitions
Argument Description Kind Form
planId Identifier for the requested plan. in Text, equal to a valid DCP id.
deletedPlan Confirmation that the requested plan has
been deleted.
out Structured data, of type DCPDeleted, described in
Section 9.1.2.8.5.
SEMI E134-0305 © SEMI 2004, 2005 22
Argument Description Kind Form
error The consumer submitting the DCP does
not have sufficient privilege to delete the
requested DCP.
error Structured data, of type UnauthorizedOperation,
described in Section 9.1.2.2.5 . If the consumer
was attempting to delete a built-in DCP (see
Section 11.1.2.1 ), the requiredPrivilege attribute
of the UnauthorizedOperation class shall be set to
the value “no such privilege”.
error The equipment does not recognize the
requested planId.
error Structured data, of type NoSuchPlan, described in
Section 9.1.2.4.3.
error The requested planId is currently active error Structured data, of type DCPIsActive (see Section
9.1.2.8.3).
DCPIsActive
DCPActivated
activat edPlan
11
Figure 13
DCPIsActive Error
9.1.2.8.3 DCPIsActive — This class describes an error in activating or deleting a DCP that is currently active. It
provides information describing the original activation of the DCP.
9.1.2.8.3.1 DCPIsActive Association Definition Table
Table 29 DCPIsActive Association Definition
Association Role Name Definition Comments
activatedPlan Provides a description of the original activation
of the DCP.
Structured data, of type DCPActivated, described in
Section 9.1.2.8.4.
planId
timeActivated
activatedBy
DCPActivated
Figure 14
DCPActivated Class
9.1.2.8.4 DCPActivated — This class describes a DCP that has been successfully activated on the equipment.
9.1.2.8.4.1 DCPActivated Attribute Definition Table
Table 30 DCPActivated Attribute Definition
Attribute Name Definition Form
planId Identifies an active DCP. Text, equal to the ‘id’ attribute of the
DataCollectionPlan that has been activated.
timeActivated The date and time at which the DCP was activated. Text, formatted according to Section 14.5.
activatedBy The identity of the consumer that activated the
DCP.
Text, equal to a valid identifier for the consumer that
took the action (see Limitations, Section 3.1.2). The
valid values to use for this attribute to identify