Programming with VisualAge for Java/IBMVJAVA.ISO/icswinnt/iforls/arkdoc.z/i4wu1cmd.INF

OS/2 Help File | 1996-07-24 | 29.5 KB | 1,067 lines

ΓòÉΓòÉΓòÉ 1. License Use Runtime Command Line Interface ΓòÉΓòÉΓòÉ

The License Use Runtime offers a command line interface as an alternative to
the interactive tool. All the commands are equivalent to the tasks you can
perform interactively.


ΓòÉΓòÉΓòÉ 2. License Use Runtime Commands ΓòÉΓòÉΓòÉ

This section describes how to use the command line on License Use Runtime
servers and clients.

The following commands are available:

     On the server:

        -  i4blt (Enterprise Administration Tool)
        -  i4cfg (Configuration Tool)
        -  i4lbadm (Local Broker Administration)
        -  i4drmadm (GLBD Replicas Administration)
        -  i4lbfind (GLBDs List)

     On the server and on the client:

        -  i4nat (Nodelock Administration Tool)


ΓòÉΓòÉΓòÉ 2.1. General Rules for the License Use Runtime Command Line ΓòÉΓòÉΓòÉ

   1. You can run the License Use Runtime command line as follows:

      OS/2                            From an OS/2 window

      Windows 95 and Windows NT       From a DOS prompt window

      Windows 3.1                     From a window opened clicking on the
                                      icon: Nodelock Administration Tool
                                      Command Line Interface in the License Use
                                      Runtime folder.

   2. The parameters you specify in any of the command options are positional.

   3. All the following name specifications must be enclosed within double
      quotation marks (for example: "vendorname").

          server_name
          vendor_name
          product_name
          customer_name
          user_name

      A name that contains character spaces must additionally be enclosed
      within single quotation marks. If multiple blanks within the name must be
      preserved they must be preceded by back slashes. For example:

            -v "'IBM Corporation'"
            -p "'Corel\ \ - System' 1.1"

   4. The parameters you specify in any of the command options are case
      sensitive.


ΓòÉΓòÉΓòÉ 2.2. i4blt - Basic License Tool Command Line Interface ΓòÉΓòÉΓòÉ

If issued with no options, the i4blt command starts the License Use Runtime
Basic License Tool, interactive interface. You can enter the following primary
command options:

 -a (Enroll a Product)
           Add products to a license database

 -U (Update Licenses of Customer-Managed Use Products)
           Update the number of licenses you purchased for a given
           customer-managed use product.

 -G (Distribute Licenses of Customer-Managed Use Products)
           Extracts and distributes licenses from the compound password of a
           given customer-managed use product to the servers.

 -d (Delete a Product License)
           Delete products from a license database.

 -C (Clean Up Stale Licenses)
           Updates the number of concurrent-access licenses in use.

 -l (Display a List)
           List license database information about servers, vendors, and
           products.

 -s (Display Product License Status)
           Gather status information about products.

 -r (Generate a Report)
           Report on information recorded in the log file of a license server.

 -x (Delete Server Log Entries)
           Delete license server log file entries.

 -h (Display Interface Usage)
           Display command syntax and usage information about the Basic License
           Tool command-line interface.

 To have help on the Basic License Tool command line interface, you can also
 enter the following command from an OS/2 window command prompt:

  HELP EATCMD i4blt


ΓòÉΓòÉΓòÉ 2.2.1. -a  Enroll a Product ΓòÉΓòÉΓòÉ

Adds a product to the license database on the license server that you specify.
Use the i4blt -a command to add a new product and its initial licenses to a
license server database. You can also use this command to add licenses for
existing products.

You can add product license information to a server in two ways:

     If you got the product license information in the form of an enrollment
      certificate file, you can install the product importing the enrollment
      certificate.

     If you got the product license information in a format other than an
      enrollment certificate file, you must enter the product information
      manually.


ΓòÉΓòÉΓòÉ 2.2.1.1. Syntax ΓòÉΓòÉΓòÉ

If you have the enrollment certificate file:

