semi合集-English.pdf - 第1819页

SEMI E42-0704 © SEMI 1995, 2004 88 zero value, and the value set in the parameter RMOpID shall be retai ned for use i n RMNComplete. The parameters for RMNAction are listed in Table 12.14. Table 12.14 RMNAction Parameter…

SEMI E42-0704 © SEMI 1995, 2004 87

updated body. If the requested recipe identifier is used

by a read-only recipe, the request shall be denied.

The parameters for RMNUpdate are listed in Table

12.9.

Table 12.9 RMNCreate and RMNUpdate

Parameter

Req/

Ind

Rsp/

Conf

Description

RMRcpSpec M - Recipe specifier.

(List of)

AttrSetting

M - List of recipe attributes required

for create/update.

BodySection M - Recipe body.

NSStatus - M Information concerning the

result of the requested operation.

12.11 RMNStore — The service user may request to

store a recipe in a namespace. If the recipe identifier is

already in use by a read-only recipe in the namespace,

or if the namespace has insufficient space for storing

the recipe, request shall be denied.

The parameters for RMNRetrieve are listed in Table

12.10.

Table 12.10 RMNStore

Parameter

Req/

Ind

Rsp/

Conf

Description

RMRcpSpec M - The recipe specifier.

RMSectionsCode M - Indicates which sections

sent.

RMSectionsSent M - Contents of all sections to

be sent.

NSStatus - M Information concerning the

result of the requested

operation.

12.12 RMNRetrieve — The service user may request to

receive a recipe in its entirety (including all agent-

specific datasets), the generic attributes with or without

the body but without agent-specific datasets, a

particular agent-specific dataset, or all agent-specific

datasets.

The parameters for RMNRetrieve are listed in Table

12.11.

Table 12.11 RMNRetrieve

Parameter

Req/

Ind

Rsp/

Conf

Description

RMRcpSpec M - The recipe specifier.

RMSectionsRequested M - Indicates which sections

are requested.

RMSectionsSent - M Contents of all sections

to be sent.

NSStatus - M Information concerning

the result of the

requested operation.

12.13 RMNCopy — The service user may request to

copy a recipe in a namespace to another recipe within

the same namespace. If a read-only recipe with the

specified Destination ID exists, an Access Denied error

shall be returned.

The parameters for RMNCopy are listed in Table 12.12.

12.14 RMNRename — The service user may request to

rename a recipe in a namespace if the recipe is not

write-protected. If the recipe is write-protected, then an

Access Denied error shall be returned.

The parameters for RMNRename are listed in Table

12.12.

Table 12.12 RMNCopy, RMNRename

Parameter

Req/

Ind

Rsp/

Conf

Description

RMRcpSpec M - Specifier of the recipe to be

copied or renamed (source).

RMDestRcpID M - The identifier for the recipe

to be originated (destination).

NSStatus - M Information concerning the

result of the requested

operation.

12.15 RMNAction — RMNAction is used to request the

performance of one of the following actions

(operations) on one or more recipes: delete, protect,

verify, link, unlink, certify, de-certify, download to a

specified agent, and upload from a specified agent.

Where more than one recipe is specified, operations

shall be performed on each recipe in the requested

order.

If performance of the requested action is likely to take

more time to complete than is normally allowed

between a request message and the corresponding

response, then the namespace manager should respond

with an intent to comply at the earliest opportunity

before it begins the requested operation. Immediately

following the completion of the operation on each of

the specified recipes, the manager shall send a

notification message RMNComplete to the service

requestor, providing the results of that operation

together with information concerning any errors

causing abnormal completion of the operation. Error

information is important for diagnosis and correction of

problems. Figure 12.2 in Section 12.2 shows an

example of the message flow for the download

operation performed on two recipes.

The parameter LinkID is set to a zero value in the

response if the operations have been completed and no

notifications will be sent. Otherwise, it is set to a non-

SEMI E42-0704 © SEMI 1995, 2004 88

zero value, and the value set in the parameter RMOpID

shall be retained for use in RMNComplete.

The parameters for RMNAction are listed in Table

12.14.

Table 12.14 RMNAction

Parameter

Req/

Ind

Rsp/

Conf

Description

RMNSSpec M - Target namespace specifier.

RMAction M M(=) Action.

RMOpID C C(=) Operation ID, used where

multiple confirmations may

occur. May be null or omitted

where the service initiator does

not request a new service until

all confirmations for the

outstanding service have been

received.

(List of)

RMRcpID

M - Identifier of the target recipe.

RMAgent C C(=) Omitted, except for certify, de-

certify, download, upload.

RMLinkID - M LinkID is set to zero if, and only

if, no further completion

