brand(ADM)

brand -- manage product licenses

Syntax

brand -g [ -a license_data ] license_number license_code
brand -h license_number license_code
brand -L
brand -Q license_number license_code
brand -R license_number registration_key
brand -r license_number
brand [-c] [-m] [-O] [-t] [-u]

Description

Use the brand utility to manage and query product licenses on your system. With it, you can license products, additional users and CPUs, register them, and generate a list of existing licenses and related product information.

To learn more about SCO OpenServer licensing and registration, and how to use the graphical License Manager, see ``Licensing and registering SCO OpenServer products'' in Licensing software.

Options

-c

Display the number of currently licensed processors.

-m

Display the amount of currently licensed memory.

-g [ -a license_data ] license_number license_code

License a product using the License Number, License Code, and License Data (if provided) from the Certificate of License and Authenticity.

-h license_number license_code

Check whether the specified License Number/License Code pair requires the specification of a License Data string. With this option, brand exits with 0 if a License Data string is required, with 8 if the string is not required, and with any other value if an error occurs.

-L

Produce a list of existing licenses and product information. This list includes information on each license's product ID, version, License Number, annotation field, start date, and expiration date. This list also includes the product name, version, description and default License Data string for all licenses on the system except SCO User Licenses and SCO SMP Licenses.

-O

Displays the Operating System Serial Number.

-Q license_number license_code

Return the product ID and version, separated by a period (``.''), associated with the specified License Number/License Code pair. If the specified License Number/License Code pair is invalid, brand exits with 13.

-R license_number registration_key

Register the product identified by license_number using the Registration Key provided by your SCO OpenServer distributor.

-r license_number

Remove the product identified by license_number.

-t

-u

The -t option displays the total number of licensed users. The -u option displays the number of user licenses currently in use. If your current usage exceeds the total licensed, the -u option returns a negative number.

NOTE: These options apply only to login licenses, not other licensed products.

-?

Print out a usage message.

Exit values

0: Success.
1: Usage failure.
8: License Data string is not required.
10: Product not licensed; system failed to process licensing information.
12: Registration Key is mistyped.
13: Invalid License Number, License Code, or Registration Key.

Notes

The functionality of brand and debrand in previous versions of SCO OpenServer software has been maintained for backward compatibility.

Examples

To license a product, use the License Number, License Code, and License Data in the following manner:

brand -g -a "b12;u32;mljkad3" BKA123456 wygfqmxs