objectClass

M

Entity.objectClass

See clause 11.6.1.1.1 for the definition of Entity

objectInstance

M

Entity.objectInstance

See clause 11.6.1.1.1 for the definition of Entity

notificationId

M

—

notificationType

M

"notifyFileReady"

eventTime

M

—

Time when the file, that triggered this notification, was ready for upload.

systemDN

M

fileInfoList

M

List of struct

<

fileLocation (M),

fileCompression (M),

fileSize (O),

fileDataType (M),

fileFormat (M),

fileReadyTime (O),

fileExpirationTime (O),

…jobId (CO)

>

Each element is defined as following:

– "fileLocation": Location of the file. The location may be a directory path or a URL, for example

"\\202.112.101.1\D:\user\Files\<xxx>", or

"ftp://nms.telecom_org.com/datastore/<xxx>,

where <xxx> is the filename.

– "fileCompression": Name of the algorithm used for compressing the file. An empty or absent "fileCompression" parameter indicates the file is not compressed. The MnS producer selects the compression algorithm. It is encouraged to use popular algorithms such as GZIP.

– "fileSize": Size of the file. Its value is a non negative integer. The unit is byte.

– "fileDataType": Type of the management data stored in the file. Allowed values are:

– "PERFORMANCE"

– "TRACE"

– "ANALYTICS"

– "PROPRIETARY"

The value "PERFORMANCE" refers to measurements and KPIs.

– "fileFormat": Identifier of the XML or ASN.1 schema (incl. its version) used to produce the file content.

– "fileReadyTime": Date and time when the file was closed (the last time) and made available on the MnS producer. The file content will not be changed anymore.

– "fileExpirationTime": Date and time after which the file may be deleted. It shall not be empty and shall be later than "fileReadyTime".

– "jobId": Job identifier of the "PerfMetricJob" (TS 28.622 [11]) or "TraceJob" (TS 28.622 [11]) that produced the file. This parameter should be present, when the file is related to a job and that job is represented by a "PerfMetricJob" or "TraceJob". Multiple jobs may share the same job identifier. This may for example be the case for jobs collecting measurements to compuate a KPI or for jobs related to a specific task in some analytics application. Note that a specific job is identified by the objectClass/objectInstance parameters of the notification header.

Information (meta data) about the new file, that became ready for upload and triggered this notification, and information about files, which became ready for upload earlier and are still available for upload when the notification is sent.

additionalText

O

—

Allows a free form text description to be reported as defined in ITU-T Rec. X. 733 [4]

objectClass

M

Entity.objectClass.

See clause 11.6.1.1.1 for the definition of Entity

objectInstance

M

Entity.objectInstance

See clause 11.6.1.1.1 for the definition of Entity.

notificationId

M

—

See Table 11.6.1.1.2-1.

notificationType

M

"notifyFilePreparationError"

eventTime

M

—

Time when the file preparation error occured

systemDN

M

fileInfoList

M

See Table 11.6.1.1.2-1.

Each list item contains information about a file where a file preparation error occurred and that is kept on the MnS producer. Files, that are deleting or not created at all, have no list item.

reason

M

—

Detailed error reason, including

– errorInPreparation

– hardDiskFull

– hardDiskFailure

– tooManyFiles

– collectionTimeOut

– incompleteTruncatedFile

– corruptedFile

– lowMemory

– dataNotAvailable

additionalText

O

—

Allows a free form text description to be reported as defined in ITU-T Rec. X. 733 [4]

consumerReference

M

Reference (address) of the MnS consumer to which the notifications shall be sent.

timeTick

O

Initial value of a timer held by the MnS producer. This value defines the time window within which the MnS consumer intends to invoke the "subscribe" operation again to confirm its subscription. The value "0" shall indicate infinity. In this case the subscription is not terminated by the MnS producer.

Unit is minutes

filter

O

Filter constraint that the MnS producer shall use to filter notifications. The filter can be applied to all parameters of a notification

The filter constraint grammar is solution set dependent

subscriptionId

M

Unambiguous identity of this subscription.

status

M

ENUM (OperationSucceeded, OperationFailedExistingSubscription, OperationFailed)

If subscription is successfully created, status = OperationSuceeded.

If subscription is not created because it is duplicated or conflict with existing subscription(s), status = OperationFailedExistingSubscription

If the operation is failed for any other reason than being duplicated or conflict with existing subscription(s), status = OperationFailed.

operation_failed_existing_subscription

Condition: The subscription is duplicated or conflict with existing subscription(s)

Returned Information: The output parameter status

operation_failed

Condition: The operation failed for any other reason than being duplicated or conflict with subscription(s)

Returned Information: The output parameter status

consumerReference

M

Reference of the MnS consumer whose subscriptions are to be cancelled.

The format of the reference may have dependency on the solution set.

subscriptionId

O

Subscription id returned in the subscribe operation response

If this parameter is absent, all subscriptions made with the same "consumerReference" shall be cancelled.

status

M

ENUM (OperationSucceeded, OperationFailed)

If subscription(s) as identified in the input parameter are cancelled, status = OperationSucceeded.

If the operation is failed, status = OperationFailed.

operation_failed

Condition: the operation is failed

Returned Information: The output parameter status

fileDataType

M

It specifies the type of the management data stored in the file.

For performance data (including measurement data and KPI) files, the value is assigned to "PERFORMANCE".

For trace data files, the value is assigned to "TRACE".

For analytic data files, the value is assigned to "ANALYTICS".

For proprietary data files, the value is assigned to "PROPRIETARY".

beginTime

M

The consumer requests to list information about the available file(s) whose ready time(s) are later or equal to this time.

This parameter is expressed in UTC time.

This parameter indicates date and time.

If this parameter is empty or absent, no restriction on begin time is applied on the file ready time.

endTime

M

The consumer requests to list information about the available file(s) whose ready time(s) are earlier than this time.

This parameter is expressed in UTC time.

This parameter indicates date and time.

If this parameter is empty or absent, no restriction on end time is applied on the file ready time.

fileInfoList

M

See "fileInfoList" defined in notifyFileReady notification (clause 11.6.1.1.1)

status

M

ENUM (Success, Failure)

invalidTimes

Condition: Either "beginTime" or "endTime" is invalid.

Returned information: output parameter status is set to Failure.