i4blt -a -n server_name -f filename -R administrator_name [company_name address
additional_info] -T purchased_licenses

If you do not have the enrollment certificate file:

i4blt -a -n server_name -v vendor_name [vendor_id vendor_password] -p
product_name product_version license_password [license_annotation] -R
administrator_name [company_name address additional_info] -T purchased_licenses


ΓòÉΓòÉΓòÉ 2.2.1.2. Parameters ΓòÉΓòÉΓòÉ

 -n server_name
           Specifies the name of the license server to which you intend to add
           the product. Server name specifications are case sensitive.

 -f filename (Only if you have the enrollment certificate)
           The complete path and file name of the enrollment certificate file
           containing the product license information that you intend to add.

 -v vendor_name (If you do not have the enrollment certificate)
           The name of the vendor who manufactured the product that you intend
           to add.

           vendor_id              The unique vendor ID string for the vendor
                                  that you specify in the vendor_name You can
                                  omit this argument from the command line if
                                  the vendor is already installed in the
                                  license database of the specified server.

           vendor_password        The unique vendor password string for the
                                  vendor that you specify in the vendor_name
                                  argument. You can omit this argument from the
                                  command line if the vendor is already
                                  installed in the license database of the
                                  specified server.

           Vendor name specifications follow the second and third rules listed
           in General Rules for the License Use Runtime Command Line.

 -p product_info (If you do not have the enrollment certificate)
           The information on the licensed product that you intend to install.

           product_name             The name of the product that you want to
                                    install.

           product_version          The version of the product that you
                                    specified in the product_name parameter.

           license_password         The unique license password string
                                    associated with the product.

           license_annotation       The license annotation information (if any)
                                    provided by the vendor.

           Product specifications follow the second and third rules listed in
           General Rules for the License Use Runtime Command Line.

 -R administrator_info (for customer-managed use products only)
           The information on the administrator that enrolls the product.

           administrator_name   The name of the administrator who performs the
                                operation.

           company_name         The name of your company.

           address              The address of your company.

           additional_info      Comments, notices to future users, or other
                                information about the initial distribution of
                                this product.

           Administrator specifications follow the second and third rules
           listed in General Rules for the License Use Runtime Command Line.

 -T purchased_licenses (for customer-managed use products only)
           The number of licenses you have purchased from the software
           supplier.


ΓòÉΓòÉΓòÉ 2.2.1.3. Examples ΓòÉΓòÉΓòÉ

Add a new product and vendor:

i4blt -a -n thelma
-v "Venus 4ca0fd5cf000.0d.00.02.1a.9a.00.00.00 kz5esmu69hzyw"
-p "timer 1.1 wzx3ewdfrvu4v64d53bbrkzhheaaaaa"

Add a product from an existing vendor:

i4blt -a -n thelma
-v Venus
-p "timer 1.1 wzx3ewdfrvu4v64d53bbrkzhheaaaaa"


ΓòÉΓòÉΓòÉ 2.2.2. -U  Update Licenses of Customer-Managed Use Products ΓòÉΓòÉΓòÉ

Update the number of licenses you purchased for a given customer-managed use
product. Use the i4blt -U command when you purchase new licenses for an already
enrolled customer-managed use product, to update the total number of licenses
you have available.


ΓòÉΓòÉΓòÉ 2.2.2.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -U -v vendor_name -p [product_name product_version] -T purchased_licenses


ΓòÉΓòÉΓòÉ 2.2.2.2. Parameters ΓòÉΓòÉΓòÉ

 -v vendor_name
           The name of the vendor who manufactured the product for which you
           purchased the new licenses.

           Vendor name specifications follow the second and third rules listed
           in General Rules for the License Use Runtime Command Line.

 -p product_info
           The information on the licensed product that you intend to install.

           product_name             The name of the product for which you have
                                    purchased the new licenses.

           product_version          The version of the product that you
                                    specified in the product_name parameter.

           Product specifications follow the second and third rules listed in
           General Rules for the License Use Runtime Command Line.

 -T purchased_licenses
           The total number of licenses you have for the specified product,
           that is the number of licenses you had, plus the newly purchased
           ones.


