Monitor ID Settings

The Monitor IDs panel displays a summary of terminal ID Pools and Association Sets.

Options

Display Options

Either keep the default to show All IDs, or use the drop-down menu to filter the display by the current ID attributes. Choose from these options:

• All IDs: the default

• Allocated IDs: only those pools that contain IDs that have been allocated.

• Non-allocated IDs: only those pools that contain IDs that have not been allocated

• Timed Out IDs: only those pools that contain IDs that have timed out.

• Held IDs: only those pools that contain IDs that are in Hold status.

• Timed Out and Held IDs: only those pools that contain IDs that are in a simultaneous status of being timed out and held.

Actions

• Refresh all settings on this panel.

  Click Refresh to redisplay the settings for each Pool and Association Set, including changes made on the individual panels.

• Hold all IDs in a particular pool.

  To set an administrative Hold on all of the IDs in a pool, click any cell in the row, except the underlined name of the pool. (Clicking the Name opens the details page for that pool.)

  Then click Hold, OK, and Close.

  Result: Any available IDs put on hold will not be considered for allocation. If an ID is currently allocated, the client will be notified that the ID should be returned.

• Release any IDs that are being Held in a particular pool.

  To Release IDs, click the Selection Criteria entry next to the Name of the pool. Then click Release, OK, and Close.

  Result: All of the IDs that were put on Hold are released and available for allocation, unless previously allocated.

To manage the individual IDs, click the Name of the Pool or Association Set, which open a separate panel.

When you select items to Hold or Release, you will see a message to confirm the action.

Pools

The currently defined pools are listed in this table, along with their attributes. Use the Column Chooser to customize the display.

• Name: the name for this pool, set in the database

• Selection Criteria: the ID attributes that must match request attributes from the client in order to have an ID allocated from this pool

• ID Totals: the number of IDs in the pool

• Allocated: the number of IDs in the pool that are currently allocated

• Free: the number of IDs in the pool that are not allocated, and available for client sessions (if not held)

• Held: the number of IDs in the pool that are in Hold status, and therefore currently unavailable for further allocation to client sessions

• Timed Out: the number of IDs in the pool that have exceeded the configured communication timeout interval

• Communication timeout interval: the number of minutes that must elapse without communication with an allocated session for an ID to be classified as timed out

  If no value is specified here, the server default, specified in Server Settings is used. See Communication timeout interval.

• Heartbeat interval: the number of minutes in which a client is expected to send a regular heartbeat message to the server, indicating that the ID is still in use by the client.

The value set in Server Settings applies to all pools unless the value is explicitly overridden for an individual pool during pool configuration.

In the list of pools, you can

• Click Download CSV to view this table’s data in a spreadsheet.

• Click the Name of a pool to configure settings for the IDs in that pool.

Pool IDs

The Pool IDs panel opens when you click the Name of a pool on the Terminal ID Manager - Monitor IDs panel. This panel shows the current Pool Settings, the ID Summary, and the specific IDs in that pool.

• Pool Settings

  Each ID in this pool satisfies the Selection Criteria, which was set in the database, and summarized here. The Communication timeout and Heartbeat intervals are shown here for easy reference.

• ID Summary

  You can easily see how many licenses in this pool are Allocated, Free, Held, or Timed Out. Look in the table to identify which IDs have those attributes.

• IDs

  By default, All IDs are shown in the table. Use the Show menu and the Column Chooser to customize the display.

  Note

  An attribute without a value is either currently not defined or not required for the IDs in that pool.

  ID	Description
  Name	the name for this pool, set in the database
  Session type	the type of session, such as 3270, UTS
  Emulator type	Terminal or printer
  Status	the status of the ID: Allocated, Free, Free but currently Held, Allocated but currently Held, Allocated and Timed Out, or Allocated and Timed Out and Held
  Host port	the target host and port
  Session name	the name of the client session that allocated the ID
  User name	the user that is associated with the allocated session. The value for the user name is based on the user that is logged on to the operating system.
  Client DN	the domain name of the client using the ID
  Client IP	the IP address of the client using the ID
  Association Set	If specified, this ID is a member of the Association Sets having this name
  Allocated	a timestamp indicating when the ID was allocated
  Heartbeat	a timestamp indicating the last communication from the client session
  Timed out	a timestamp indicating when the ID went to a Timed Out status
  Application	For UTS sessions, the application that the session will start after connecting

Actions

Use the control buttons to Hold, Release, or Reclaim one or more specific IDs.

• Hold: Set an administrative Hold on the selected IDs. The ID Status changes to Free/Hold or Allocated/Hold.

  Any available (Free) IDs that are put on Hold will not be considered for allocation. If an ID is currently allocated, the client will be notified (during the next client heartbeat) that the ID should be returned.

• Release: Release any of the selected IDs that are in Hold status. The ID Status changes to Free.

• Reclaim: This button displays if a pool is expanded to show IDs. When reclaimed, any selected ID that is allocated is changed to unallocated status.

Association Sets

An Association Set is a group of defined pools. The set provides a secondary grouping of IDs as another way to monitor IDs.

Each set of IDs mirrors an existing association between the device identifiers defined on the target hosts, in which groups of IDs operate together to provide a single emulation user a host-defined application functionality. For example, an association can facilitate routing of print output from a given emulation terminal to a specific emulation printer.

In the list of Association Sets, on the Terminal ID Manager - Monitor IDs panel, you can

• Click Download CSV to view this table’s data in a spreadsheet.

• Click Show Set IDs (or the Name of a set) to configure settings for the Pool IDs in that set.

Set IDs

The Set IDs panel opens when you click the Name of an Association Set on the Terminal ID Manager - Monitor IDs panel. The Set IDs panel shows the ID Summary and the specific pool IDs in that set.

ID summary

At a glance, you can see how many licenses in this set are Allocated, Free, Held, or Timed Out. The Selection Criteria (defined in each pool) are not included.

Look in the table to identify which IDs have those attributes.

IDs

Each Pool in the set is listed with each of its IDs. By default, All IDs in the set are shown in the table. Use the Show menu and the Column Chooser to customize the display.

• Pool: the name of a pool in this set

• ID: name of an ID in a named Pool

• User Name: the user that is associated with the allocated session. The value for the user name is based on the user that is logged on to the operating system.

• Emulator Type: Terminal or Printer

• Status: the status of the ID: Allocated, Free, Free but currently Held, Allocated but currently Held, Allocated and Timed Out, or Allocated and Timed Out and Held

Actions

Use the control buttons to Hold, Release, or Reclaim one or more specific IDs.

• Hold: Set an administrative Hold on the selected IDs. The ID Status changes to Free/Hold.

• Any available (Free) IDs that are put on Hold will not be considered for allocation. If an ID is currently allocated, the client will be notified that the ID should be returned.

• Release: Release any of the selected IDs that are in Hold status. The ID Status changes to Free.

• Reclaim: This button displays if a pool is expanded to show IDs. When reclaimed, any selected ID that is allocated is changed to unallocated status.

When you select items to Hold, Release, or Reclaim, you will see a message to confirm the action.

On the Terminal ID Manager - Monitor IDs panel, click Refresh to update the table with your changes.