Issue 9334: SAD ComponentInstantiation Description Error (swradio-rtf) Source: PrismTech (Mr. Gerald Lee Bickle, jerry.bickle@prismtechusa.com) Nature: Uncategorized Issue Severity: Significant Summary: Section L.6.3.1.2. The description for the component properties is not right for “execparam” types. Section L.6.3.1.2 text should be replaced as follows: “L.6.3.1.2 componentinstantiation. The componentinstantiation element (see Figure L-108) is intended to describe a particular instantiation of a component relative to a componentplacement element. The componentinstantiation’s id attribute uniquely identifies the component. The componentinstantiation element’s id may be referenced by the usesport and providesport elements within the SAD file. It is the component name for the instantiation not the application name. The optional componentproperties element (see Figure L-109) is a list of configure, factoryparam, and/or execparam properties values that are used in creating the component or for the initial configuration of the component. The componentproperty definitions as stated in the corresponding SCD. The following sources will be searched in the given precedence order for initial values for “configure” kind of properties, whose modes are “readwrite” or “writeonly” and "execparam" kind of properties: 1. The componentproperties element of the componentinstantiation element in SAD. The following sources will be searched initial values for the “factoryparam” kind of properties in the given precedence order: 1. The componentinstantiation element’s findcomponent element’s componentresourcefactoryref element’s resourcefactoryproperties element in the SAD The findcomponent element (see Figure L-110) is used to obtain the object reference for the component instance. The two sources for obtaining an object reference are: 1. The componentresourcefactoryref element, which refers to a particular ResourceFactoryComponent componentinstantiation element found in the SAD, which is used to obtain a ResourceComponent instance for this componentinstantiation element. The refid attribute refers to a unique componentinstantiation id attribute. The componentresourcefactoryref element contains an optional resourcefactoryproperties element (see Figure L-111), which specifies the properties “qualifiers”, for the ResourceFactoryComponent create call. 2. The optional findcomponent element should be specified except when there is no object reference for the component instance (e.g., FPGA code). The CORBA Naming Service, which is used to find the component’s object reference. The name specified in the namingservice element is a partial name that is used by the ApplicationFactoryComponent to form the complete context name.” Resolution: Revised Text: In section L.6.3.1.2 componentinstantiation (break out volume 7.6.3.2.1), change the following sentence from "The componentinstantiation element (see Figure L-108) is intended to describe a particular instantiation of a component relative to a componentplacement element. The componentinstantiation's id attribute uniquely identifies the component. The componentinstantiation element's id may be referenced by the usesport and providesport elements within the SAD file. It is the component name for the instantiation not the application name. The optional componentproperties element (see Figure 7.24) is a list of configure, factoryparam, and/or execparam properties values that are used in creating the component or for the initial configuration of the component. The "configure" or "factoryparm" kinds of property definitions as stated in the corresponding SCD. The "execparm" kind of property definitions as stated in the corresponding SPD. The following sources will be searched in the given precedence order for initial values for "configure" kind of properties, whose modes are "readwrite" or "writeonly":: 1. The componentproperties element of the componentinstantiation element in SAD. The following sources will be searched in the given precedence order for initial values for the "execparam" kind of properties: 1. The componentproperties element of the componentinstantiation element in SAD or the componentinstantiation element's findcomponent element's componentresourcefactoryref element's resourcefactoryproperties element in the SAD The following sources will be searched initial values for the "factoryparam" kind of properties in the given precedence order: 1. The componentinstantiation element's findcomponent element's componentresourcefactoryref element's resourcefactoryproperties element in the SAD The findcomponent element (see Figure L-110) is used to obtain the object reference for the component instance. The two sources for obtaining an object reference are: 1. The componentresourcefactoryref element, which refers to a particular ResourceFactoryComponent componentinstantiation element found in the SAD, which is used to obtain a ResourceComponent instance for this componentinstantiation element. The refid attribute refers to a unique componentinstantiation id attribute. The componentresourcefactoryref element contains an optional resourcefactoryproperties element (see Figure L-111), which specifies the properties "qualifiers", for the ResourceFactoryComponent create call. 2. The optional findcomponent element should be specified except when there is no object reference for the component instance (e.g., FPGA code). The CORBA Naming Service, which is used to find the component's object reference. The name specified in the namingservice element is a partial name that is used by the ApplicationFactoryComponent to form the complete context name." to "The componentinstantiation element (see Figure 7.23) is intended to describe a particular instantiation of a component relative to a componentplacement element. The componentinstantiation's id attribute uniquely identifies the component. The componentinstantiation element's id may be referenced by the usesport and providesport elements within the SAD file. The optional componentproperties element (see Figure 7.24) is a list of configure, factoryparam, and/or execparam properties values that are used in creating the component or for the initial configuration of the component. The componentproperty definitions as stated in the corresponding SCD. The following sources will be searched in the given precedence order for initial values for "configure" kind of properties, whose modes are "readwrite" or "writeonly" and "execparam" kind of properties: 1. The componentproperties element of the componentinstantiation element in SAD. The following sources will be searched initial values for the "factoryparam" kind of properties in the given precedence order: 1. The componentinstantiation element's findcomponent element's componentresourcefactoryref element's resourcefactoryproperties element in the SAD The findcomponent element (see Figure 7.25) is used to obtain the object reference for the component instance. The two sources for obtaining an object reference are: 1. The componentresourcefactoryref element, which refers to a particular ResourceFactoryComponent componentinstantiation element found in the SAD, which is used to obtain a ResourceComponent instance for this componentinstantiation element. The refid attribute refers to a unique componentinstantiation id attribute. The componentresourcefactoryref element contains an optional resourcefactoryproperties element (see Figure 7.26), which specifies the properties "qualifiers", for the ResourceFactoryComponent create call. 2. The optional findcomponent element should be specified except when there is no object reference for the component instance (e.g., non-CORBA code). The CORBA Naming Service, which is used to find the component's object reference. The name specified in the namingservice element is a partial name that is used by the ApplicationFactoryComponent to form the complete context name." Actions taken: January 30, 2006: received issue April 19, 2007: closed issue Discussion: Resolution: Reword the L.6.3.1.2 componentinstantiation to correct errors on searching for properties and remove the sentence "It is the component name for the instantiation not the application name." since the sentence is confusing on what is meant or intended. End of Annotations:===== erver-Uuid: C8FB4D43-1108-484A-A898-3CBCC7906230 Subject: PIM and PSM SWRadio Components - XML Issues Date: Mon, 30 Jan 2006 09:13:28 -0500 X-MS-Has-Attach: yes X-MS-TNEF-Correlator: Thread-Topic: PIM and PSM SWRadio Components - XML Issues Thread-Index: AcYlp1dak1KDQpz0SXu8hodwVwe/3w== From: "Jerry Bickle" To: issues@omg.org cc: swradio-rtf@omg.org X-OriginalArrivalTime: 30 Jan 2006 14:13:36.0958 (UTC) FILETIME=[5C9395E0:01C625A7] Issue 3 - SAD ComponentInstantiation Description Error. Section L.6.3.1.2. The description for the component properties is not right for .execparam. types. Section L.6.3.1.2 text should be replaced as follows: .L.6.3.1.2 componentinstantiation. The componentinstantiation element (see Figure L-108) is intended to describe a particular instantiation of a component relative to a componentplacement element. The componentinstantiation.s id attribute uniquely identifies the component. The componentinstantiation element.s id may be referenced by the usesport and providesport elements within the SAD file. It is the component name for the instantiation not the application name. The optional componentproperties element (see Figure L-109) is a list of configure, factoryparam, and/or execparam properties values that are used in creating the component or for the initial configuration of the component. The componentproperty definitions as stated in the corresponding SCD. The following sources will be searched in the given precedence order for initial values for .configure. kind of properties, whose modes are .readwrite. or .writeonly. and "execparam" kind of properties: 1. The componentproperties element of the componentinstantiation element in SAD. The following sources will be searched initial values for the .factoryparam. kind of properties in the given precedence order: 1. The componentinstantiation element.s findcomponent element.s componentresourcefactoryref element.s resourcefactoryproperties element in the SAD The findcomponent element (see Figure L-110) is used to obtain the object reference for the component instance. The two sources for obtaining an object reference are: 1. The componentresourcefactoryref element, which refers to a particular ResourceFactoryComponent componentinstantiation element found in the SAD, which is used to obtain a ResourceComponent instance for this componentinstantiation element. The refid attribute refers to a unique componentinstantiation id attribute. The componentresourcefactoryref element contains an optional resourcefactoryproperties element (see Figure L-111), which specifies the properties .qualifiers., for the ResourceFactoryComponent create call. 2. The optional findcomponent element should be specified except when there is no object reference for the component instance (e.g., FPGA code). The CORBA Naming Service, which is used to find the component.s object reference. The name specified in the namingservice element is a partial name that is used by the ApplicationFactoryComponent to form the complete context name.. X-WSS-ID: 6FC0C08120C651650-12-01