ΓòÉΓòÉΓòÉ 2.2.2.3. Examples ΓòÉΓòÉΓòÉ

Updates to 50 the number of licenses for Test Compiler product, Version 1.1 of
vendor Psychosync:

i4blt -U
-v "Psychosync" -p "'Test Compiler' 1.1"
-T 50


ΓòÉΓòÉΓòÉ 2.2.3. -G  Distribute Licenses of Customer-Managed Use Products ΓòÉΓòÉΓòÉ

Use the i4blt -G to extract licenses from an installed compound password of a
customer-managed use control product, and distribute them to the servers.


ΓòÉΓòÉΓòÉ 2.2.3.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -G -n origin_server_name -v vendor_name -p product_name product_version
-A license_number_per_server -w target_server_names


ΓòÉΓòÉΓòÉ 2.2.3.2. Parameters ΓòÉΓòÉΓòÉ

 -n origin_server_name
           The name of the server where the product is enrolled.

 -v vendor_name
           The name of the vendor who manufactured the product whose licenses
           you want to distribute.

           The vendor name follows the second and third rules listed in General
           Rules for the License Use Runtime Command Line.

 -p product_info
           The information on the licensed product whose licenses you intend to
           distribute.

           product_name             The name of the product whose licenses you
                                    want to distribute.

           product_version          The version of the product that you
                                    specified in the product_name parameter.

           Product specifications follow the second and third rules listed in
           General Rules for the License Use Runtime Command Line.

 -A license_number_per_server
           The number of licenses for the specified product you want to
           distribute on each of the servers specified after the -w parameter.

 -w target_server_names
           The servers on which you want to distribute the licenses.


ΓòÉΓòÉΓòÉ 2.2.3.3. Examples ΓòÉΓòÉΓòÉ

Distributes 10 licenses to each of the servers Louise and Hall, for Test
Compiler product, Version 1.1 of vendor Psychosync, installed on server Thelma:

i4blt -G
-n "Thelma"
-v "Psychosync" -p "`Test Compiler' 1.1"
-A 10
-w "Louise Hall"


ΓòÉΓòÉΓòÉ 2.2.4. -d  Delete a Product License ΓòÉΓòÉΓòÉ

Deletes a product license from the license database on the license server that
you specify.


ΓòÉΓòÉΓòÉ 2.2.4.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -d -n server_name -v vendor_name -p product_name product_version -t
timestamp


ΓòÉΓòÉΓòÉ 2.2.4.2. Parameters ΓòÉΓòÉΓòÉ

 -n server_name
           Name of the license server from which you intend to delete the
           product license. Server name specifications are case sensitive.

 -v vendor_name
           Name of the vendor whose product license you intend to delete.

           Vendor name specifications follow the second and third rules listed
           in General Rules for the License Use Runtime Command Line.

 -p product_info
           The information on the licensed product whose licenses you intend to
           delete.

           product_name   Name of the product whose license you intend to
                          delete.

           product_version Version of the product whose license you intend to
                          delete.

           Product specifications follow the second and third rules listed in
           General Rules for the License Use Runtime Command Line.

 -t timestamp
           Unique time stamp of the product license that you intend to delete.
           To get the time stamp, issue the following command:

                      i4blt -lp -p "product_info" -i


ΓòÉΓòÉΓòÉ 2.2.4.3. Remarks ΓòÉΓòÉΓòÉ

When the last license for the only remaining product of a vendor is deleted,
the vendor is automatically deleted from the license database. Compound
passwords and use-once licenses cannot be deleted until they expire.


ΓòÉΓòÉΓòÉ 2.2.4.4. Example ΓòÉΓòÉΓòÉ

The following command deletes an expired license to use a VectorComp
Corporation product called EZ-Vectors Version 1.0. The unique time stamp of the
license to be deleted from the database on server saturn is 781401788:

i4blt -d -n saturn -v "'VectorComp Corporation'"
-p "EZ-Vectors 1.0" -t 781401788


