7.3.1.3 Operation: get_applications
Inputs
● applicationNameExpression (string): An expression on the name of the
Application.
Outputs
● returnStatus (ReturnStatus): A numeric code indicating success or failure of the operation and a textual description in case of failure.
● applicationRepresentationList (string): A representation of a list of Application objects. The format of the representation shall be defined by each PSM.
This operation returns a representation of the list of all the WebDDS::Application objects associated with the WebDDS::Client whose name matches the applicationNameExpression . If the operation fails, it returns
GENERIC_SERVICE_ERROR, otherwise it returns OK.
Expression syntax and matching for the publisherNameExpression shall use the syntax and rules of the POSIX fnmatch() function as specified in POSIX 1003.2-1992, section
B.6 [19].
7.3.1.4 Operation: create_qos_library
Inputs
● qosLibraryObjectRepresentation (string) a representation of the WebDDS
QosLibrary object including its qosLibraryName and optionally contained
QosProfiles. The format of the representation shall be defined by each PSM. The name of the qosLibraryName shall be unique within the scope of other
QosProfiles.
Outputs
● returnStatus (ReturnStatus): A numeric code indicating success or failure of the operation and a textual description in case of failure.
This operation creates a WebDDS::QosLibrary and the contained QosProfiles.
This operation performs the following logical steps:
It checks if there is already a pre-existing WebDDS::QosLibrary of the specified qosLibraryName within the WebDDS::Root. If a WebDDS::QosLibrary with that name already exists, it returns the OBJECT_ALREADY_EXISTS error.
The operation creates a WebDDS::QosLibrary and all the contained DDS:QosProfile objects specified as part of the qosLibraryObjectRepresentation .
If all the creations are successful, the operation returns OK.
7.3.1.5 Operation: delete_qos_library
Inputs
● qosLibraryName (string): The name of the QosLibrary.
Outputs
● returnStatus (ReturnStatus): A numeric code indicating success or failure of the operation and a textual description in case of failure.
Deletes an existing WebDDS::QosLibrary. This operation performs the following logical steps:
It locates a WebDDS::QosLibrary within the WebDDS::Root with the specified qosLibraryName . If the WebDDS::QosLibrary does not exist, it returns the
INVALID_OBJECT error.
It calls the check_permissions operation to verify that the user is allowed by the access control policies to delete the QosLibrary and contained QosProfiles. If the check fails, it returns PERMISSIONS_ERROR.
If the verification is successful, it deletes the WebDDS::QosLibrary and all associated
QosProfiles. This deletion has no impact on any existing DDS entities that may have already been created and reference the deleted QosLibrary and QosProfiles.
If the deletion fails it returns the DDS_ERROR error.
7.3.1.6 Operation: get_qos_libraries
Inputs
● qosLibraryNameExpression (string): An expression on the name of the
QosLibrary objects.
Outputs
● returnStatus (ReturnStatus): A numeric code indicating success or failure of the operation and a textual description in case of failure.
● qosLibraryObjectRepresentationList (string): A representation of a list of
QosLibrary objects. The format of the representation shall be defined by each
PSM.
This operation returns a representation of the list of all the WebDDS::QosLibrary objects associated with the WebDDS::Root whose name matches the qosLibraryNameExpression . If the operation fails, it returns
GENERIC_SERVICE_ERROR, otherwise it returns OK.
Expression syntax and matching for the qosLibraryNameExpression shall use the syntax and rules of the POSIX fnmatch() function as specified in POSIX 1003.2-1992, section B.6 [19].