Using the LMS Centralized License facility

This topic highlights the features of the ISPF interface to the License Management System Centralized Licensing Facility. This interface gives the user administrator functions to view and modify the licensed capacity.

Allocating ISPLLIB for LMUSER

In order to successfully execute LMUSER from your TSO/ISPF session, you must have statically allocated the License Management load library to the ISPF DDNAME ISPLLIB.

Do not attempt to use the LIBDEF facility for this allocation. If you have incorrectly allocated the License Management load library, or if you do not have it allocated at all, you will receive the following messages when you attempt to execute LMUSER:

The correct allocation can be made in you LOGON CLIST which is automatically executed during your TSO logon. The format of this allocation in your LOGON CLIST can look like this:

Accessing the ISPF User Interface

Access the LMS ISPF User Interface by performing the following:

1. Under ISPF TSO, invoke LMUSER.The BMC AMI License Management User Interface Server Logon screen displays.

   --------------------- BMC AMI License Management 17.02.00 -------------------
   Command ===> Server Logon
   
   Server Information:
   Port Number . . . (required)
   Host Name . . . . .
   Host Address . . .
   TCP/IP STC Name . . (multi-stack environment only)
   IPv6? . . . . . . . (Y or N)
   
   User Information:
   UserID . . . . . . . . (required)
   Password/Phrase . . . .
   Group Name . . . . . .
   New Password/Phrase . .
   Verify Password/Phrase. 
2. Type the server port number in the PORT NUMBER field.
3. Optionally, type the server host IP name in the HOST NAME field and the server host IP address in the HOST ADDRESS field.
   1. If neither is specified, LMS assumes that the server is running on the same LPAR as the TSO/ISPF session running.
   2. If both are specified, the server host address takes precedence over the server host name.
   3. If only the server host name is given, it is translated into an IP address via the locally attached DNS facility.
   4. If only the server host address is given, it is used without translation.
4. Optionally, type the TCP/IP name in the TCP/IP STC NAME field. Used if multiple TCP/IP servers are running on the same LPAR.
5. Type Y or N in the IPv6? field
   1. Y if LMS is using internet protocol version 6
   2. N if LMS is using internet protocol version 4
6. Type the user ID in the USERID field.
7. Type the password in the PASSWORD/PHRASE field. The password is hidden as you type and does not display.
8. Optionally, type the group name in the GROUP NAME field. If omitted, RACF assigns the user to the user’s default group.
9. Press Enter. The LMS ISPF Interface Main Menu screen displays.

Changing the Password

1. Type the new password in the NEW PASSWORD/PHRASE field.
2. Type the new password a second time in the VERIFY NEW PASSWORD field.
3. Press Enter.
   If the passwords in both fields match, and if RACF accepts the new password, then the password is changed. The next time you log onto LMS or TSO on this system, you must use the new password.

Main Menu Screen

The ISPF Interface Main Menu screen displays when you log into the LMS Server. Initially, the CONFIGURATION and LICENSE FILE fields are blank, but are filled in as processing continues.
The number of days until the password expires and the date of the previous logon also display on the screen. These are supplied as informational only. If your security system is topsecret, these two fields will show N/A, indicating that this information is not available.

User Interface Main Menu Screen

The following options are available on the LMS ISPF Interface Main Menu screen.

1. Option 1 Use the Configuration Maintenance option to perform all processing.
2. Option 2 Use the Define License Files option to define license files to be owned by a configuration.
3. Option 3 Use the Import License Certificates option to import the license certificate to the LMS server.
4. Option 4 Use the LPAR Maintenance option to edit LPAR definitions from the selected configuration.
5. Option 5 Use the Product Maintenance option to delete products, select products or options, or disconnect LPARs from products or options.
6. Option 6 Use the Server Log Maintenance option to invoke the log facility and request that it begin writing the diagnostic information.
7. Option 7 Use the Server History Maintenance option to view, open or close history data.
8. Option 8 Use the LPAR View option to view associated products and options by LPAR.
9. Option X Use the Logoff option to disconnect from the LMS server.