ΓòÉΓòÉΓòÉ 2.2.5. -C  Clean Up Stale Licenses ΓòÉΓòÉΓòÉ

Use the i4blt -C to update the number of in-use concurrent-access licenses.

When you issue this command License Use Runtime polls all the license servers
that have granted concurrent-access licenses and verifies that the licenses are
still in use. If any stale licenses are found, they are removed from the number
of in use licenses.


ΓòÉΓòÉΓòÉ 2.2.5.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -C -n server_names -v vendor_names -p product_names


ΓòÉΓòÉΓòÉ 2.2.5.2. Parameters ΓòÉΓòÉΓòÉ

 -n server_names
           The names of the servers where the products are enrolled.

 -v vendor_names
           The name of the vendors who manufactured the products whose licenses
           are in use.

           The vendor name follows the second and third rules listed in General
           Rules for the License Use Runtime Command Line.

 -p product_names
           The names of the products whose licenses in use you want to update.


ΓòÉΓòÉΓòÉ 2.2.5.3. Examples ΓòÉΓòÉΓòÉ

Cleans up the stale licenses for Graphics product of vendor Alpha on servers
Thelma, Hall, and Louise:

i4blt -C
-n "Thelma Hall Louise"
-v "Alpha" -p "Graphics"


ΓòÉΓòÉΓòÉ 2.2.6. -l Display a List ΓòÉΓòÉΓòÉ

Displays a list of servers, vendors, or products, and product details.


ΓòÉΓòÉΓòÉ 2.2.6.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -l list_type [n|v|p] [-n server_name] [-v vendor_names] [-p
product_names] [-u user_names] [-i]


ΓòÉΓòÉΓòÉ 2.2.7. Parameters ΓòÉΓòÉΓòÉ

 list_type
           Indicates the type of information that you want to list.

           You can specify any one of the following list types:

           -ln
                          To display a list of active servers.

           -lv
                          To create a vendor list.

                          To list vendor information gathered only from servers
                          that you specify, use the -n filter option, followed
                          by one or more server names.

           -lp
                          To create a product list.

                          To list product information gathered from servers
                          that you specify, use the -n filter option, followed
                          by one or more server names.

                          To list product information on products from
                          particular vendors, use the -v filter option,
                          followed by one or more vendor names.

                          To list product information on particular products,
                          use the -p filter option, followed by one or more
                          product names.

                          To list information on users who are currently using
                          the products that you specify, use the -u filter
                          option, followed by one or more user names.

           The following table shows the filter options you can use for each of
           the list types:

                      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
                      Γöé Table 1. Filters You Can Use for Each List Type                Γöé
                      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
                      Γöé  LIST TYPE  Γöé          DESCRIPTION          Γöé   FILTERS  Γöé
                      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
                      Γöé    -ln    Γöé          Server list          Γöé   none   Γöé
                      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
                      Γöé    -lv    Γöé          Vendor list          Γöé    -n    Γöé
                      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
                      Γöé    -lp    Γöé          Product list         Γöé  -n, -v, -p, Γöé
                      Γöé        Γöé                        Γöé   -u, -i   Γöé
                      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

 -n server_name
           Name of the server about which you want to display information in a
           vendor list. Server name specifications are case sensitive.

 -v vendor_names
           Names of the vendors about whose products you want to display
           information in a product list.

           Vendor name  specifications follow the second and third rules listed
           in General Rules for the License Use Runtime Command Line.

 -p product_names
           Names of the products about which you want to display information in
           a product list.

           Product name  specifications follow the second rule listed in
           General Rules for the License Use Runtime Command Line, and are case
           sensitive.

 -u user_names
           Names of users about whom you want to display license usage
           information in a product list.

           User name  specifications follow the second rule listed in General
           Rules for the License Use Runtime Command Line, and are case
           sensitive.

 -i
           Specify the -i option to display the following detailed license
           usage information about an individual licensed product in a product
           list:

               Vendor name
               Vendor ID
               Product name
               Product version
               Product ID
               Security level
               Purchased licenses
               Licenses to be distributed
               Concurrent licenses
               Concurrent licenses in use
               Use-once licenses


               For each license instance:
                  -  Number of licenses installed
                  -  License type
                  -  Server on which the license is installed
                  -  License annotation (if any)
                  -  Start date
                  -  End date
                  -  Time stamp
                  -  Multiuse rules (if any)

           For compound passwords, the following information is also displayed:

               Derived license type
               Aggregate duration
               Derived start type
               Derived end date


