Content for TS 24.542 Word version: 19.0.0

A.1 Creating notification channel A.2 Receive notification messages A.3 Delete notification channel A.4 Update notification channel

A (Normative) Parameters for different operations p. 17

A.1 Creating notification channel p. 17

A.1.1 General p. 17

The information in this annex provides a normative description of the parameters which will be sent by SNM-C while creating notification channel request and the parameters which will be sent by SNM-S as a response to request for creating notification channel.

A.1.2 Client side parameters p. 17

The SNM-C shall convey the following parameters while sending request for create notification channel request.

Table A.1.2-1: Client side parameters for create notification channel request

Parameter	Description
Requestor identity	REQUIRED. Represents the identity of the notification management client.
Channel type	REQUIRED. Represents PULL or PUSH method to be used for delivering the notification messages. 0x01: PUSH TYPE 0x02: PULL TYPE
PUSH channel details	OPTIONAL. Represents details of the type of PUSH delivery and its associated data as specified in Table A.1.2-2.
Expiry Time	REQUIRED. Represents the duration the notification channel shall be active (i.e. channel lifetime) as requested by the notification management client.
Pull Notification Message Trigger	OPTIONAL. Represents the application trigger for pulling notification messages. When set to "true", it indicates to the SNM-S about the SNM-C capability to support application trigger to initiate pull notification message procedure. Set to "false" or omitted otherwise. (NOTE)
VAL Id Cluster List	REQUIRED. Represents the list of VAL identities corresponding to the VAL services as specified in Table A.1.2-3.
NOTE: This attribute may be provided if "Channel type" is set to PULL TYPE.

Table A.1.2-2: PUSH channel details information

Parameter	Description
PUSH Callback-URL	REQUIRED. Represents PUSH call back URL where the SNM-S shall push the notification messages received by the VAL server.

Table A.1.2-3: VAL Identity Cluster Info

Parameter	Description
VAL User Identity	REQUIRED. Represents the identity of VAL user within the VAL service.
VAL Service ID	REQUIRED. Represents the Identify of the VAL service.
VAL Application ID	REQUIRED. Represents the Identity of the VAL application residing in the VAL UE.

A.1.3 Server side parameters p. 17

The SNM-S shall convey the following parameters while sending response to the create notification channel request.

Table A.1.3-1: Server side parameters for create notification channel response

Parameter	Description
Notification URL	OPTIONAL. Represents the URL that shall be used by SNM-C to pull notification if the channel type is PULL.
Callback URL	REQUIRED. Represents the URL, which shall be notified to VAL client by SNM-C. Further this URL shall be shared by VAL client to VAL server while subscribing for a VAL services.
Channel Identifier	REQUIRED. Represents the identifier of the newly created notification channel.
Pull Notification Message Trigger	OPTIONAL. Represents the application trigger for pulling notification messages. When set to "true", it indicates the SNM-S is capable to send application trigger to SNM-C to initiate pull notification message procedure. Set to "false" or omitted otherwise. (NOTE)
Expiry Time	OPTIONAL. Represents the duration the notification channel shall be active (i.e. channel lifetime) as requested by the notification management client.
NOTE: This attribute may be provided for PULL notification channel type.

A.2 Receive notification messages p. 18

A.2.1 General p. 18

The information in this annex provides a normative description of the parameters which will be sent by SNM-S to the SNM-C, while sending notification messages over notification channel.

A.2.2 Server side parameters p. 18

The SNM-S shall convey the following parameters while sending the notification messages over notification channel.

Table A.2.2-1: Server side parameters for notification message payload

Parameter	Description
Channel Identifier	REQUIRED. Represents the identifier of the notification channel corresponding to the SNM-C.
VAL Notification Message List	REQUIRED. Represents a list of notification messages. Each notification message represents the message received from VAL servers which is encoded by SNM-S as specified in Table A.2.2-2.

Table A.2.2-2: VAL Notification Message

Parameter	Description
VAL Id Cluster Info	REQUIRED. Represents the VAL identities shared by VAL server along with the VAL notification message which is encoded as specified in Table A.1.2-3.
VAL Notification Message Type	REQUIRED. Represents the content type of the VAL notification message as shared by the VAL server.
VAL Notification Message Length	REQUIRED. Represents the length of the VAL notification message.
VAL Notification Message	REQUIRED. Represents the message received from the VAL server to be notified to the SNM-C.

A.2.3 Client side parameters p. 18

The SNM-C shall convey the following parameters while pulling the notification messages over notification channel.

Table A.2.3-1: Client side parameters for pull notification message

Parameter	Description
Requestor Identity	REQUIRED. Represents the identity of the notification management client.
Channel Identifier	REQUIRED. Represents the identifier of the notification channel corresponding to the SNM-C.

A.2.4 Example for notification message payload p. 19

This clause describes an example for notification message payload defined in clause A.2.2 as follows:

{
  "Channel Identifier": "abcde",
  "VAL Notification Message List": {
    "VAL Notification Message 1":{
      "VAL Id Cluster Info": {
        "VAL User Identity": "aob@example.com",
        "VAL Service ID": "MMTEL services",
        "VAL Application ID": "Call App"
      },
      "VAL Notification Message Type": "text",
      "VAL Notification Message Length": "34",
      "VAL Notification Message": "6 notifications from your friends!"
    },
    "VAL Notification Message 2": {
      "VAL Id Cluster Info": {
        "VAL User Identity": "xyz@example.com",
        "VAL Service ID": "Messaging services",
        "VAL Application ID": "Msg App"
      },
      "VAL Notification Message Type": "text",
      "VAL Notification Message Length": "35",
      "VAL Notification Message": "11 new messages from your contacts!"
    }
  }
}

A.3 Delete notification channel p. 20

A.3.1 General p. 20

The information in this annex provides a normative description of the parameters which will be sent by SNM-C to the SNM-S as part of delete notification channel request over notification channel.

A.3.2 Client side parameters p. 20

The SNM-C shall convey the following parameters while sending request for delete notification channel request.

Table A.3.2-1: Client side parameters for delete notification channel request

Parameter	Description
Requestor identity	REQUIRED. Represents the identity of the notification management client.
Channel Identifier	REQUIRED. Represents the identifier of the notification channel corresponding to the SNM-C to be deleted.
VAL Identity Cluster Info	OPTIONAL. Represents the VAL identities to be deregistered from the notification channel encoded as specified in Table A.1.2-3.

A.4 Update notification channel p. 20

A.4.1 General p. 20

The information in this annex provides a normative description of the parameters which will be sent by SNM-C to the SNM-S as part of update notification channel request over notification channel and the parameters which will be sent by SNM-S as a response to update notification channel request.

A.4.2 Client side parameters p. 20

The SNM-C shall convey the following parameters while sending request for update notification channel request.

Table A.4.2-1: Client side parameters for update notification channel request

Parameter	Description
Requestor identity	REQUIRED. Represents the identity of the notification management client.
Channel Identifier	REQUIRED. Represents the identifier of the notification channel corresponding to the SNM-C to be updated.
Expiry Time	OPTIONAL. Represents the duration the notification channel shall be active.

A.4.3 Server side parameters p. 20

The SNM-S shall convey the following parameters while sending response to the update notification channel request.

Table A.4.3-1: Server side parameters for update notification channel response

Parameter	Description
Expiry Time	OPTIONAL. Represents the duration the notification channel shall be active (i.e. channel lifetime) as indicated by the notification management server.