Elements
The following table lists the elements of a license document. There is a single Company element and one or more Product elements. The Product element contains one or more Option elements, and may contain multiple Computer elements.
Element | Description |
---|---|
**Company | Required. Your company name. |
** Product | Required. Contains the Micro Focus/ Serena product number, and optionally the name. |
** Option | Required. Product options. Contains the following sub-elements: ● ExpirationDate ● ExpirationLimit Every product has a base product (Option "0"). |
** ExpirationDate | Expiration date of the option. If not present, the license is permanent. |
** ExpirationLimit | Maximum expiration date. Required if ExpirationDate is specified in relative format. |
** Version | Version and release of the product. If not present, the license is valid for all versions. |
** Computer | Describes the CPU IDs and capacity limits of one or more machines. Contains the following sub-elements: ● System Capacity ● Model ● CpuId If not present, the license is valid for any machine. |
** MachineType | The machine type on which the product is licensed to run. |
** MachineModel | The model number on which the product is licensed to run. |
** MachineSeq | The machine sequence number (serial number) on which the product is licensed to run. This is a hexadecimal number of up to 16 digits. Leading zeros are not required. |
** Model | The machine type and model number on which the product is licensed to run. The Model element is deprecated and is used only for older product versions. Newer product versions use the MachineType and MachineModel elements instead of Model. |
** CpuId | The CPU ID on which the product is licensed to run. The CpuId element is deprecated and is used only for older product versions. Newer product versions use the MachineSeq and MachineType elements instead of CpuId. |
** SystemCapacity | The maximum machine capacity on which the product is licensed to run. If not present, there is no limit on system capacity. |
** Lpar | Describes a specific LPAR on which product is licensed to run. Contains the following sub-elements: ● LPAR Number ● LPAR Name ● Group Name ● LPAR Capacity ● Group Capacity If not present, the license is valid for any LPAR. |
** LparNumber | The ID number of an LPAR on which the product is licensed to run. The LPAR number has a value in the range 0 – 255. An LPAR can alternatively be identified with the \<LparName> element instead. \<LparName> is the preferred method for identifying an LPAR. |
** LparName | The name of an LPAR on which the product is licensed to run. |
** GroupName | The name of an LPAR group on which the product is licensed to run. Using this element requires that the LPAR be defined as a member of a group. LPAR groups allow capacity limits to set for a group of LPARs as a whole, rather than setting individual capacity limits for each LPAR. |
** LparCapacity | The maximum LPAR capacity on which the product is licensed to run. If not present, there is no limit on LPAR capacity. |
** GroupCapacity | The maximum capacity for the group on which the product is licensed to run. If not present, there is no limit on group capacity. Using this element requires that the LPAR be defined as a member of a group. LPAR groups allow capacity limits to set for a group of LPARs as a whole, rather than setting individual capacity limits for each LPAR. |
** Users | The maximum number of concurrent users that can use the product. If not present, there is no limit on the number of users. |
** LicenseType | Required. Values are 0, 1, or 2, and indicate the following types of licenses: ● 0 Standard ● 1 Demo ● 2 Disaster Recovery |
** WarningDays | Warning days. The number of days before license expiration that warning messages are displayed. If not present, no warning messages will be displayed. |
** GraceDays | Grace period days. The number of days after license expiration that the product can continue to be used. Second-level warning messages are displayed during the grace period. If not present, no grace period is given. |
** FailureAction | The type of action to take on failure: ● 0 Terminate ● 1 Continue If not present, the default is 0 (terminate). |
** FailureMsg | The type of message to display on failure: ● 0 Normal message ● 1 Highlighted message If not present, the default is 0 (normal). |
** SeverityFlags | A hexadecimal number representing flags indicating whether specific types of violations are treated as warnings or failures. ● 1 Treat model number violations as failures If not present, the default is 0 (normal). |
** LicenseId | License ID. A unique numeric identifier used by Micro Focus/Serena. |
** TimeStamp | Required. Time license issued. |
** Key | Required. The key used by Micro Focus/ Serena application programs for validating the license. |