Work with Authorization Codes

Authorization codes define your rights to use Halcyon products.

The Work with Authorization Codes display lists the current authorization codes for Halcyon products that you are using and provides functionality for adding new and deleting existing codes. Contact details for the product supplier or reseller are also displayed on this screen.

How Authorization Codes operate

Halcyon authorization codes include the number of activated cores (CPUs) for a machine. If the number of activated cores on the machine exceeds the number on the authorization code, a 45 day grace period is started. A new authorization code for the higher limit or the number of activated cores lowered to the limit on the existing authorization code must be applied within the 45 day period.

The start date of the 45 day grace period is fixed, by authorization code, and cannot be reset.

For example, you increase the number of activated cores above the authorization code limit for 5 days. You then lower the number of activated cores to the limit on the authorization code.

The authorization code is still counting the 45 day grace period even though you have reduced the number of activated cores to the limit on the authorization code.

If you increase the number of activated cores from 45 days after the initial ‘breach’, the authorization code immediately becomes invalid - even though, in effect, you breached the limit for only 5 days of the 45 day grace period.

NOTE: The number of activated cores is checked for the machine, not partition. You are therefore still able to re-allocate CPU resource across partitions without invoking the grace period. The grace period is only invoked if the number of cores activated on the machine is increased above the limit on the authorization code.

If you enter an authorization code that is not valid on the local system but may be valid on a remote system, the following message is displayed:

‘Authority code not valid on this system but may be valid on a remote system’.

The license code is not recognized against this local system and it is therefore added as a remote code. Remote codes can be added for replication purposes and are displayed on the local system as *INVALID status for system *RMT.

There is no limit to the number of authorization codes you are allowed and each valid code can authorize any number of products. If multiple codes are displayed you are authorized to use any of the products that have a *VALID status.

There are two types of authorization code:

Temporary (*TEMP)

Temporary codes grant authority to use selected products until a specific date, known as the expiry date, is reached. After that date, the product authority is revoked and the products no longer function unless you have authority via another code.

Permanent (*PERM)

Permanent codes grant permanent authority to use selected products. This authority never expires.

Permanent codes also give maintenance cover until a specific date (shown as an expiry date). Maintenance cover provides access to free upgrades and technical support.

When maintenance cover expires, the product still functions but you are no longer entitled to upgrades or technical support.

IMPORTANT: You may still upgrade to product versions that were released prior to the maintenance expiry date but later releases will not function.
TIP: You can delete Permanent Product License Codes that have no Maintenance (*NOMAINT) and keep alternative Product License Codes available that do have Maintenance by using system default HAL/CODEAUTODELETE.

Getting there

Select option 1=Work with Authorization Codes from the Halcyon Configuration menu.

Parameters on the Work with Authorization Codes display

The following parameters are available on the Work with Authorization Codes display.

Date added

Displays the date on which the authorization code was added.

Authorization code

Displays the characters of the authorization code. If the code appears truncated (shown as ... after the initial characters) use option 5=Display against the code to display it in full.

Type

Displays the authorization code type. See Temporary or Permanent code expiry options for descriptions.

Expiry

The entry in this parameter has a different meaning depending on the authorization code type:

Temporary (*TEMP) - The date on which the authorization code expires
Permanent (*PERM) - The date on which the maintenance cover expires
Status

Displays the current status of the authorization code.

*EXPIRED A temporary authorization code has expired
*INVALID An invalid code has been entered
*NOMAINT A permanent code with expired maintenance cover
*VALID A valid code is in force
System

Displays whether the code is (or was) valid on the local system.

*LOCAL The code is tied to the local system by system name, LPAR or serial number
*REMOTE Indicates a code that is tied to another system by system name, LPAR or serial number. You can add codes that are only valid on a remote system. This is useful in HA environments if you intend to replicate this environment onto another system
*ANY A code that works on any system

Using the Work with Authorization Codes display

The following options are available when working with the authorization codes. Type the option number in the Opt column against the required selection.

Delete

Use option 4=Delete to open the Confirm Delete of Authorization Codes display. Message HAL0016, is sent to the Admin Message Queue, as specified in system default HAL/ADMINMSGQ, when an Authorization Code is deleted and includes the name of the environment.

Press Enter on this display to confirm the deletion of the selected authorization code.

Display

Use option 5=Display to open the Display Authorization Code display which shows the authorization code in full as well as detailing the products authorized by the code.

The following functions are available on the Work with Authorization Codes display.

F3=Exit

Use F3=Exit to close the current display and return to the main menu.

F5=Refresh

Use F5=Refresh to update the display with current information.

F6=Add

Use F6=Add to display the Add Authorization Code display which allows you to enter the details of a new authorization code.

TIP: Use this option when updating expired authorization codes.

It is possible to add codes that are used by another remote location. The code must still be valid, but is accepted if it is tied to another system by system name, serial number or LPAR. Authorization Codes that are tied to a remote system are shown last and in blue text on the Work with Authorization Codes display.

The following functions are available when working with authorization codes.

F3=Exit

Use F3=Exit to close the current display and return to the main menu.

F5=Refresh

Use F5=Refresh to update the display with current information.

F6=Add

Use F6=Add to display the Add Authorization Code display which allows you to enter the details of a new authorization code.

NOTE: Use this option when updating expired authorization codes. It is possible to add codes that are used by another remote location. The code must still be valid, but is accepted if it is tied to another system by system name, serial number or LPAR. Authorization Codes that are tied to a remote system are shown last and in blue text on the Work with Authorization Codes display.
F12=Cancel

Use F12=Cancel to exit this display and return to the previous display.