webdds_sections_7313_to_7316

advertisement

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].

Download