9.2.4 Remote change of an MCVideo user’s selected group

24.2813GPPMission Critical Video (MCVideo) signalling controlProtocol specificationRelease 18TS

9.2.4.1 General

Clause 9.2.4 specifies the MCVideo client procedures, participating MCVideo function procedures and controlling MCVideo function procedures for the on-network remote change of an MCVideo user’s selected group.

9.2.4.2 Client procedures

9.2.4.2.1 Remote selected group change initiation

Upon receiving a request from the MCVideo user to send a group selection change request to change the selected group of a targeted MCVideo user to a specific MCVideo group, the MCVideo client:

1) if:

a) the <RemoteGroupSelectionURIList> element does not exist in the MCVideo user profile document with one or more <entry> elements (see the MCVideo user profile document in 3GPP TS 24.484 [25]); or

b) the <RemoteGroupSelectionURIList> element exists in the MCVideo user profile document and the MCVideo ID of the targeted MCVideo user does not match with one of the <entry> elements of the <RemoteGroupSelectionURIList> element of the MCVideo user profile document (see the MCVideo user profile document in 3GPP TS 24.484 [25]);

then:

a) should indicate to the requesting MCVideo user that they are not authorised to change the selected MCVideo group of the targeted MCVideo user; and

b) shall skip the rest of the steps of the present clause;

1A) shall determine whether the group document associated with the specific MCVideo group contains a <list-service> element that contains a <preconfigured-group-use-only> element. If a <preconfigured-group-use-only> element exists and is set to the value "true", then the MCVideo client:

a) should indicate to the MCVideo user that calls are not allowed on the specific MCVideo group; and

b) shall skip the remainder of this procedure;

2) shall generate a SIP MESSAGE request in accordance with 3GPP TS 24.229 [11] and IETF RFC 3428 [17] with the following clarifications:

a) shall include the ICSI value "urn:urn-7:3gpp-service.ims.icsi.mcvideo" (coded as specified in 3GPP TS 24.229 [11]), in a P-Preferred-Service header field according to IETF RFC 6050 [14] in the SIP MESSAGE request;

b) shall include an Accept-Contact header field with the g.3gpp.icsi-ref media feature tag containing the value of "urn:urn-7:3gpp-service.ims.icsi.mcvideo" along with the "require" and "explicit" header field parameters according to IETF RFC 3841 [20];

c) may include a P-Preferred-Identity header field in the SIP MESSAGE request containing a public user identity as specified in 3GPP TS 24.229 [11]; and

d) shall include an application/vnd.3gpp.mcvideo-info+xml MIME body as specified in clause F.1 with the <mcvideoinfo> element containing the <mcvideo-Params> element containing:

i) the <mcvideo-request-uri> set to the MCVideo group identity to be selected by the targeted MCVideo user; and

ii) an <anyExt> element containing the <request-type> element set to a value of "group-selection-change-request"; and

e) shall insert in the SIP MESSAGE request an application/resource-lists+xml MIME body with the MCVideo ID of the targeted MCVideo user a "uri" attribute of an <entry> element of a <list> element of the <resource-lists> element in the application/resource-lists+xml MIME body, according to the rules and procedures of IETF RFC 5366 [37];

4) shall send the SIP MESSAGE request according to the rules and procedures of 3GPP TS 24.229 [11].

3) shall set the Request-URI to the public service identity identifying the participating MCVideo function serving the MCVideo user; and

4) shall send the SIP MESSAGE request according to rules and procedures of 3GPP TS 24.229 [11].

Upon receipt of a SIP 4xx, 5xx or 6xx response to the SIP MESSAGE request, should indicate to the MCVideo user the failure of the sent group selection change request and not continue with the rest of the steps.

Upon receiving a "SIP MESSAGE request for group selection change response for terminating client", the MCVideo client:

1) shall determine the success or failure of the sent group selection change request from the value of the <selected-group-change-outcome> element contained in the <anyExt> element of the <mcvideo-Params> element of the <mcvideoinfo> element of the application/vnd.3gpp.mcvideo-info+xml MIME body included in the received SIP MESSAGE request; and

2) should indicate to the MCVideo user the success or failure of the sent group selection change request.

9.2.4.2.2 Target client procedures for handling remote selected group change request

Upon receiving a "SIP MESSAGE request for group selection change request for terminating client", the MCVideo client:

