Issue 7940: Resource Deployment Description Clarification                                                                                                                                                           (deployment-rtf)
Source: Mercury Computer Systems (Mr. Frank Pilhofer, fpilhofe@mc.com)
Nature: Clarification
Severity: 
Summary: Sections 6.8.9, 6.8.10 and 6.8.11 describe the ResourceDeployment-
Description, InstanceResourceDeploymentDescription and Connection-
ResourceDeploymentDescription elements, which identify the resources
that were chosen to satisfy a requirement.


There are three minor editorial issues here:


(1)


In 6.8.11.2 (ConnectionResourceDeploymentDescription Attributes),
the targetName attribute always identifies an Interconnect or a Bridge,
but never a Node.


Proposed resolution:


Update the description for the targetName attribute; change the text
in parentheses from


  (i.e., the name of a Node, Interconnect or Bridge)


to


  (i.e., the name of an Interconnect or Bridge)



(2)


Also in 6.8.11.2 (ConnectionResourceDeploymentDescription Attributes),
the targetName provides a scope for the resource, not for a requirement.


Proposed resolution:


Update the description for the targetName attribute; change the
second half of the first sentence (after the comma) from


  [...], to provide scope for the requirementName.


to


  [...], to provide scope for the resourceName.



(3)


Finally, I'd like to clarify in section 6.8.10 (InstanceResource-
DeploymentDescription) that the resourceName is within the scope of
the node that this instance is deployed on.


Proposed resolution:


In section 6.8.10.5 (InstanceResourceDeploymentDescription semantics),
add the following text:


  An InstanceResourceDeploymentDescription is always used in the context
  of an InstanceDeploymentDescription, which identifies the node that a
  component instance is deployed on. This node provides scope for the
  resourceName.
Resolution: 
Revised Text: In section 6.8.11.2, update the description for the targetName attribute; change the text in parentheses from

    (i.e., the name of a Node, Interconnect or Bridge)

to

    (i.e., the name of an Interconnect or Bridge)


Also section in 6.8.11.2, update the description for the targetName attribute; change the second half of the first sentence (after the comma) from

    [...], to provide scope for the requirementName.

to

    [...], to provide scope for the resource Name.


In section 6.8.10.5, add the following text:

    An InstanceResourceDeploymentDescription is always used in the 
    context of an InstanceDeploymentDescription, which identifies the 
    node that a component instance is deployed on. This node provides 
    scope for the resourceName.

Actions taken:
November 19, 2004: received issue
May 9, 2005: closed issue
Discussion: 
Resolution:
Change the text as proposed.

End of Annotations:=====
ubject: Resource Deployment Description Clarification 
Date: Fri, 19 Nov 2004 14:56:39 -0500 
Thread-Topic: Resource Deployment Description Clarification 
Thread-Index: AcTOceGs3Wt+0x7dSP6g7wDY9/qoYA== 
From: "Pilhofer, Frank" <fpilhofe@mc.com> 
To: <issues@omg.org> 
Cc: "Deployment RTF" <deployment-rtf@omg.org> 
X-MIME-Autoconverted: from quoted-printable to 8bit by amethyst.omg.org id iAJKKS1U010081 


Sections 6.8.9, 6.8.10 and 6.8.11 describe the ResourceDeployment-
Description, InstanceResourceDeploymentDescription and Connection-
ResourceDeploymentDescription elements, which identify the resources
that were chosen to satisfy a requirement.


There are three minor editorial issues here:


(1)


In 6.8.11.2 (ConnectionResourceDeploymentDescription Attributes),
the targetName attribute always identifies an Interconnect or a Bridge,
but never a Node.


Proposed resolution:


Update the description for the targetName attribute; change the text
in parentheses from


  (i.e., the name of a Node, Interconnect or Bridge)


to


  (i.e., the name of an Interconnect or Bridge)



(2)


Also in 6.8.11.2 (ConnectionResourceDeploymentDescription Attributes),
the targetName provides a scope for the resource, not for a requirement.


Proposed resolution:


Update the description for the targetName attribute; change the
second half of the first sentence (after the comma) from


  [...], to provide scope for the requirementName.


to


  [...], to provide scope for the resourceName.



(3)


Finally, I'd like to clarify in section 6.8.10 (InstanceResource-
DeploymentDescription) that the resourceName is within the scope of
the node that this instance is deployed on.


Proposed resolution:


In section 6.8.10.5 (InstanceResourceDeploymentDescription semantics),
add the following text:


  An InstanceResourceDeploymentDescription is always used in the context
  of an InstanceDeploymentDescription, which identifies the node that a
  component instance is deployed on. This node provides scope for the
  resourceName.