semi合集-English.pdf - 第3682页

SEMI PR8-0703 © SEMI 2003 12 Table 8 Generic Service Acknowledge for GetActivePlanIds Field Name Value SVCACK 0, 2, 5 Use 5 only when data management configuration switch is not set to SECS/GEM LINKID 0 SPNAME 1 “ActiveP…

100%1 / 7923
SEMI PR8-0703 © SEMI 2003 11
single client. There is no guarantee of the time between
activation request and the transmission of data from the
newly activated DCP to the client.
7.6.2.4.1 Data collection plans can be activated in two
modes, determined by the value of the
“UntilDeactivated” parameter (see Tables 11 and 15).
If the plan is activated with “UntilDeactivated” set to
“true”, then the plan will remain active until a
DeactivatePlan request is sent for that plan. In this
mode, the equipment shall place the plan in the
“Hibernating” state when the equipment shuts down, to
be re-activated during equipment startup. If the plan is
activated with “UntilDeactivated” set to “false”, then
the equipment shall place the plan in the “Inactive”
state when the equipment shuts down, requiring an
“ActivatePlan” request from a client to be made in
order to activate the plan again.
7.6.2.4.2 When this message is sent via SOAP, the
SOAPAction HTTP header used shall be “urn:semi-
org:ws:eda_ps_v0.0:ActivatePlan”. When this message
is sent via SECS/GEM, the S14F19 message shall be
used, with the SVCNAME data variable equal to
“ActivatePlan” (see Table 11).
7.6.2.4.3 The equipment shall only act on this request
if it originates from a client that is compatible with the
setting of the data management configuration switch.
For example, if the configuration switch is set to enable
data management via SECS/GEM and the request
originates from the SECS/GEM client, the equipment
shall respond by activating the requested DCP. If the
request originates from a SOAP client, the equipment
shall respond with an error.
7.6.2.5 DeactivatePlan — In this operation the data
management client requests the deactivation of one or
all of the currently activated data collection plans for
that client. If the data management client intends to de-
activate all data collection plans then Deactivate Plan
ID field should contain “ALL”. The equipment
responds with the list of data collection plans that have
been deactivated. If the equipment is unable to de-
activate the requested DCP it should respond with an
error message.
7.6.2.5.1 When this message is sent via SOAP, the
SOAPAction HTTP header used shall be “urn:semi-
org:ws:eda_ps_v0.0:DeactivatePlan”. When this
message is sent via SECS/GEM, the S14F19 message
shall be used, with the SVCNAME data variable equal
to “DeactivatePlan” (see Table 13).
7.6.2.5.2 The equipment shall only act on this request
if it originates from a client that is compatible with the
setting of the data management configuration switch.
For example, if the configuration switch is set to enable
data management via SECS/GEM and the request
originates from the SECS/GEM client, the equipment
shall respond by deactivating the requested DCP. If the
request originates from a SOAP client, the equipment
shall respond with an error.
7.6.2.6 SECS/GEM Data Management Messages
(S14,F19/20)
7.6.2.6.1 Each data management request sent via
SECS/GEM is implemented using the Generic Service
Request stream and function defined in SEMI E5.
Tables 5–14 define the arguments for the requests and
acknowledgements for each of these messages.
Although data management via SECS/GEM may not be
performed if the SECS/GEM port enters the offline
state or otherwise becomes unavailable, the equipment
shall continue to send DCP data activated while the
SECS/GEM was available.
Table 5 Generic Service Request for IsEdaEnabled
Field Name Value
OPID 0
OBJSPEC “DataCollectionManager”
SVCNAME “IsEdaEnabled”
Table 6 Generic Service Acknowledge for
IsEdaEnabled
Field Name Value
SVCACK 0, 2
LINKID 0
ERRCODE
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses.
ERRTEXT
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses.
7.6.2.6.2 This message does not provide any return
parameters (list item 3 of the S14F20 message has zero
length).
Table 7 Generic Service Request for
GetActivePlanIds
Field Name Value
OPID 0
OBJSPEC “DataCollectionManager”
SVCNAME “GetActivePlanIds”
SEMI PR8-0703 © SEMI 2003 12
Table 8 Generic Service Acknowledge for
GetActivePlanIds
Field Name Value
SVCACK 0, 2, 5
Use 5 only when data management
configuration switch is not set to SECS/GEM
LINKID 0
SPNAME
1
“ActivePlanIds”
SPVAL
1
L,n n=number of active DCPs
1. <OBJID
1
>
2. <OBJID
2
>
.
.
.
n. <OBJID
n
>
Each plan id is a separate entry (format 20)
in this list.
ERRCODE
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
ERRTEXT
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
Table 9 Generic Service Request for
GetDefinedPlanIds
Field Name Value
OPID 0
OBJSPEC “DataCollectionManager”
SVCNAME “GetDefinedPlanIds”
Table 10 Generic Service Acknowledge for
GetDefinedPlanIds
Field Name Value
SVCACK 0, 2, 5
Use 5 only when data management
configuration switch is not set to SECS/GEM
LINKID 0
SPNAME
1
“DefinedPlanIds”
SPVAL
1
L,n n=number of defined DCPs
1. <OBJID
1
>
2. <OBJID
2
>
.
.
.
n. <OBJID
n
>
Each plan id is a separate entry (format 20)
in this list.
Field Name Value
ERRCODE
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
ERRTEXT
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
Table 11 Generic Service Request for ActivatePlan
Field Name Value
OPID 0
OBJSPEC “DataCollectionManager”
SVCNAME “ActivatePlan”
SPNAME
1
“PlanID”
SPVAL
1
<OBJID>, Format 20, equal to the id of the
plan to be activated
SPNAME
2
“UntilDeactivated”
SPVAL
2
<ACKA>, set to true if DCP should remain
active across shutdowns
Table 12 Generic Service Acknowledge for
ActivatePlan
Field Name Value
SVCACK 0, 2, 3, 5
Use 5 only when data management
configuration switch is not set to SECS/GEM
LINKID 0
SPNAME
1
“IsActivated”
SPVAL
1
<ACKA>, set to true if the requested plan is
activated
ERRCODE
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
ERRTEXT
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for
error responses
Table 13 Generic Service Request for
DeactivatePlan
Field Name Value
OPID 0
OBJSPEC “DataCollectionManager”
SVCNAME “DeactivatePlan”
SPNAME
1
“PlanID”
SPVAL
1
<OBJID>, Format 20, equal to the id of the
plan to be activated
SEMI PR8-0703 © SEMI 2003 13
Table 14 Generic Service Acknowledge for
DeactivatePlan
Field Name Value
SVCACK 0, 2, 3, 5
Use 5 only when data management
configuration switch is not set to SECS/GEM
LINKID 0
SPNAME
1
“DeactivatedPlanIds”
SPVAL
1
L,n n=number of deactivated DCP’s
1. <OBJID
1
>
2. <OBJID
2
>
.
.
.
n. <OBJID
n
>
Each plan id is a separate entry (format 20) in
this list.
ERRCODE
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for error
responses
ERRTEXT
n
Supplier chooses the number and value of
ERRCODE
n
and ERRTEXT
n
entries for error
responses
7.6.2.7 EDA Data Management via SOAP — The EDA
client may also perform EDA data management via
SOAP. Data management requests issued from an
EDA client to the equipment via SOAP will apply to
the data port associated with that client.
7.6.2.7.1 EDA Data Management Message Structure
— The data management messages from an EDA client
will be structured in the same way as the data
acquisition messages defined below in Section 7.7.2.
The XML fragments inside the SOAP body element are
structured as described in Tables 15 and 16.
7.6.2.7.2 XML Definition of Data Management Requests
Table 15 XML Data Management Request Definition
Tag Name Description XML Datatype Behavior
IsEda-
Enabled
GetDefined-
PlanIds
GetActive-
PlanIds
ActivatePlan Deactivate-
Plan
see columns 4-8
in this row for
tag names, shown
in quotes
Operation Name
Element
Complex
Required-
“IsEda-
Enabled”
Required-
“GetDefined
PlanIds”
Required-
“GetActive-
PlanIds”
Required-
“Activate-
Plan”
Required-
“Deactivate-
Plan”
EquipmentID EquipmentID element Complex Required Required Required Required Required
PlanID Data collection plan to
be activated or
deactivated (“ALL” is
reserved for
DeactivatePlan)
String N/A N/A N/A Required Required
UntilDeactivated Indicates mode of
activation
Boolean N/A N/A N/A Required N/A