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:

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

N/A

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

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*