1) if the received SIP MESSAGE request contains an application/vnd.3gpp.mcvideo-info+xml MIME body containing an <affiliation-required> element set to a value of "true":

a) shall invoke the procedures of clause 8.2.1.2 to affiliate to the MCVideo group identified by the contents of the <mcvideo-calling-group-id> included in the application/vnd.3gpp.mcvideo-info+xml MIME body;

b) if the MCVideo client has not already invoked the procedures of clause 8.2.1.3, shall invoke the procedures of clause 8.2.1.3; and

c) upon receiving a SIP NOTIFY request including a <p-id> element set to a value matching the <p-id> value included in the SIP PUBLISH request sent in step 1) a) above as specified in clause 8.2.1.3, shall determine if the affiliation procedure to the MCVideo group identified by the contents of the <mcvideo-calling-group-id> in the received SIP MESSAGE request was successful;

2) if the received SIP MESSAGE request contained an application/vnd.3gpp.mcvideo-info+xml MIME body containing an <affiliation-required> element set to a value of "true" and the affiliation was successful as determined in step 1) c) above, or if the <affiliation-required> element was not present in the received SIP MESSAGE request:

a) shall change the MCVideo client’s selected group to the MCVideo group identified by the contents of the <mcvideo-calling-group-id> element contained in the application/vnd.3gpp.mcvideo-info+xml MIME body included in the received SIP MESSAGE request; and

b) shall determine the success or failure of the change of selected group action;

3) shall generate a SIP MESSAGE request in accordance with 3GPP TS 24.229 [11] and IETF RFC 3428 [17] with the following clarifications:

a) shall include the ICSI value "urn:urn-7:3gpp-service.ims.icsi.mcvideo" (coded as specified in 3GPP TS 24.229 [11]), in a P-Preferred-Service header field according to IETF RFC 6050 [14] in the SIP MESSAGE request;

b) shall include an Accept-Contact header field with the g.3gpp.icsi-ref media feature tag containing the value of "urn:urn-7:3gpp-service.ims.icsi.mcvideo" along with the "require" and "explicit" header field parameters according to IETF RFC 3841 [20];

c) may include a P-Preferred-Identity header field in the SIP MESSAGE request containing a public user identity as specified in 3GPP TS 24.229 [11];

d) shall include in an application/resource-lists+xml MIME body, the MCVideo ID contained in the <mcvideo-calling-user-id> element in the application/ vnd.3gpp.mcvideo-info+xml MIME body of the received SIP MESSAGE request in a "uri" attribute of an <entry> element of a <list> element of the <resource-lists> element in the application/resource-lists+xml MIME body; and

e) shall include an application/vnd.3gpp.mcvideo-info+xml MIME body as specified in clause F.1 with the <mcvideoinfo> element containing the <mcvideo-Params> element containing:

i) the <mcvideo-request-uri> set to the MCVideo group identity identified by the contents of the <mcvideo-calling-group-id> element contained in the received SIP MESSAGE request; and

ii) an <anyExt> element containing:

A) the <response-type> element set to a value of "group-selection-change-response";

B) if the MCVideo client was able to successfully change the selected group as determined in step 2) b) above, include a <selected-group-change-outcome> element set to a value of "success"; or

C) if the MCVideo client:

I) was required to affiliate to the MCVideo group identified by the contents of the <mcvideo-calling-group-id> in the received SIP MESSAGE request and the affiliation failed as determined in step 1) c); or

II) failed to change the selected group as determined in step 2) b);

then a <selected-group-change-outcome> element set to a value of "fail";

4) should indicate to the MCVideo user the success or failure of the requested change of selected group action;

5) shall set the Request-URI to the public service identity identifying the participating MCVideo function serving the MCVideo user; and

6) shall send the SIP MESSAGE request according to the rules and procedures of 3GPP TS 24.229 [11].

9.2.4.3 Participating MCVideo function procedures

9.2.4.3.1 Originating procedures

Upon receiving a "SIP MESSAGE request for group-selection-change for originating participating MCVideo function" the participating MCVideo function:

1) if unable to process the request due to a lack of resources or a risk of congestion exists, may reject the SIP MESSAGE request with a SIP 500 (Server Internal Error) response. The participating MCVideo function may include a Retry-After header field to the SIP 500 (Server Internal Error) response as specified in IETF RFC 3261 [15] and skip the rest of the steps;

