Deprecated and removed functions in Unified Management Server

Edit online

Certain capabilities of the Unified Management Server 1.2 are deprecated. Their use is discouraged, and support will be removed in the future. Avoid creating new dependencies that rely on these deprecated functions, and also develop plans to remove the dependencies on such functions.

Note: This section is intended for existing customers of IBM® Db2® DevOps Experience for z/OS® who are upgrading to IBM Db2 CI/CD Expert for z/OS.
Table 1. Removed functions in Unified Management Server
Removed function Recommended alternative Related APAR Target removal date
Registering, updating, or deleting the Db2 applications can stop with multiple errors. The Unified Management Server returns error information by using the following JSON response format:
  • The error field lists the top-level messages
  • The errors field lists the details of each error.

Each error in the errors field has message and localizedMessage fields. The message field contains the message in English and the localizedMessage field contains the translated message.

{
  "error": "Message text 1",
  "errors": [
    {
      "message": "Message text 2",
      "localizedMessage": "Message text 2"
    },
    {
      "message": "Message text 3",
      "localizedMessage": "Message text 3"
    }
  ]
}

This localizedMessage field is deprecated and will be removed. The message field will be updated to list the translated message.

The following REST API endpoints are affected: 
POST /ws/policy/applications/dry-run
POST /ws/policy/applications
PUT /ws/policy/applications
PUT /ws/policy/applications//{appId}/objects/reassign
DELETE /ws/policy/applications
POST /ws/policy/pull-requests/{pullRequestId}/{verb}
 If you use the application REST APIs to automate development processes, parse the message field instead of the localizedMessage field.

If you want to continue using the localizedMessage field, specify X-API-VERSION=1.1.0.8 in REST calls. For more information, see APIs.

Important: If you specify an old version in the X-API-VERSION header, you will not be able to use new features of the application APIs in the future.
 PH44497 March 18, 2022
Table 2. Deprecated functions in Unified Management Server
Deprecated function Recommended alternative Related APAR Target removal date
The security configuration requires the security administrator to create and manage the USERLIST and TEAMLIST profiles. The parameters components.izp.dataset.userList and components.izp.dataset.teamList will be removed to have an alternative security mode that caches stored team, user, and role information from SAF. The default value is set as false for backward compatibility reasons. You should specify true for useSAFOnly to ignore the following parameters:
  • components.izp.dataset.userList
  • components.izp.dataset.teamList

For details, refer to Setting up users and teams.

 PH54452 Beginning August 11, 2023, the use of useSAFOnly set to false is deprecated and will be removed in future maintenance after August 11, 2024.