WINMON  - Win32 Monitor Program

The NetSentinel monitor program, WINMON, allows system administrators to map and view the status of all NetSentinel servers and their keys, products, and users.

The program consists of two utilities: NetSentinel Monitor and Edit Monitor Map. The NetSentinel Monitor utility provides an overview of all servers, keys, products, and users. You can view the last access time per user and release licenses from users. Note that the system administrator may establish a password to restrict the use of the release license feature.

In addition, the NetSentinel Monitor utility provides a detailed view of servers, products, and keys through the View by Servers, Products, and Users table.

The monitor program can be customized to your application through the  Edit Monitor Map utility. In addition, the system administrator can identify the servers by name, protocol, and transport and map to individual keys, products, and/or users.

The WINMON program runs on a 32-bit Windows workstation. However, the program can communicate with DOS, OS/2, NLM, Windows 95, and Windows NT servers.

Starting the Monitor

Launch the WINMON program as you would any Windows application. The monitor first searches for the mapping file (MAPFILE.TXT) to verify which servers were accessed during the previous session.

If the system administrator has customized the mapping file through the Edit Monitor Map utility, the monitor will display the server, key, product, and user information specific to your network and application. For additional mapping information, please refer to Setting Up the Monitor in this section.

If the mapping file has not been customized, the monitor searches for keys and provides a standard list of servers, keys, products, and users. The keys are identified by their developer ID, the products are identified by their sub-license ID, and the users are identified by their workstation ID.

To Start the Monitor:

1.	From the Windows Program Manager, enter the name of the program, WINMON, on the Command Line and press ENTER.

2. 	The NetSentinel Monitor screen appears.

Viewing the NetSentinel Monitor

Server	 	The name assigned to a server on this network. In addition, the server information can include the version, transport, protocol, and node/workstation addresses. This field may be edited and maintained by the system administrator.  For additional information, please refer to Setting Up the Monitor later in this section.

Key	A list of all NetSentinel keys currently assigned to the server by the system administrator.  If a specified key supports individual products mapped to the same key or individual sub-licenses mapped to the same key, the Product list box will be enabled and the keys products will be selectable.

If the key does not support any products, the Product list box will be disabled. This field may be edited and maintained by the system administrator.

Product	A list of products for a specific key. All users are assigned to the products by the system administrator are displayed in the Users list box. If the Product list box is disabled, the specified key does not support sub-licenses. This field may be edited and maintained by the system administrator.

Users  	A list of users owning a license for the specific product, mapped to a specific server.  The Last Access Time column details the last time the user accessed the license. If the user no longer needs access to the license, the system administrator can delete the license from the user by selecting the user and pressing the Delete User License button.  The license can be reallocated to another user.  It is recommended that the system administrator create a password to restrict this function. For additional information, please refer to Chapter 7 Client API Calls.

View Keys by Server, Keys, Users	A table that allows keys to be viewed by server, keys, or users. The fields on the table are as follows:

Field	Description

Name	-	The name of the NetSentinel key.

Type	-	The type of NetSentinel key, either Pro or C.

AlgoID	-	The Developer ID for the specific key.

Subs	-	The maximum number of sub-licenses that may be issued.

Max	-	The maximum number of users that may be issued.

Users	-	The current number of users that own a license.

Peak	-	The greatest number of licenses issued during this session.

Locked	-	Whether or not the key is currently locked against queries.

In addition, you may perform the following actions:

Option	 	Description

Edit Mapping File  -     	Provides access to the WINMON Mapping utility. A system administrator can customize the monitor and map servers, keys, products, and users.

Update Display -	Updates the display any new information entered in the Edit Mapping File.

Quit - 	Returns to the previous screen.

To display information on NetSentinel Monitor screen:

1.	Select the Server, Key, Product, or User list box.

Or

2.	Select the View Keys by Server,  View Keys by Keys,  or View Keys by Users table by clicking on the specific radio button.

Displaying All Servers

1.	On the NetSentinel Monitor screen, select the Server list box.

2.	Select the server by name or view All Servers. You can view the name of the keys, products, and users mapped to the specific server.

3.	To view additional information, select the View Keys by Server table. You can view the following information by server:

Name, type, and algo ID of  NetSentinel key mapped to a specific server.

Maximum number of sub-license limits that may be issued by a specific server.

Maximum number of users that may be issued licenses by a specific server.

Greatest number of licenses issued during this session.

Whether or not a key is currently locked against queries on a specific server.

Displaying All Keys

1.	On the NetSentinel Monitor screen, highlight the Key list box.

2.	Select the key by name or view All Keys. You can view the name of the products and users mapped to the specific key.

3.	To view additional information, select the View Keys by Key table. You can view the following information by key:

Name, type, and algo ID of  NetSentinel key.

Maximum number of soft license limits that may be issued by a specific key.

Maximum number of sub-license limits that may be issued by a specific key.

