5 Mapping
32.3433GPPCommon Object Request Broker Architecture (CORBA) Solution Set (SS)File Transfer (FT) Integration Reference Point (IRP)Telecommunication managementTS
5.1 Operation and Notification mapping
FileTransferIRP: IS 3GPP TS 32.342 [7] defines semantics of operation and notification visible across the FileTransferIRP. Table 1 indicates mapping of these operations and notifications to their equivalents defined in this SS.
Table 1: Mapping from IS Operations and Notification to SS equivalents
IS Operations/ notification 3GPP TS 32.342 [7] | SS Method | Qualifier |
listAvailableFiles | list_available_files | M |
fileDownloadIndication | file_download_indication | O |
getIRPVersion (see note) | get_file_transfer_irp_versions | M |
getOperationProfile (see note) | get_file_transfer_irp_operations_profile | O |
getNotificationProfile (see note) | get_file_transfer_irp_notifications_profile | O |
notifyFileReady | push_structured_events (see subclause 6.1) | M |
notifyFilePreparationError | push_structured_events (see subclause 6.1) | M |
NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [8]. The FileTransferIRP IOC of 3GPP TS 32.342 [7] inherits from it. | ||
5.2 Operation parameter mapping
The FileTransferIRP: IS 3GPP TS 32.342 [7] defines semantics of parameters carried in operations across the FileTransferIRP. The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS.
Table 2: Mapping from IS listAvailableFiles parameters to SS equivalents
IS Operation parameter | SS Method parameter | Qualifier |
managementDataType | short management_data_type | M |
beginTime | FileTransferIRPConstDefs::UTCTime begin_time | M |
endTime | FileTransferIRPConstDefs::UTCTime end_time | M |
fileInfoList | FileTransferIRPConstDefs::FileInfoList file_info_list | M |
status | Return value of type FileTransferIRPConstDefs::Result Exception: ListAvailableFiles, InvalidTimes, ManagedGenericIRPSystem::InvalidParameter | M |
Table 3: Mapping from IS fileDownloadIndication parameters to SS equivalents
IS Operation parameter | SS Method parameter | Qualifier |
fileInfoList | FileTransferIRPConstDefs::FileInfoList file_info_list | M |
status | Return value of type FileTransferIRPConstDefs::Result Exception: FileDownloadIndication, InvalidFileInfoList, ManagedGenericIRPSystem:OperationNotSupported | M |
Table 4: Mapping from IS getIRPVersion parameters to SS equivalents
IS Operation parameter | SS Method parameter | Qualifier |
versionNumberSet | Return value of type ManagedGenericIRPConstDefs::VersionNumberSet | M |
status | Exception: GetFileTransferIRPVersions | M |
Table 5: Mapping from IS getOperationProfile parameters to SS equivalents
IS Operation parameter | SS Method parameter | Qualifier |
iRPVersion | ManagedGenericIRPConstDefs::VersionNumber irp_version | M |
operationNameProfile, operationParameterProfile | Return value of type ManagedGenericIRPConstDefs::MethodList | M |
status | Exception: GetFileTransferIRPOperationsProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter | M |
Table 6: Mapping from IS getNotificationProfile parameters to SS equivalents
IS Operation parameter | SS Method parameter | Qualifier |
iRPVersion | ManagedGenericIRPConstDefs::VersionNumber irp_version | M |
notificationNameProfile, notificationParameterProfile | Return value of type ManagedGenericIRPConstDefs::MethodList | M |
status | Exception: GetFileTransferIRPNotificationsProfile, ManagedGenericIRPSystem::OperationNotSupported, ManagedGenericIRPSystem::InvalidParameter | M |
5.3 Notification parameter mapping
The FileTransferIRP: IS 3GPP TS 32.342 [7] defines semantics of parameters carried in notifications. The following table indicates the mapping of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [9]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [9], is:
Header
Fixed Header
domain_name
type_name
event_name
Variable Header
Body
filterable_body_fields
remaining_body
The following tables list all OMG Structured Event attributes in the second column. The first column identifies the FileTransferIRP: IS 3GPP TS 32.342 [7] defined notification parameters.
Table 7: Mapping for notifyFileReady
IS Parameters | OMG CORBA Structured Event attribute | Qualifier | Comment |
|---|---|---|---|
There is no corresponding IS attribute. | domain_name | M | It carries the IRP document version number string. See subclause 3.1. It indicates the syntax and semantics of the Structured Event as defined by the present document. |
notificationType | type_name | M | This is the ET_FILE_READY of module of FileTransferIRPNotifDefs. |
There is no corresponding IS attribute. | event_name | M | It carries no information. |
There is no corresponding IS attribute. | Variable Header | ||
objectClass, objectInstance | One NV pair of filterable_body_fields | M | NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string. Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
notificationId | One NV pair of remaining_body | M | Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
eventTime | One NV pair of filterable_body_fields | M | Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
systemDN | One NV pair of filterable_body_fields | M | Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
fileInfoList | One NV pair of remaining_body | M | Name of NV pair is the FILE_INFO_LIST of interface NotifyFileReady of module FileTransferIRPNotifications. Value of NV pair is FileInfoList of module FileTransferIRPConstDefs. |
additionalText | One NV pair of remaining_body | O | Name of NV pair is the ADDITIONAL_TEXT interface NotifyFileReady of module FileTransferIRPNotifications. Value of NV pair is a string. |
Table 8: Mapping for notifyFilePreparationError
IS Parameters | OMG CORBA Structured Event attribute | Qualifier | Comment |
|---|---|---|---|
There is no corresponding IS attribute. | domain_name | M | It carries the IRP document version number string. See subclause 3.1. It indicates the syntax and semantics of the Structured Event as defined by the present document. |
notificationType | Type_name | M | This is the ET_FILE_PREPARATION_ERROR of module of FileTransferIRPNotifDefs. |
There is no corresponding IS attribute. | event_name | M | It carries no information. |
There is no corresponding IS attribute. | Variable Header | ||
objectClass, objectInstance | One NV pair of filterable_body_fields | M | NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded in string. Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
notificationId | One NV pair of remaining_body | M | Name of NV pair is the NOTIFICATION_ID of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a long. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
eventTime | One NV pair of filterable_body_fields | M | Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
systemDN | One NV pair of filterable_body_fields | M | Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module NotificationIRPConstDefs. Value of NV pair is a string. See corresponding table in Notification IRP: CORBA SS (3GPP TS 32.303 [5]). |
fileInfoList | One NV pair of remaining_body | M | Name of NV pair is the FILE_INFO_LIST of interface NotifyFilePreparationError of module FileTransferIRPNotifications. Value of NV pair is FileInfoList of module FileTransferIRPConstDefs. |
reason | One NV pair of remaining_body | M | Name of NV pair is the REASON of interface NotifyFilePreparationError of module FileTransferIRPNotifications. Value of NV pair is a string. |
additionalText | One NV pair of remaining_body | O | Name of NV pair is the ADDITIONAL_TEXT of interface NotifyFilePreparationError of module FileTransferIRPNotifications. Value of NV pair is a string. |