ΓòÉΓòÉΓòÉ 2.2.7.1. Examples ΓòÉΓòÉΓòÉ

List all servers:

i4blt -ln

List all vendors on server Hall:

i4blt -lv -n Hall

List all products on server Hall:

i4blt -lp -n Hall

List all products on server mercury provided by vendors Opticon, Inc. or
Cybertronics Ltd.:

i4blt -lp -n mercury -v "'Opticon, Inc.' 'Cybertronics Ltd.'"

List detailed information for the product PsychoSynch on server venus:

i4blt -lp -n venus -p PsychoSynch -i

List all of the products on the server neptune that are currently being used by
the user Alex:

i4blt -lp -n neptune -u Alex


ΓòÉΓòÉΓòÉ 2.2.8. -s Display Product License Status ΓòÉΓòÉΓòÉ

Displays information about current product usage on the license servers that
you specify.


ΓòÉΓòÉΓòÉ 2.2.8.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -s [-n server_names] [-v vendor_names] [-p product_names] [-u user_names]


ΓòÉΓòÉΓòÉ 2.2.8.2. Parameters ΓòÉΓòÉΓòÉ

 -n server_names
           The name of each of the license servers for which you want to
           display product usage information. All server name specifications
           (an individual name or an entire sequence of multiple names) follow
           the second rule listed in General Rules for the License Use Runtime
           Command Line, and are case sensitive. If you omit the -n parameter,
           the display defaults to all servers in your cell.

 -v vendor_names
           The name of the vendor (or vendors) about whose products you want to
           display information. All vendor name specifications (an individual
           name or an entire sequence of multiple names) follow the second and
           third rules listed in General Rules for the License Use Runtime
           Command Line.

 -p product_names
           The name of the product (or products) about which you want to
           display information. All product name specifications (an individual
           name or an entire sequence of multiple names) follow the second rule
           listed in General Rules for the License Use Runtime Command Line,
           and are case sensitive.

 -u user_names
           Use the optional -u user_names argument to display product usage
           information for the specified products that are currently in use by
           the named users. All user name specifications (an individual name or
           an entire sequence of multiple names) follow the second rule listed
           in General Rules for the License Use Runtime Command Line, and are
           case sensitive.


ΓòÉΓòÉΓòÉ 2.2.8.3. Remarks ΓòÉΓòÉΓòÉ

This command displays the following information for the servers, vendors,
products, and users that you specify:

      Vendor name
      Product name
      Product version
      Total number of installed licenses
      Number of licenses currently in use
      Number of available licenses
      Number of queued users

 For each user who currently holds a license, the following information is
 displayed:

      User name
      Node name
      Group name
      Number of licenses the user has been granted
      Check-out date for each granted license


ΓòÉΓòÉΓòÉ 2.2.8.4. Example ΓòÉΓòÉΓòÉ

The following command displays current license availability and usage
information for the Monolith Inc. product Megamail/2 on server uranus:

i4blt -s -n "uranus" -v "'Monolith Inc.'" -p "Megamail/2"


ΓòÉΓòÉΓòÉ 2.2.9. -r Generate a Report ΓòÉΓòÉΓòÉ

Lists server event, vendor, product, and user information on the license
servers that you specify.


ΓòÉΓòÉΓòÉ 2.2.9.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -r report_type [1|2|3|6] [-b start_date] [-g end_date] [-e event_filter]
[-n server_names] [-v vendor_names] [-p product_name] [-u user_names]