2) shall determine the MCVideo ID of the calling user from the public user identity in the P-Asserted-Identity header field of the SIP MESSAGE request, and shall authorise the calling user;

NOTE 1: The MCVideo ID of the calling user is bound to the public user identity at the time of service authorisation, as documented in clause 7.3.

3) if the "SIP MESSAGE request for group selection change for originating participating MCVideo function" contains the <request-type> element set to a value of "group-selection-change-request":

a) if:

i) the <RemoteGroupSelectionURIList> element does not exist in the MCVideo user profile document with one or more <entry> elements (see the MCVideo user profile document in 3GPP TS 24.484 [25]); or

ii) if the MCVideo ID contained in the <mcvideo-request-uri> element contained in the application/vnd.3gpp.mcvideo-info+xml MIME body included in the received "SIP MESSAGE request for group selection change for originating participating MCVideo function" does not match with one of the <entry> elements of the <RemoteGroupSelectionURIList> element of the MCVideo user profile document (see the MCVideo user profile document in 3GPP TS 24.484 [25]);

then:

i) shall reject the SIP MESSAGE request with a SIP 403 (Forbidden) response including warning text set to "155 user not authorised to change user’s selected group" in a Warning header field as specified in clause 4.4, and not continue with the rest of the steps in this clause;

4) shall determine the public service identity of the controlling MCVideo function associated with the group identity contained in the <mcvideo-request-uri> element contained in the application/vnd.3gpp.mcvideo-info+xml MIME body;

NOTE 2: The public service identity can identify the controlling MCVideo function in the local MCVideo system or in an interconnected MCVideo system.

NOTE 3: If the controlling MCVideo function is in an interconnected MCVideo system in a different trust domain, then the public service identity can identify the MCVideo gateway server that acts as an entry point in the interconnected MCVideo system from the local MCVideo system.

NOTE 4: If the controlling MCVideo function is in an interconnected MCVideo system in a different trust domain, then the local MCVideo system can route the SIP request through an MCVideo gateway server that acts as an exit point from the local MCVideo system to the interconnected MCVideo system

NOTE 5: How the participating MCVideo function determines the public service identity of the controlling MCVideo function associated with the group identity or of the MCVideo gateway server in the interconnected MCVideo system is out of the scope of the present document.

NOTE 6: How the local MCVideo system routes the SIP request through an exit MCVideo gateway server is out of the scope of the present document.

5) shall generate a SIP MESSAGE request in accordance with 3GPP TS 24.229 [11] and IETF RFC 3428 [17];

6) shall set the Request-URI of the outgoing SIP MESSAGE request to the public service identity of the controlling MCVideo function determined in step 4);

NOTE 7: The public service identity can identify the controlling function in the local MCVideo system or in an interconnected MCVideo system.

NOTE 8: If the controlling MCVideo function is in an interconnected MCVideo system in a different trust domain, then the public service identity can identify the MCVideo gateway server that acts as an entry point in the interconnected MCVideo system from the local MCVideo system.

NOTE 9: If the controlling MCVideo function is in an interconnected MCVideo system in a different trust domain, then the local MCVideo system can route the SIP request through an MCVideo gateway server that acts as an exit point from the local MCVideo system to the interconnected MCVideo system.

NOTE 10: How the participating MCVideo function determines the public service identity of the controlling MCVideo function associated with the group identity or of the MCVideo gateway server in the interconnected MCVideo system is out of the scope of the present document.

NOTE 11: How the local MCVideo system routes the SIP request through an exit MCVideo gateway server is out of the scope of the present document.

7) shall copy the contents of the application/vnd.3gpp.mcvideo-info+xml MIME body in the received SIP MESSAGE request into an application/vnd.3gpp.mcvideo-info+xml MIME body as specified in clause F.1 included in the outgoing SIP MESSAGE request;

8) shall copy the contents of the application/resource-lists+xml MIME body into the outgoing SIP MESSAGE request;

9) shall set the <mcvideo-calling-user-id> element of the <mcvideoinfo> element containing the <mcvideo-Params> element to the MCVideo ID determined in step 2) above;

10) shall set the P-Asserted-Identity in the outgoing SIP MESSAGE request to the public user identity in the P-Asserted-Identity header field contained in the received SIP MESSAGE request;

11) shall include an Accept-Contact header field containing the g.3gpp.mcvideo media feature tag along with the "require" and "explicit" header field parameters according to IETF RFC 3841 [20];

