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.