ΓòÉΓòÉΓòÉ 2.2.9.2. Parameters ΓòÉΓòÉΓòÉ

 -r
    report_type. Specifies the type of report to generate. The following report
    types are available:

    1 - Standard Event Report. Displays detailed information about significant
    events occurring on the license servers that you specify.

    2 - License Request by Product Report. Displays statistical information
    about the use of the licenses of a product in the time interval you
    specify. For each product, it reports the licenses requested, the licenses
    granted, and the percentage of rejections.

    3 - License Request by User Report. Displays statistical information about
    the use of products by users in the time interval you specify. For each
    user, it reports the licenses requested, the licenses granted, and the
    percentage of rejections for each product the person is using.

    6 - License Distribution Audit. Reports the following information for
    customer-managed use control product transactions:

        Vendor name
        Product name
        Product version
        Time stamp of the event
        Number of licenses involved in the transaction
        Event list (product enrolled, license added, license deleted)
        Administrator information

 -b
    start_date. Specifies the start date of a report. Be sure to express the
    date using the mm/dd/yy format. If you specify a start date and do not
    specify an end date, the report will include all information logged from
    the specified start date until the present.

 -g
    end_date. Specifies the end date of a report. Be sure to express the date
    using the mm/dd/yy format. If you specify an end date and do not specify a
    start date, the report will include all information logged prior to (and
    including) the specified end date.

 -e
    event_filter. You can use the event_filter argument to generate a Standard
    Event report on the following types of events which you specify, by number,
    on the command line. (Separate multiple event type arguments with a comma.)

    1              All events
    2              License-related events
    3              Vendor messages
    4              License database modifications
    5              Error events
    6              Server start and stop events
    7              Fatal errors

 -n
    server_names. Names of the servers about which you want to display
    information. All server name specifications (an individual name or an
    entire sequence of multiple names) follow the second rule listed in General
    Rules for the License Use Runtime Command Line, and are case sensitive.

 -v
    vendor_names. Names of the vendors about whose products you want to display
    information. All vendor name specifications (an individual name or an
    entire sequence of multiple names) follow the second and third rules listed
    in General Rules for the License Use Runtime Command Line.

 -p
    product_name. Name and version of the products about which you want to
    display information. All product name specifications (an individual name or
    an entire sequence of multiple names) follow the second rule listed in
    General Rules for the License Use Runtime Command Line, and are case
    sensitive.

 -u
    user_names. Names of users about whom you want to display license usage
    information. All vendor user specifications (an individual name or an
    entire sequence of multiple names) follow the second rule listed in General
    Rules for the License Use Runtime Command Line, and are case sensitive.


ΓòÉΓòÉΓòÉ 2.2.9.3. Examples ΓòÉΓòÉΓòÉ

Standard Event Report:

The following command reports on license-related events (2) and server start
and stop events (6) that were logged on server neptune since May 21, 1995:

i4blt -r1 -b 5/21/95 -e 2,6

License Use by Product Report:

The following command reports current license usage information on server
saturn for the products NetLS Test Product, Compiler, PsychoSynch, Megamail/2,
EZ-Vectors, and DataVision:

i4blt -r2 -n "saturn" -p "'NetLS Test Product' 'Compiler'
PsychoSynch Megamail/2 EZ-Vectors DataVision"

The following command reports current license usage information on server
mercury for users alex, ann, mary, christine, paul, and alby:

i4blt -r3 -n "mercury" -u "alex ann mary christine paul alby"


ΓòÉΓòÉΓòÉ 2.2.10. -x Delete Server Log Entries ΓòÉΓòÉΓòÉ

Deletes log file entries from the event log on the license server that you
specify.


ΓòÉΓòÉΓòÉ 2.2.10.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -x delete_date -n server_name


ΓòÉΓòÉΓòÉ 2.2.10.2. Parameters ΓòÉΓòÉΓòÉ

 -x delete_date
           Specifies an end date for the delete operation. All log entries
           recorded before the delete date are removed from the log file. You
           must specify a delete date in the mm/dd/yy format. If you do not
           specify a delete_date, all entries in the log file are deleted.

 -n server_name
           Specifies the license server from whose log file you want to delete
           all entries. Server name specifications are case sensitive.