12) shall include an Accept-Contact header field with the media feature tag g.3gpp.icsi-ref with the value of "urn:urn-7:3gpp-service.ims.icsi.mcvideo" along with parameters "require" and "explicit" according to IETF RFC 3841 [20];

13) shall include the ICSI value "urn:urn-7:3gpp-service.ims.icsi.mcvideo" (coded as specified in 3GPP TS 24.229 [11]), into the P-Asserted-Service header field of the outgoing SIP MESSAGE request; and

14) shall send the SIP MESSAGE request as specified to 3GPP TS 24.229 [11].

Upon receipt of a SIP 2xx response in response to the sent SIP MESSAGE request, the participating MCVideo function shall generate a SIP 200 (OK) response and forward the SIP 200 (OK) response to the MCVideo client.

Upon receipt of a SIP 4xx, 5xx or 6xx response to the SIP MESSAGE request, shall forward the error response to the MCVideo client.

9.2.4.3.2 Terminating procedures

Upon receiving a "SIP MESSAGE request for group-selection-change for terminating participating MCVideo function" the participating MCVideo function:

1) if unable to process the request due to a lack of resources or a risk of congestion exists, may reject the SIP MESSAGE request with a SIP 500 (Server Internal Error) response. The participating MCVideo function may include a Retry-After header field to the SIP 500 (Server Internal Error) response as specified in IETF RFC 3261 [15] and skip the rest of the steps;

2) shall use the MCVideo ID present in the <mcvideo-request-uri> element of the application/vnd.3gpp.mcvideo-info+xml MIME body of the incoming SIP MESSAGE request to retrieve the binding between the MCVideo ID and public user identity;

3) if the binding between the MCVideo ID and public user identity does not exist, then the participating MCVideo function shall reject the SIP MESSAGE request with a SIP 404 (Not Found) response. Otherwise, continue with the rest of the steps;

4) shall generate an outgoing SIP MESSAGE request as specified in clause 6.3.2.2.11;

5) shall include the ICSI value "urn:urn-7:3gpp-service.ims.icsi.mcvideo" (coded as specified in 3GPP TS 24.229 [11]), into the P-Asserted-Service header field of the outgoing SIP MESSAGE request; and

6) shall send the SIP MESSAGE request as specified in 3GPP TS 24.229 [11].

Upon receipt of SIP 2xx responses to the outgoing SIP MESSAGE requests, the participating MCVideo function shall forward the SIP 2xx response to the controlling MCVideo function.

Upon receipt of a SIP 4xx, 5xx or 6xx response to the SIP MESSAGE request, shall forward the response to the controlling MCVideo function.

9.2.4.4 Controlling MCVideo function procedures

Upon receiving:

– a "SIP MESSAGE request for group selection change request for controlling MCVideo function"; or

– a "SIP MESSAGE request for group selection change response for controlling MCVideo function";

the controlling MCVideo function:

1) if unable to process the request due to a lack of resources or a risk of congestion exists, may reject the SIP MESSAGE request with a SIP 500 (Server Internal Error) response. The controlling MCVideo function may include a Retry-After header field to the SIP 500 (Server Internal Error) response as specified in IETF RFC 3261 [15]. Otherwise, continue with the rest of the steps;

2) shall reject the SIP request with a SIP 403 (Forbidden) response and not process the remaining steps if an Accept-Contact header field does not include the g.3gpp.icsi-ref media feature tag containing the value of "urn:urn-7:3gpp-service.ims.icsi.mcvideo";

2A) if the group document contains a <list-service> element that contains a <preconfigured-group-use-only> element that is set to the value "true", shall reject the SIP request with a SIP 403 (Forbidden) response with the warning text set to "167 call is not allowed on the preconfigured group" as specified in clause 4.4 "Warning header field" and skip the rest of the steps;

3) if there is a <request-type> element set to a value of "group-selection-change-request" contained in the <anyExt> element in the <mcvideo-Params> element contained in the <mcvideoinfo> root element contained in the application/vnd.3gpp.mcvideo-info+xml MIME body in the received SIP MESSAGE request:

a) if the MCVideo user identified by the MCVideo ID in a "uri" attribute of an <entry> element of a <list> element of the <resource-lists> element in the application/resource-lists+xml MIME body contained in the SIP MESSAGE request is not affiliated with the MCVideo group identified by the <mcvideo-request-uri> in the application/vnd.3gpp.mcvideo-info+xml MIME body as determined by the procedures of clause 6.3.6:

