Updating the product license
Usually, the product license is granted for a full year, and is renewed until the end of the contract or a mainframe upgrade. Upgrading to a newer BMC AMI Cloud release does not require a new license. Changing the CPU serial number or model of the mainframe server does require a new license.
The license should be updated in the license file of each active z/OS agent and the management server.
For more information about updating the license file, see the following topics:
- Performing-the-management-server-installation-on-Linux
- Performing the management server installation on zCX
- Performing the agent installation
- Performing-Cloud-Data-Sets-installation
Usually, the output of the z/OS command D M=CPU is required for obtaining a new license. Requests for a new license are available through the BMC AMI Cloud support portal, or your BMC sales representative.
License enforcement
The license is enforced by every action that is performed under the z/OS agent, the z/OS CLI and the management server web UI. When the license expires, only data retrieval actions are allowed. The following table lists the return code and messages for every action in accordance with the license status:
License | Details | Agent | CLI | Web UI |
|---|---|---|---|---|
Valid | All actions | NA | RC 0 | RC 0 |
Expires within 15 days | All actions | A message is displayed at startup and in the UI agent details | RC 0 A message is not displayed, so that automation is not disrupted | An orange message is displayed at the top of all pages |
Expired | LIST RESTORE RECALL | A message is displayed at startup and in the UI agent details | RC 04 A message is displayed for every command | A red message is displayed at the top of all pages |
Expired | BACKUP ARCHIVE FULLDUMP DELETE DELARC BACKDSN DELBACK | A message is displayed at startup and in the UI agent details | RC 08 A message is displayed for every command | A red message is displayed at the top of all pages |
Invalid | Missing Wrong CPUID Wrong format | The agent would not start | RC 16 CLI will not work | A red message is displayed at the top of all pages |
License enforcement for Cloud Data Sets (CDS)
The following table describes the license statuses for CDS:
License | Cloud Data Sets (CDS) |
|---|---|
Valid | NA |
Expires within 15 days | A message is displayed in the M9CDSWK log |
Expired | Creating a new CDS is not allowed. Any existing CDS can be read. A ZM9WJ error message is written to the user job when trying to write a CDS. |
Invalid | M9CDSWK does not start. An invalid license error message is displayed |