ΓòÉΓòÉΓòÉ 2.2.10.3. Example ΓòÉΓòÉΓòÉ

The following command deletes all the log file entries recorded on server
neptune prior to August 25, 1995:

i4blt -x 08/25/95 -n neptune


ΓòÉΓòÉΓòÉ 2.2.11. -h Display Command Line Interface Usage ΓòÉΓòÉΓòÉ

Displays syntax and usage information for the command line interface.


ΓòÉΓòÉΓòÉ 2.2.11.1. Syntax ΓòÉΓòÉΓòÉ

i4blt -h


ΓòÉΓòÉΓòÉ 2.2.11.2. Example ΓòÉΓòÉΓòÉ

The following command displays the command line syntax and usage:

i4blt -h


ΓòÉΓòÉΓòÉ 2.3. i4nat - Nodelock Administration Tool Command Line Interface ΓòÉΓòÉΓòÉ

If issued with no options, the i4nat command starts the Nodelock Administration
Tool interactive interface. You can enter the following primary command
options:

 -a (Add a nodelocked License)
           Add a nodelocked license for a given product to the nodelock file.

 -d (Delete a nodelocked license)
           Delete a nodelocked license for a given product from the nodelock
           file.

 -l (Display license information)
           List either one or all nodelocked licenses enrolled in the nodelock
           file.

 -u (update a concurrent nodelocked license)
           Update the number of concurrent users of a concurrent nodelocked
           license.

 -h (Display Interface Usage)
           Display command syntax and usage information about the Nodelock
           Administration Tool command line interface.


ΓòÉΓòÉΓòÉ 2.3.1. -a  Add a nodelocked license ΓòÉΓòÉΓòÉ

Use this command to add a new nodelocked license to the nodelock file.

If the vendor provides you with the nodelocked license in the form of an
enrollment certificate file, you can add the license automatically. Otherwise,
you have to add it manually.


ΓòÉΓòÉΓòÉ 2.3.1.1. Syntax ΓòÉΓòÉΓòÉ

If you have the enrollment certificate file:

i4nat -a -f filename -c

If you do not have the enrollment certificate file:

i4nat -a -v vendor_name vendor_id  -p product_name product_version
license_password [license_annotation comment] -c count


ΓòÉΓòÉΓòÉ 2.3.1.2. Parameters ΓòÉΓòÉΓòÉ

 -f filename (For automatic entry only)
           The complete path and file name of the enrollment certificate file.

 -v vendor_name (For manual entry only)
           The name of the vendor who manufactured the product whose license is
           being added. Vendor name specifications are case sensitive.

           vendor_id
                          The unique vendor ID string for the vendor specified
                          in the vendor_name.

 -p product_info (For manual entry only)
           The information on the licensed product that you intend to install.

           product_name (For manual entry only)
                          The name of the licensed product that you have to
                          add. Product name specifications are case sensitive.

           product_version
                          The version of the product that is specified in the
                          product_name argument

           license_password
                          The unique license password string associated with
                          the product.

           license_annotation
                          The license annotation information (if any) the
                          vendor provided.

           comment
                          Any comment that you want to add to the nodelocked
                          license record within the nodelock file.

 -c count (For concurrent nodelocked licenses only)
           The number of users you want to use the license simultaneously.

           This parameter is not available on clients that run Windows 3.1,
           Windows 3.11, and Windows for Workgroup.


ΓòÉΓòÉΓòÉ 2.3.1.3. Example ΓòÉΓòÉΓòÉ

Add a new product:

i4nat -a
-v "vendor_name vendor_id"
-p "product_name product_version license_password
[ license_annotation ]"
-c 20


ΓòÉΓòÉΓòÉ 2.3.2. -d  Delete a nodelocked license ΓòÉΓòÉΓòÉ

Deletes a nodelocked license from the nodelock file. The license is identified
by its unique password.


ΓòÉΓòÉΓòÉ 2.3.2.1. Syntax ΓòÉΓòÉΓòÉ