i) shall determine if the MCVideo user is eligible to be affiliated with the MCVideo group as determined by clause 8.2.2.3.8; and

ii) if the MCVideo user is not eligible for affiliation, shall reject the SIP MESSAGE request with a SIP 403 (Forbidden) response with the warning text set to "120 user is not affiliated to this group" in a Warning header field as specified in clause 4.4 and skip the rest of the steps below;

4) shall generate a SIP MESSAGE request in accordance with 3GPP TS 24.229 [11] and IETF RFC 3428 [17];

5) shall include an Accept-Contact header field containing the g.3gpp.mcvideo media feature tag along with the "require" and "explicit" header field parameters according to IETF RFC 3841 [20];

6) shall include an Accept-Contact header field with the media feature tag g.3gpp.icsi-ref with the value of "urn:urn-7:3gpp-service.ims.icsi.mcvideo" along with parameters "require" and "explicit" according to IETF RFC 3841 [20];

7) shall copy the contents of the application/vnd.3gpp.mcvideo-info+xml MIME body in the received SIP MESSAGE request into an application/vnd.3gpp.mcvideo-info+xml MIME body included in the outgoing SIP MESSAGE request with the following clarifications:

a) shall set the <mcvideo-calling-group-id> to the MCVideo group identity contained in the <mcvideo-request-uri> element contained in the application/vnd.3gpp.mcvideo-info+xml MIME body included in the received SIP MESSAGE request; and

b) shall set the <mcvideo-request-uri> element of the application/vnd.3gpp.mcvideo-info+xml MIME body in the outgoing SIP MESSAGE request to the MCVideo ID of the targeted MCVideo user contained in a "uri" attribute of an <entry> element of a <list> element of the <resource-lists> element in the application/resource-lists+xml MIME body contained in the received SIP MESSAGE request;

8) if the received SIP MESSAGE request is a "SIP MESSAGE request for group selection change request for controlling MCVideo function":

a) if the targeted MCVideo user is not affiliated to the identified MCVideo group and was determined to be eligible to be affiliated with the MCVideo group in step 3) a) i) above, shall include in the application/vnd.3gpp.mcvideo-info+xml MIME body with the <mcvideoinfo> element containing the <mcvideo-Params> element with the <anyExt> element an <affiliation-required> element set to a value of "true";

9) shall set the Request-URI to the public service identity of the terminating participating MCVideo function associated with the targeted MCVideo user;

NOTE 1: The public service identity can identify the terminating participating function in the local MCVideo system or in an interconnected MCVideo system.

NOTE 2: If the terminating participating MCVideo function is in an interconnected MCVideo system in a different trust domain, then the public service identity can identify the MCVideo gateway server that acts as an entry point in the interconnected MCVideo system from the local MCVideo system.

NOTE 3: If the terminating participating MCVideo function is in an interconnected MCVideo system in a different trust domain, then the local MCVideo system can route the SIP request through an MCVideo gateway server that acts as an exit point from the local MCVideo system to the interconnected MCVideo system.

NOTE 4: How the controlling MCVideo function determines the public service identity of the terminating participating MCVideo function associated with the targeted MCVideo user or of the MCVideo gateway server in the interconnected MCVideo system is out of the scope of the present document.

NOTE 5: How the local MCVideo system routes the SIP request through an exit MCVideo gateway server is out of the scope of the present document.

10) shall include a P-Asserted-Service header field with the value "urn:urn-7:3gpp-service.ims.icsi.mcvideo";

11) shall copy the public user identity of the calling MCVideo user from the P-Asserted-Identity header field of the incoming SIP MESSAGE request into the P-Asserted-Identity header field of the outgoing SIP MESSAGE request; and

12) shall send the SIP MESSAGE request according to according to the rules and procedures of 3GPP TS 24.229 [11].

Upon receipt of SIP 2xx responses to the outgoing SIP MESSAGE requests, the controlling MCVideo function shall generate a SIP 200 (OK) response and forward the SIP 200 (OK) response to the originating participating MCVideo function.

Upon receipt of a SIP 4xx, 5xx or 6xx response to the SIP MESSAGE request, controlling MCVideo function shall forward the error response to the originating participating MCVideo function.