semi合集-English.pdf - 第3526页

SEMI E134.1-0305 © SEMI 2005 13 7.2.3.4 If a DCP is returning from the Hibernating state and th ere is at least one consum e r w i t h a n S E M I E 1 3 2 persistent Session that h ad previously requested activatio n of …

100%1 / 7923
SEMI E134.1-0305 © SEMI 2005 12
7.2 DataCollectionManager
7.2.1 Application of SEMI E132 Sessions
7.2.1.1 This section is provisional, pending the approval of SEMI E132.1 and the SEMI Specification for
Semiconductor Common Components.
7.2.1.2 The DataCollectionManager shall use SEMI E132.1 for authentication and authorization.
7.2.1.3 Use of the interfaces defined in SEMI E134 to collect data can directly affect overall data throughput for the
equipment, and may indirectly affect the equipment’s ability to perform its intended function. Additionally, data
accessible from the equipment via the SEMI E134 interfaces may be proprietary to the equipment supplier and/or
the factory that uses the equipment, and should be protected against unauthorized access within the factory.
7.2.1.4 For this reason, all operations defined by the SEMI E134 DataCollectionManager interface can be
exchanged using the HTTPS transport (HTTP 1.1 over SSL 3.0) by enabling SSL authentication as specified in
SEMI E132.1. Once enabled via SEMI E132.1, the equipment shall require mutual client-server SSL authentication
for all SEMI E134 DataCollectionManager operations supported by the equipment, and the equipment shall not
provide access to any operations except via the HTTPS transport.
7.2.2 There may be some integration, development, and/or test environments in which it is not practical or feasible
to install equipment and/or client certificates in order to communicate with the equipment. As a practical
consideration for such environments only, the equipment shall support the ability of the user to disable SSL
authentication for the SEMI E134 DataCollectionManager interface, using the equipment configuration specified by
E132.1. Users should be aware that disabling SSL authentication opens up complete unrestricted access to SEMI
E134 data for any application with network access to the equipment.
7.2.2.1 Regardless of whether or not SSL authentication is enabled, the equipment shall reject all requests from
clients that do not provide a valid SEMI E132 session identifier in the SOAP envelope header provided with the
request. The SEMI E132 session identifier shall be provided via the E132Header element, as specified by SEMI
E132.1. If a client does not provide a recognized session identifier, the equipment shall immediately reject the
request using the SEMI Common Error data type, with an error code of ‘6005’ and a source of ‘urn:semi-org:E132’
as specified in SEMI E132.1. The equipment shall perform no other processing of an SEMI E134 request if the
request is found to include an invalid SEMI E132 session identifier, or if no session identifier is provided.
7.2.3 Session and DCP State Interaction
7.2.3.1 The equipment shall maintain DCP activity on a per-Session basis. For example, the same SEMI E132
Principal may establish one or more SEMI E132 Sessions on the equipment. If only one of those Sessions activates
a DCP, the equipment shall only enable the DCP for that specific session. If two separate SEMI E132 sessions
attempt to activate the same DCP, the equipment shall activate the DCP for both sessions. Similarly if one active
SEMI E132 session attempts to activate the same DCP twice, the equipment shall respond to the second request with
the DCPIsActive error, as defined in SEMI E134.
7.2.3.2 As described in ¶7.2.1.3 , the equipment shall use the URL provided with the HTTPEndpoint information
provided with the SEMI E132 EstablishSession request to send all SEMI E134 communication.
7.2.3.3 If a consumer’s SEMI E132.1 Session is closed for any reason (either expressly closed or through a
communication failure), the equipment shall stop sending data from all DCP’s previously activated by that
consumer. This shall not affect data transmission from those DCP’s to consumers that still have SEMI E132
Sessions in the Established state.
7.2.3.3.1 If one or more of these DCP’s has more than one consumer, the equipment shall take the actions defined in
transition 5 of the E134 DataCollectionPlan State model. These DCP’s will remain active, and the equipment shall
remove the consumer’s session from the active consumers list and continue to send data to the other consumers for
those DCP’s.
7.2.3.3.2 If one or more of these DCP’s has only one consumer, the equipment shall take the actions defined in
transition 8 of the SEMI E134 DataCollectionPlan State model. The equipment shall remove the consumer’s session
from the active consumers list and change the state of these DCP’s to Inactive.
SEMI E134.1-0305 © SEMI 2005 13
7.2.3.4 If a DCP is returning from the Hibernating state and there is at least one consumer with an SEMI E132
persistent Session that had previously requested activation of the DCP, then the equipment shall transition the DCP
to the Active state, and resume sending data to each consumer with an SEMI E132 persistent Session.
7.2.3.5 If a DCP is returning from the Hibernating state and there are no consumers with SEMI E132 persistent
Sessions, then the equipment shall transition the DCP to the Inactive state.
7.2.4 Authentication and Authorization Using SEMI E132.1
7.2.4.1 The equipment shall implement the SEMI E134 privilege levels as SEMI E132 privileges.
7.2.4.2 The equipment shall implement the SEMI E134 privilege levels naming convention as specified in Table 9.
The privileges listed are of the format urn:semi-org:priv.<priv-name>.
Table 9 SEMI E134 to SEMI E132 Privilege mapping
SEMI E134 Privilege Level SEMI E132.1 PrivilegeId Entry
ManageOnlyAuthoredDCPs urn:semi-org:priv.ManageOnlyAuthoredDCPs
UseAnyDCP urn:semi-org:priv.UseAnyDCP
ManageAnyDCP urn:semi-org:priv.ManageAnyDCP
7.2.5 Using SEMI E125 Metadata to Identify Sources, Events, Exceptions, and Parameters
7.2.5.1 Sources shall be named using a valid SEMI E120 Locator value (see SEMI E120, Related Information 2,
and the SEMI E120.1 LocatorType). Events/exceptions are identified by their SEMI E125 “id” attribute, and
Parameters are identified by their SEMI E125 “name” attribute. If the events, exceptions, or parameters are defined
by an SEMI E39-compliant objType, then use the following naming conventions to distinguish between information
from any instance vs. a specific instance.
Table 10 Source/Event/Exception/Parameter Naming Convention
SEMI E125 Element Naming Convention
Parameter SEMI E125 Parameter Class Name attribute
Event SEMI E125 Event Class Id attribute
Exception SEMI E125 Exception class Id attribute
ObjType Attribute (any instance) urn:semi-org:objType:<typeName>:objAttr:<parameter name>
ObjType Event (any instance) urn:semi-org:objType:<typeName>:<eventId >
ObjType Exception (any instance) urn:semi-org:objType:<typeName>:<exceptionId>
ObjType Attribute (specific instance) urn:semi-org:objType:<instName>:objAttr:<parameterName >
ObjType Event (specific instance) urn:semi-org:objType:<instName>:<eventId >
ObjType Exception (specific instance) urn:semi-org:objType:<instName>:<exceptionId>
7.2.5.2 <typeName> and <instName> referenced in Table 10 shall be of the following format. “typeName” shall be
the E39 objType name for the object type of interest. “instName” shall be equal to a string of the form
<typeName>-<E39 objId>, where “typeName” specifies the object type of interest, and “objId” specifies the
particular object of interest, equal to the value of that instance’s SEMI E39 objId attribute.
7.2.6 Use of Common Error Type
7.2.6.1 This section is provisional, pending the approval of the SEMI Specification for Semiconductor Common
Components.
7.2.6.2 Table 11 below provides a mapping of the SEMI E134 defined errors to its common error code. The SEMI
E134 mapped error codes below are in addition to any common error codes defined in the Common Components
Specification. SEMI E134 Error codes shall be denoted in the common error type structure by defining the “source”
name of “urn:semi-org:E134”.
SEMI E134.1-0305 © SEMI 2005 14
7.2.6.3 SEMI E134.1 implements the SEMI E134 Unauthorized Operation Class as the SEMI E132.1
UnauthorizedOperation class and will return the SEMI E132.1 error code “6005” and a source of “urn:semi-
org:E132” Operation not authorized in the Common Components Error structure.
Table 11 SEMI E134 Error Codes
SEMI E134 Error Common Error Code
Operation not authorized. 6005 (as defined in SEMI E132.1)
InvalidPlan 8000
NoSuchPlan. 8001
DCPIsActive. 8002
DCPNotActive. 8003
7.2.7 XML Schema and WSDL Files
7.2.7.1 This section is provisional, pending the approval of SEMI E120.1, SEMI E125.1, and SEMI E132.1.
7.2.7.2 The XML Schema and WSDL defined by this specification for the DataCollectionManager interface is
contained in the following documents:
Table 12 XML Schema
File Name E134-1-V0305-Schema.xsd
Target Namespace urn:semi-org:xsd.E134-1.V0305.DCM
Imported/Referenced
Namespaces
urn:semi-org:xsd.E120-1.V0704.CommonEquipmentModel
http://www.w3.org/2001/XMLSchema
Description
This file defines all of the SEMI E134 data types and elements used by both the
DataCollectionManager and DCPConsumer interfaces.
Table 13 DataCollectionManager PortType Definitions
File Name E134-1-V0305-Equipment-portType.wsdl
Target Namespace urn:semi-org:ws.E134-1.V0305.DCMEqp-portType
Imported/Referenced
Namespaces
urn:semi-org:xsd.E132-1.V0305.auth
urn:semi-org:xsd.E134-1.V0305.DCM
http://schemas.xmlsoap.org/wsdl/
http://www.w3.org/2001/XMLSchema
Description
This file defines all of the input/output messages and operations for the DataCollectionManager
interface, based on the data types defined in the SEMI E134 XML Schema.
Table 14 DataCollectionManager Binding Definitions
File Name E134-1-V0305-Equipment-binding.wsdl
Target Namespace urn:semi-org:ws.E134-1.V0305.DCMEqp-binding
Imported/Referenced
Namespaces
urn:semi-org:ws.E134-1.V0305.DCMEqp-portType
http://schemas.xmlsoap.org/wsdl/soap/
http://schemas.xmlsoap.org/wsdl/
Description
This file binds the abstract portType definition to HTTP and SOAP, specifying required SOAP
and HTTP headers for each operation and the XML encoding style.
7.2.7.3 These documents are a part of this specification and should accompany this document. The contents of
these documents constitute the core part of this specification.
7.2.7.4 E134-1-V0305-Schema.xsd imports types from the SEMI E132.1 Equipment Client Authentication and
Authorization XML Schema namespace, specifically the E132Header and E132HashHeader types.