messages will be required.

NSStatus - M Information concerning the

result of the requested operation.

12.16 RMNVarPar — The service user may request to

set agent-specific variable parameter definitions.

NOTE: Modification of the parameter restrictions in a

variable parameter definition shall reset the Certified

attribute for that agent.

The parameters for RMNVarPar are listed in Table

12.15.

Table 12.15 RMNVarPar

Parameter

Req/

Ind

Rsp/

Conf

Description

RMRcpSpec M - Specifier of the target recipe.

RMAgent M - Agent name (identifier).

(List of)

RMParam

M - Variable parameter definition.

NSStatus - M Information concerning the

result of the requested operation.

12.17 RMNGetDescriptor — The service user may

request the descriptors of one or more recipes.

The parameters for RMNGetDescriptor are listed in

Table 12.13.

Table 12.13 RMNGetDescriptor

Parameter

Req/

Ind

Rsp/

Conf

Description

RMNSSpec M -

Target namespace specifier.

(List of)

RMRcpID

M - Identifier of the target recipe.

(List of)

RMDesc

- M Requested recipe descriptor(s)

in the same order as requested.

NSStatus - M Information concerning the

result of the requested operation.

12.18 RMNComplete — The service provider notifies

the service user that an action requested by the service

user has completed.

The parameter RMOpID is retained from the initial

request message RMNAction.

The parameter LinkID is set to a non-zero value for all

notifications except the notification of completion of

the last operation performed. A zero value indicates that

no further notifications will be sent.

The parameters for RMNComplete are listed in Table

12.16.

Table 12.16 RMNComplete

Parameter

Req/

Ind

Rsp/

Conf

Description

RMOpID C(=) - Operation ID, used where

multiple completion messages

may occur, corresponding to

the value in the original

request. May be null or

omitted where the service

initiator does not request a

new service until all

confirmations for the

outstanding service have been

received.

RMLinkID M - LinkID is set to zero if, and

only if, no further completion

messages will be required.

RMRcpSpe

- C Specifier of the changed

recipe. Indicates namespace

and recipe identifiers.

RMChange

Status

M - State of the changed recipe.

(List of)

AttrSettings

C - Attributes of particular interest

to the result. Varies with

action.

NSStatus M - Information conerning the

result of the requested

operation.

13 Distributed Recipe Namespace Services

This section defines the new message services required for implementation of distributed recipe namespace

services. Table 13.1 lists the messages, the type of each message (request or notification), and provides a brief

description.

Table 13.1 Distributed Recipe Namespace Services

Message Service Name Type Description

DRNS Segment Services

Attach R A manager requests Distributed Recipe Namespace Segment to attach to the

manager. (OSS service)

Create R An authorized user requests to create Distributed Recipe Namespace Segment.

(OSS service)

Delete R An authorized user requests to delete Distributed Recipe Namespace Segement.

(OSS service)

Detach R A manager requests Distributed Recipe Namespace Segment to detach from the

manager. (OSS service)

RMDSApproveAction R A segment’s manager approves an earlier change request.

DRNS Recorder Services

Attach R A manager requests Recorder to attach the manager. (OSS service)

AttachSetAttr R A manager requests Recorder to set one or more attributes whenever it is

attached to the manager. (OSS service)

Create R An authorized user requests to create Recorder. (OSS service)

Delete R An authorized user requests to delete Recorder. (OSS service)

Detach R A manager requests Recorder to detach from the manager. (OSS service)

Reattach R A manager requests Recorder to reattach to the manager. (OSS service)

RMDRAddSegRecord R A manager requests a recorder to add a segment specifier to its Segments

attribute.

RMDRDelSegRecord R A manager requests a recorder to delete a segment specifier from its Segments

attribute.

RMDRAddChgRecord R A manager requests a recorder to add a change request record for a specified

recipe.

RMDRDelChgRecord R A manager requests a recorder to delete a change request record for a specified

recipe.

RMDRGetChgRecord R A service user requests change request for a recipe or segment.

DRNS Manager Services

AttachSupervisedObject R An authorized user requests to attach Distributed Recipe Namespace Segment or

Recorder. (OSS service)

DetachSupervisedObject R An authorized user requests to detach Distributed Recipe Namespace Segment or

Recorder. (OSS service)

RMDComplete N An attached segment notifies its manager that an approved change has been

completed.

RMDNotify N An attached dedicated segment notifies its manager that an agent-specific dataset

has been changed.

RMDGetChgRequest R A request is made for change request information for a recipe.

RMDSegChange R An attached segment requests approval for a specified type of change to a recipe.

RMDRebuild R A request is made for a new manager to rebuild an existing distributed

namespace.