Maximum number of users that may be issued licenses by a specific key.

Greatest number of licenses issued during this session.

Whether or not a key is currently locked against queries.

Displaying  All Products

1.	On the NetSentinel Monitor screen, highlight the Product list box.

2.	Select the product by name or view All Products. You can view the name of the users mapped to the specific product.

Displaying All Users

1.	On the NetSentinel Monitor screen, select the server, key, and product from their respective list boxes to filter the users listed in the Users list box.

2.	To view additional information, select the View Keys by User table. You can view the following information by user:

Name, type, and algo ID of  NetSentinel key mapped to a specific user.

Maximum number of sub-license limits that may be issued to a specific user.

Maximum number of users that may be issued licenses to a specific user.

Greatest number of licenses issued to a user during this session.

Whether or not a key is currently locked against queries.

Setting Up the Monitor

The monitor can be customized by the system administrator to identify the specific servers, keys, products, and users within a specific application or program.  If the mapping file is not customized, the monitor will display users by their workstation number, keys by their Developer ID, and products by their sub-licenses.

The information entered in each field will filter information in the other fields. For example, the Server field will filter information in the Key, Product, and Users fields to reflect the status of a specific server. If All Servers is selected in the Server field, all the keys will be displayed.

The Key field will filter information displayed in the Product and Users fields. If the key supports multiple products, the Product field will display the different items supported. If the key does not support products, the Product field will be disabled.

To Set Up the Monitor:

1.	From the NetSentinel Monitor screen, click on Edit Mapping File.

2.	The Edit Monitor Map screen appears.

Viewing the Edit Monitor Map Information

Transport Type	A type of protocol to search for servers.

Server Name	 A name assigned to a server by the system administrator.

Search Limit Decimal	The maximum of number of servers to search for a specific name. The maximum number of servers is 5.

Key Name  	A name of the NetSentinel key currently assigned to the server by the system administrator.

Key ID Hex Value  The Developer ID for a specific key.

Product Name  The product name assigned to a product or license by the system administrator.

App ID Decimal  The sub-license assigned to a specific product.

User Name	The user name assigned to a workstation ID by the system administrator.

Workstation ID Hex	The workstation used by a specific user.

The options on the Edit Monitor Map screen are as follows:

Command	Description

Add -	Adds the name to the selected field.

Delete -	Deletes the name from the selected field.

Previous -	Returns the list in a selected field to the previous name.

Next -	Moves the list in a selected field to the next name.

Save Map - 	Saves the changes to the Edit Monitor Map screen.

Done -	Returns to the NetSentinel Monitor screen.

Editing the Edit Monitor Map

The system administrator may add and delete information on the servers, keys, products, and users whenever needed. Numerous changes can be entered without exiting the screen. However, you must be sure to save the changes when you exit the screen.

To enter the screen,  click on Edit Mapping File on the NetSentinel Monitor screen. To exit, click on Save Map, then click on Done. You will return to the NetSentinel Monitor screen. Click on Update Display to view the changes from the Edit Monitor Map screen.

To Add a Server:

1.	Select the Server Name list box. Click on the Next button near the Server Name field until Server Name? appears.

2.	Enter the name of the server in the Server Name list box. Click on Add.

To Delete a Server:

1.	Select the Server Name list box. Click on the Next or Previous button near the Server Name list box until the specific name appears.

2.	Click on Delete.

To Add a Key:

1.	Select the Key Name list box to map to the server shown in the Server Name field. Click on the Next button near the Key ID list box until Key Name? appears.

2.	Enter the name of the key in the Key Name list box. Click on Add.

3.	Enter the Key ID Hex Value or Algo ID string associated with the key.

To Delete a Key:

1.	Select the Key Name list box. Click on the Next or Previous button near the Key ID list box until the specific name and Key ID appear.

2.	Click on Delete.

To Add a Product:

1.	Select the key you are assigning to a product by clicking on Next and Previous by the Key ID Hex Value list box.

2.	Select the Product Name list box. Click on the Next button near the App ID list box until Product Name? appears.

3.	Enter the name of the product in the Product Name list box. Click on Add.

4.	Enter the App ID or sub-license associated with the product.

To Delete a Product:

1.	Select the Product Name list box. Click on the Next or Previous button near the App ID list box until the specific name and application ID appear.

2.	Click on Delete.

To Add a User:

1.	Select the User Name list box. Click on the Next button near the Workstation ID list box until User Name? appears.

2.	Enter the name of the user in the User Name list box. Click on Add.

3.	Enter the Workstation ID associated with the user.

To Delete a User:

1.	Select the User Name list box. Click on the Next or Previous button near the Workstation ID list box until the specific name and workstation ID appear.

2.	Click on Delete.

Note	It is recommended that a password be required to access the Delete User License function.  If a password is not set, the server will not require a password to delete licenses.  For additional information on creating a password, please refer to Chapter 7 Client API Calls.