Type one of the menu options on the command line and press Enter to proceed. When no information is displayed in the CONFIG field, you must first enter option 0 in order to select a configuration for further processing.

Option 1 – Configuration Maintenance Screen

Use the Configuration Maintenance screen to perform all processing. You can access the Configuration Maintenance screen by typing 1 on the command line of the ISPF Interface Main Menu screen and pressing Enter.
When LMS is first started, a configuration named DEFAULT CONFIGURATION is generated automatically. This configuration is marked as ACTIVE. An active configuration has the following characteristics:

• LMS clients, connected to this LMS server, are automatically added to the currently active configuration.
• LMS clients, already represented in the active configuration, have their LPAR definition values automatically updated whenever the LMS client detects that LPAR changes have occurred.
• LMS clients automatically receive the license file information associated with the active configuration.

Configuration Maintenance Screen

The status of each configuration is shown to the right of the configuration name.

• ACTIVE means the configuration is active.
• SELECTED means you have selected it.
• No status means the configuration is neither ACTIVE nor SELECTED.

Before any function can be performed on a given configuration, that configuration must be one of the following options:

• added (if it is to be created by the user)

• selected (if it already exists)
• selected and cloned

Selecting a Configuration

1. Type S on the blank line next to the configuration name to select it.
2. Press Enter.

Adding a New Configuration

To add or create a new configuration, follow the steps below.

1. Type a configuration name on the blank line under the CONFIGURATION NAME field.
2. Type N on the blank line next to the name you typed.
3. Press Enter.

Cloning a Configuration

You can create an exact duplicate of an existing configuration by cloning it. Follow the steps below to clone a configuration.

1. Type S on the blank line next to the active configuration name to select it. Cloned configurations are automatically selected for you. If you are ever unsure which configuration is currently selected, look at the configuration name in the CONFIGURATION field. This is the name of the selected configuration.
2. Press Enter.
3. Type C next to the configuration you want to clone and overtype the existing name with a new name.
4. Press Enter.

A configuration with the new name is created for you with all of the characteristics of the configuration which was cloned. These characteristics include license files, LPARs and associations between products and options and the LPARS.

Renaming a Configuration

1. Type S on the blank line next to the configuration name to select it.
2. Press Enter.
3. Type R next to the configuration you want to rename and overtype the existing name with a new name.
4. Press Enter.

Deleting a Configuration

1. Type S on the blank line next to the configuration name to select it.
2. Press Enter.
3. Type D next to the configuration name you want to delete.
4. Press Enter.

Validating a Configuration

You can validate that an existing configuration has not overcommitted licensed MIPS to LPARs and CECs.

1. Type S on the blank line next to the configuration name to select it.
2. Press Enter.
3. Type V next to the configuration name you want to validate.
4. Press Enter.

Activating a Configuration

You can mark an inactive configuration as active.

1. Type S on the blank line next to the configuration name to select it.
2. Press Enter.
3. Type A next to the configuration you want to make the new active configuration.
4. Press Enter.

When you activate a configuration, LMS terminates all communications with the client LPARs. These LPARs each reestablish the communications links with the server and are immediately presented with the license information which you associated with products and options in the new configuration.

In this way, activation is almost immediate although there may be a delay of up to 30 seconds before the client LPARs reestablish TCP/IP communications with the server. This delay is normal.

Option 2 – License File Maintenance Screen

Once you have selected (and optionally cloned) or added a configuration, you should define license files to be owned by that configuration. Use the License File Maintenance screen to define license files to be owned by a configuration. You can access the License File Maintenance screen by typing 2 on the command line of the ISPF Interface Main Menu screen and pressing Enter.

License File Maintenance Screen

