System Management Services 1.4 man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

showcodlicense(1m)

DESCRIPTION
OPTIONS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

showcodlicense - display the current Capacity on Demand (COD) right-to-use (RTU) licenses stored in the COD license database

SYNOPSIS

showcodlicense [-r] [-v]

showcodlicense -h

DESCRIPTION

showcodlicense(1M) displays COD license information stored in the COD license database.

OPTIONS

The following options are supported:

-h: Help. Displays usage descriptions.Note – Use alone. Any option specified in addition to -h is ignored.
-r: Displays the license information in the raw license-signature format, as stored in the COD license database.
-v: Verbose. Displays both the formatted license information and raw license-signature data.

EXTENDED DESCRIPTION

The showcodlicense command displays the following COD information:

Description: Type of resource (processor).
Lic Ver: Version number of the license, which is always set to 01.
Expiration: None.
Count: Number of right-to-use licenses granted for the given resource.
Status: GOOD, which indicates that the given resource is valid, or EXPIRED, which indicates that the resource license is no longer valid.
Cls: Not supported. Tier class value is always set to 1.
Tier Num: Not supported. Tier number value is always set to 1.
Req: Not supported. Required number of lower-tier licenses is always set to 0.

Group Privileges Required

You must have platform administrator or platform operator group privileges to run this command.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

The following examples show the COD license information displayed:

Example 1. Displaying Formatted License Data

sc0:sms-user:> showcodlicense 

              Lic                                    Tier
 Description  Ver   Expiration  Count   Status  Cls  Num  Req
 -----------  ---  -----------  -----  -------  ---  ---  ---
 PROC          01         NONE     16     GOOD    1    1    0

Example 2. Displaying Raw License Data

sc0:sms-user:> showcodlicense -r 

01:5014936C37048:03001:0201010100:16:00000000:RKQhd8zKNnTwvxT5DJlZNQ

Example 3. Displaying Formatted and Raw License Data

sc0:sms-user:> showcodlicense -v

              Lic                                    Tier
 Description  Ver   Expiration  Count   Status  Cls  Num  Req
 -----------  ---  -----------  -----  -------  ---  ---  ---
 PROC          01         NONE     16     GOOD    1    1    0
 01:5014936C37048:03001:0201010100:16:00000000:RKQhd8zKNnTwvxT5DJlZNQ

EXIT STATUS

The following exit values are returned:

0: Successful completion.
1: Invalid usage.
2: The user does not have valid privileges.
>2: An internal error occurred. For further information see /var/opt/SUNWSMS/adm/platform/messages.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes.

Attribute Types	Attribute Values
Availability	SUNWSMSop