Issue 7580: DisconnectPort operation                                                                                                                                                                                (swradio-ftf)
Source: PrismTech (Mr. Gerald Lee Bickle, jerry.bickle@prismtechusa.com)
Nature: Uncategorized Issue
Severity: 
Summary:  DisconnectPort operation does not indicate, which required port
the disconnection is for.
Proposed Solution: add requiredPort name parameter to disconnectPort
operation.
Rationale: This is necessary unless connection id is unique at the resource
level not at the required port level.Connection ID and required port name
are parameters for the connectPort operations.

Resolution: 
Revised Text: Resolution:
Add requiredPort name parameter to disconnectPort operation.  This is necessary unless connection id is unique at the resource level not at the required port level. Connection ID and required port name are parameters for the connectPort operations.
Revised Text:
1.	Section 8.1.4.4 (PortConnector), Operations Section
Modify the disconnectPort operation as follows:
From
"disconnectPort (in connectionId: String): {raises = (InvalidPort)}

The disconnectPort operation shall break the connection to the component identified by connectionId. The disconnectPort operation shall raise InvalidPort when connectionId passed to disconnectPort is not connected or associated with the component. This operation does not return a value."
To
"disconnectPort (in requiredPortName: String, in connectionId: String): {raises = (InvalidPort)}

The disconnectPort operation shall break the connection to the component.  The connection is identified by requiredPortName and connectionId.  The disconnectPort operation shall raise InvalidPort when the requiredPortName or connectionId passed to disconnectPort is not connected or associated with the component.  This operation does not return a value."


2.	Section 8.1.4.4 (PortConnector), Semantics Section
Modify the following sentences as follows:
From
"The input connectionId is a unique identifier used by disconnectPort when breaking this specific connection. The connectionId is unique at the component level not at the required port level."
To
"The input connectionId is a unique identifier used by disconnectPort when breaking this specific connection from the required port identified by the input requiredPortName. The connectionId is unique at the required port level."


3.	Rose Model and IDL Files
Modify the synopsis of the PortConnector::disconnectPort operation in the Rose Model and IDL files as described.

Actions taken:
July 13, 2004: received issue
August 2, 2005: closed issue
Discussion: 

End of Annotations:=====
ssue 3: DisconnectPort operation does not indicate, which required port
the disconnection is for.
Proposed Solution: add requiredPort name parameter to disconnectPort
operation.
Rationale: This is necessary unless connection id is unique at the resource
level not at the required port level.Connection ID and required port name
are parameters for the connectPort operations.

Subject: SWRADIO FTF - Proposed Resolution for Issue 7580 
Date: Sat, 16 Oct 2004 10:54:40 -0700 
X-MS-Has-Attach: yes 
X-MS-TNEF-Correlator: 
Thread-Topic: SWRADIO FTF - Proposed Resolution for Issue 7580 
Thread-Index: AcSzqCW0daLITRx1THqBy88xcUz+rQAAAZ8wAAAfViAAABEw4A== 
From: "Hayes, Persnaz N" <persnaz.n.hayes@boeing.com> 
To: <swradio-ftf@omg.org> 
X-OriginalArrivalTime: 16 Oct 2004 17:54:41.0131 (UTC) FILETIME=[361383B0:01C4B3A9] 


Team,

 

Please see attached file.

 

Neli Hayes 
The Boeing Company

Integrated Defense Systems, Network Communication Systems
Software Technical Director and  Principal Software Architect 

 

(714) 762-8768
persnaz.n.hayes@boeing.com 

 

 

 



 Issue 7580 Proposed Resolution.doc 

ISSUE 7580:  DisconnectPort operation does not indicate which required port the disconnection is for. 

PROPOSED RESOLUTION
1.	Section 8.1.4.4 (PortConnector), Operations Section
Modify the disconnectPort operation as follows:
From
.disconnectPort (in connectionId: String): {raises = (InvalidPort)}

The disconnectPort operation shall break the connection to the component identified by connectionId. The disconnectPort operation shall raise InvalidPort when connectionId passed to disconnectPort is not connected or associated with the component. This operation does not return a value..
To
.disconnectPort (in requiredPortName: String, in connectionId: String): {raises = (InvalidPort)}

The disconnectPort operation shall break the connection to the component.  The connection is identified by requiredPortName and connectionId.  The disconnectPort operation shall raise InvalidPort when the requiredPortName or connectionId passed to disconnectPort is not connected or associated with the component.  This operation does not return a value..


2.	Section 8.1.4.4 (PortConnector), Semantics Section
Modify the following sentences as follows:
From
.The input connectionId is a unique identifier used by disconnectPort when breaking this specific connection. The connectionId is unique at the component level not at the required port level..
To
.The input connectionId is a unique identifier used by disconnectPort when breaking this specific connection from the required port identified by the input requiredPortName. The connectionId is unique at the required port level..

3.	Rose Model and IDL Files
Modify the synopsis of the PortConnector::disconnectPort operation in the Rose Model and IDL files as described.