i4nat -d -p license_password


ΓòÉΓòÉΓòÉ 2.3.2.2. Parameters ΓòÉΓòÉΓòÉ

 -p license_password
           The license password that uniquely identifies the license that you
           want to delete.


ΓòÉΓòÉΓòÉ 2.3.2.3. Example ΓòÉΓòÉΓòÉ

The following command deletes the license to use a product with password:
2ap6tesiawwrs7qkd4y9wthzx6mj22i2

i4nat -d -p 2ap6tesiawwrs7qkd4y9wthzx6mj22i2


ΓòÉΓòÉΓòÉ 2.3.3. -l  Display license information ΓòÉΓòÉΓòÉ

Displays information regarding a license if the -p option is specified;
otherwise, it displays a list of all the licenses installed on the nodelock
file.


ΓòÉΓòÉΓòÉ 2.3.3.1. Syntax ΓòÉΓòÉΓòÉ

i4nat -l [-p license_password]


ΓòÉΓòÉΓòÉ 2.3.3.2. Parameters ΓòÉΓòÉΓòÉ

 -p license_password
           The license password that uniquely identifies the license that you
           want to display.


ΓòÉΓòÉΓòÉ 2.3.3.3. Example ΓòÉΓòÉΓòÉ

The following command displays the license to use a product with password:
2ap6tesiawwrs7qkd4y9wthzx6mj22i2

i4nat -l -p 2ap6tesiawwrs7qkd4y9wthzx6mj22i2


ΓòÉΓòÉΓòÉ 2.3.4. -u  Update concurrent nodelocked license information ΓòÉΓòÉΓòÉ

Updates the number of concurrent users of a concurrent nodelocked license.

This option is not available on clients that run Windows 3.1, Windows 3.11, and
Windows for Workgroup.


ΓòÉΓòÉΓòÉ 2.3.4.1. Syntax ΓòÉΓòÉΓòÉ

i4nat -u -p license_password -c count


ΓòÉΓòÉΓòÉ 2.3.4.2. Parameters ΓòÉΓòÉΓòÉ

 -p license_password
           The license password that uniquely identifies the concurrent
           nodelocked license you want to update.

 -c count
           The number of users you want to simultaneously use the licensed
           product.


ΓòÉΓòÉΓòÉ 2.3.4.3. Example ΓòÉΓòÉΓòÉ

The following command updates the number of concurrent users of the license for
the product with password: 2ap6tesiawwrs7qkd4y9wthzx6mj22i2, and sets that
number to 10.

i4nat -u -p 2ap6tesiawwrs7qkd4y9wthzx6mj22i2 -c 10


ΓòÉΓòÉΓòÉ 2.3.5. -h  Display Command Line Interface Usage ΓòÉΓòÉΓòÉ

Displays syntax and usage information for the command line interface.


ΓòÉΓòÉΓòÉ 2.3.5.1. Syntax ΓòÉΓòÉΓòÉ

i4nat -h


ΓòÉΓòÉΓòÉ 2.3.5.2. Example ΓòÉΓòÉΓòÉ

The following command displays the command line syntax and usage:

i4nat -h


ΓòÉΓòÉΓòÉ 2.4. i4cfg - Configuration Command ΓòÉΓòÉΓòÉ

If issued with no options, it starts the interactive interface for the License
Use Runtime Configuration Tool. Moreover, it provides the following primary
command options:

 -list (Lists of active Subsystems)

           Allows you to see the list of active subsystems.

 -start (Starts the Subsystems)

           Starts all the subsystems you have configured for starting on your
           server or client machine.

 -stop (Stops the Subsystems)

           Stops all the subsystems that are running on your server or client
           machine.


ΓòÉΓòÉΓòÉ 2.4.1. Syntax ΓòÉΓòÉΓòÉ

i4cfg i4cfg [-start|-stop|-list]


ΓòÉΓòÉΓòÉ 2.4.2. Example ΓòÉΓòÉΓòÉ

The following command starts the subsystems:

i4cfg -start