On this screen, you can define entirely new license files and LMS allocates them automatically for you or you can specify the names of existing license files. You can add as many license files as you like before exiting this screen.
You should select a license file for further processing before exiting this screen (see “Selecting a License File").

Adding a New License File

1. Type N on the blank line next to the DATA SET NAME field.
2. Type the fully qualified name of the data set without quotes in the DATA SET NAME field. Depending upon your installation's SMS rules, you may have to supply a volume serial number (VOLSER) and/or some or all of the SMS CLASS names (STORAGE, MANAGEMENT, or DATA). If you are unsure what you must enter, look at an IDCAMS DEFINE CLUSTER job, which you may have under your user ID. The parameters specified to IDCAMS are acceptable on this screen. You can check with someone in your systems group if you are still unsure as to which of these parameters are required and what the acceptable values are.
3. Press Enter.

Deleting a License File

CLF never physically deletes any license files. Only the identification of them is deleted when you use this function. If you want to physically delete a license file you must perform this function manually.

1. Type D on the line next to the fully qualified data set name you want to delete.
2. Press Enter.

Selecting a License File

You can select a license file for further processing. All processing of license certificates and of products and options occur only in the currently selected license file.
1.Type S next to the fully qualified data set name you want to select. The fully qualified data set name also appears at the top of the screen in the LICENSE FILE field.
2.Press Enter.

Option 3 – Import License Certificate Screen

The process of converting a license certificate, as provided by BMC AMI, into records on a license file is known as importing the license certificate. Use the Import License Certificate screen to send a license certificate to the LMS server and the server performs the import. You can access this screen by typing 3 on the command line of the ISPF Interface Main Menu screen and pressing Enter.

Import License Certificate Screen

To import a license certificate, follow the steps below.

1. In the CERTIFICATE DSN field, type the fully qualified data set name (without quotes) of the file containing a license certificate.
2. In the REPORT DSN, type the fully qualified data set name of a file to hold the import report. For both the certificate data set and the report data set, you can specify a member name if the data set is partitioned. If you specify the name of an existing sequential file for the report data set or an existing member name on a partitioned data set, the sequential file or member is replaced by the new report.
3. Press Enter.

The certificate data in this data set is imported into the license file which you previously selected, and whose name appears in the LICENSE FILE field at the top of the screen.
Be patient after pressing Enter, the import can take up to a minute to complete. When the import is finished, you are taken to the Report File Disposition screen where you can display the results of the import.

Report File Disposition Screen

You are automatically taken to the Report File Disposition screen when you complete a license certificate import using the Import License Certificate screen.

You may choose one of the following options:

Option V—To view the import results on your terminal. Use the ISPF Browse function to display the report.

Option D—To delete the import report.

Type the option on the command line and press Enter to process the selection and display the results in the format of your choice.

Option 4 – LPAR Maintenance Screen

You can access the LPAR Maintenance screen by typing 4 on the command line of the ISPF Interface Main Menu screen and pressing Enter. On this screen, you can manually add, update, or delete LPAR definitions from the selected configuration. If you have cloned the active configuration, you can see on this screen a list of all LPARs which were connected to the LMS server (or which had been added before the configuration was activated).

LPAR Maintenance Screen

The following information is displayed for each LPAR:

• CPU SERIAL—The last six hexadecimal digits of the serial number of the CEC on which this LPAR is defined.
• LPAR NAME—The name of the LPAR as defined in the Hardware Management Console (HMC) of this LPAR.
• SYSTEM NAME—The name of the z/OS (or OS/390) operating system for this LPAR (CVTSNAME).
• LMS ID—The LMS SUBSYSTEM ID as defined in the client LMSINIT SYSIN data set.
• LPAR TYPE—The types of LPAR — UNCAPPED, CAPPED, or DEFINED (capacity).
• LPAR MSUs—The number of MSUs currently allocated to this LPAR.
• CEC MSUs—The total number of MSUs consumed by the entire CEC.
• LPAR STATUS—The current LMS status of this LPAR.

To add a New LPAR:

1. Type N on the blank line next to CPU SERIAL field.
2. Type all of the information about the LPAR into each of the fields described above.
3. Press Enter.
   When you later activate this configuration, and the actual LPARs connect with the server, you may see the value of the fields LPAR MSUs and CEC MSUs change from the values you entered. This occurs if the values you entered did not match the actual values in the HMC for this LPAR.

Deleting an LPAR

If you are displaying the active configuration, you cannot delete an LPAR.

1. Type D on the same line as the LPAR you want to delete.
2. Press Enter.

Option 5 – Product/Option Maintenance Screen

You can access the Product/Option Maintenance screen by typing 5 on the command line of the ISPF Interface Main Menu screen and pressing Enter. In order for you to access this screen, you must have first selected a configuration and a license file. You may have imported one or more certificates into the license file, or the license file may have already contained all the products and options.

On this screen, you may only delete products (not individual options), select products or options, or disconnect LPARs from products or options.

Associate LPAR(s)

To select a product or option for further processing, follow the steps below.

1. Type A on the line next to the product or option you want to process.
2. Press Enter.

The Product Associations screen is displayed, allowing the product or option you have chosen to be associated with one or more LPARs.

Associate Product and Related Options

To select a product and related options for further processing, follow the steps below.

1. Type AP on the line next to the product you want to process.
2. Press Enter.

The Product Associations screen is displayed, allowing the product and related options you have chosen to be associated with one or more LPARs.

Disassociate LPAR(s)

To disconnect an LPAR from a product or option, follow the steps below.

1. Type D on the line next to the LPAR you want to disconnect.
2. Press Enter.

The product or option is no longer licensed to run on that LPAR.

Deleting a Product/Option

To delete a product from the selected license file, follow the steps below.

1. Type X on the line next to the product you want to delete.
2. Press Enter.
   The selected product, all of its CPUs and LPARs, and all of the options of this product (and option CPUs and LPARs) are physically deleted from the selected license file.

Expand

To display the next lower level of information for options associated with a product, follow the steps below.

1. Type E on the line next to the product you want to expand.
2. Press Enter.

The next lower level of options for the selected product is displayed.

Expand All

To display all currently non-displayed options/associated LPAR information, follow the steps below.

1. Type EA on the line to expand all products.
2. Press Enter.

All options/associated LPAR information are displayed.

Collapse

To hide the displayed options associated with a product, follow the steps below.

1. Type C on the line next to the product you want to collapse.
2. Press Enter.
   The options associated with the selected product are hidden.

Collapse All

To hide all non-product information, follow the steps below.

1. Type CA on the line to collapse all products.
2. Press Enter.
   All non-product information is hidden.

Propagate LPAR Associations

To process all A and AP commands using the same set of LPARs that will be selected on the Product Association Screen, follow the steps below.

1. Type a / on the line next to Propagate LPAR Associations.
2. Select products and related options/associated LPARs for association.
3. Press Enter.
   The product association screen is displayed only once for all products and options selected.

Product Associations Screen

You can access the Product Associations screen by selecting a product or option line on the Product/Option Maintenance screen. This screen displays a list of all LPARs which are currently defined for the selected configuration.
In order to view this screen, you must perform all of the following functions first:

• Select a configuration. See “Selecting a Configuration”.
• Select a license file. See “Selecting a License File”.
• Select a product or option. See “Associate Product and Related Options”.

Product Associations Screen

Associate LPAR with current Product/Option

To associate an LPAR with the selected product or option, follow the steps below.

1. Type an S on the line containing the LPAR you want to associate.
2. Press Enter.
   When an LPAR is selected, the LPAR STATUS field is updated with the word ASSOC. See “Validating a Configuration”.

Select All

To associate all LPARs with the selected product follow the steps below.

1. Type a / on the line next to Select All.
2. Press Enter.
   The LPAR STATUS field for all LPARs will be updated with the word ASSOC. See “Validating a Configuration” on page 5-5

Invert Selection

To associate only the LPAR(s) that do not have an S on the line next to the LPAR, follow the steps below.

1. Type a / on the line next to Invert Selection.
2. Type an S on the line next to the LPAR(s) you do not want to associate with the selected product or option.
3. Press Enter
   The LPAR STATUS field for all LPARs that did not have an S on the line next to the LPAR will be updated with the word ASSOC. See “Validating a Configuration” on page 5-5

Column Masking

Column masking is a new facility aimed at simplifying the instances when you must interact with the list of LPARs. It is of particular interest to users who have more than a dozen or so LPARs that are participating in the CLF environment and is intended to reduce the amount of visual information on the panel to a more manageable level.

Column masking is available on the Product Associations Screen on page 5-13 and the LPAR View Screen on page 5-18. A line of pink asterisks immediately below the table headings on these panels indicates the presence of this facility on a particular panel. Any values entered into these pink asterisk filled fields are logically combined using an AND operator and compared to their respective column values to determine if a table row should be displayed or hidden. Masking can be accomplished by complete or partial data match. Both complete and partial data matching is performed against the table column value from left to right. There is no provision for right to left data matching.

Complete Data Match

To use complete data matching, follow the steps below.

1. Enter the data into the mask field followed by a blank space.
2. Press Enter.

Table rows matching the data entered into the mask field are displayed. All other table are rows hidden.

Partial Data Match

To use partial data matching, follow the steps below.

1. Enter the partial data into the mask field followed by an asterisk and a blank space.
2. Press Enter.
   Table rows matching the partial data entered into the mask field are displayed. All other table rows are hidden.

Multiple Data Match

To use data matching in multiple columns, follow the steps below.

1. Enter complete or partial data into multiple mask fields. See “Complete Data Match” on page 5-14 and “Partial Data Match” on page 5-14.
2. Press Enter.
   Table rows matching the data entered into the mask fields are displayed. All other table rows are hidden.

Reset Data Match

To clear a column mask, follow the steps below.

1. Enter an asterisk followed by a blank space into the mask field.
2. Press Enter.
   The column mask is reset to all asterisks and the table is displayed.

Option 6 – Server Log Status Screen

LMS contains a facility for recording extensive diagnostic information, which is useful to BMC AMI personnel in debugging errors within LMS. When you install and run the LMS server for the first time, this log facility is not turned on. By using the Server Log Status Screen, you can invoke the log facility and request that it begin writing the diagnostic information. You can access the Server Log Status screen by typing 6 on the command line of the ISPF Interface Main Menu screen and pressing Enter.

Server Log Status Screen

The following fields contain information about the current status of the log.

Press Enter to process the selection and display the appropriate results.

Option 7 – Sever History Maintenance

The Server History Maintenance option is used to view, open or close history data. You can access the Server History Status screen by typing 7 on the command line of the ISPF Interface Main Menu screen and pressing Enter.

Server History Status Screen

The following fields contain information about the current status of the server history.

Press Enter to process the selection and display the appropriate results.

Option 8 – LPAR View

You can access the LPAR View by typing 8 on the command line of the ISPF Interface Main Menu screen and pressing Enter. This screen displays a list of all LPARs which are currently defined for the selected configuration.
In order to view this screen, you must perform all of the following functions first:

• Select a configuration. See “Selecting a Configuration” on page 5-5.
• Select a license file. See “Selecting a License File” on page 5-7.

LPAR View Screen

Expand

To display the selected LPARs associated products and options, follow the steps below.

1. Type E on the line next to the product you want to expand.
2. Press Enter.
   The selected LPARs associated products and options are displayed.

Expand All

To display all the selected LPARs associated products and options, follow the steps below.

1. Type EA on the line next to the product you want to expand.
2. Press Enter.
   All LPARs associated products and options are displayed.

Close

To collapse the selected LPARs associated products and options, follow the steps below.

1. Type C on the line next to the product you want to expand.
2. Press Enter.
   The selected LPARs associated products and options are collapsed.

Close All

To collapse all the selected LPARs associated products and options, follow the steps below.

1. Type CA on the line next to the product you want to expand.
2. Press Enter.
   All LPARs associated products and options are closed.