All documentation
Host Gateway Server/Configuration

Host Gateway Server — Configuration

Use the HGS Configuration Utility to define client interfaces, host routes, SSL certificates, and station-name assignments for OS 2200 and MCP hosts.

Last updated December 11, 2006

The Configuration Utility

The HGS Configuration Utility is the central admin UI for the Host Gateway Server. It edits a single configuration that the HGS service reads at start-up and on demand. Changes are applied through the File menu and committed to the configuration database.

General tab

Sets server-wide defaults — license behaviour, diagnostic levels, and the IIS instance used by the configuration server. Most sites only revisit this tab when changing logging or rotating the license.

SSL Certificate Setup

  • Enumerate Web Servers — pick the IIS host whose certificate store should be inspected.
  • Enumerate Server Certificates — list installed server certs with hash/thumbprint.
  • View Certificate — open the standard Windows certificate viewer.
  • Use Certificate from Web Server — copy the selected cert's thumbprint into the active client interface.

Client Interfaces

Each client interface is one network endpoint that HGS opens for inbound emulator traffic. Define one per terminal type / port combination.

  • Name and bound IP address / port — the listening endpoint.
  • Terminal Type and Version — UTS or T27 protocol variant served on this interface.
  • Authentication / Encryption — none, certificate-based, or domain-authenticated.
  • Threads — concurrency budget for this interface.
  • Runtime Information — live state, including current sessions and last error.

Host Connections — OS 2200 (UTS)

UTS routes describe how HGS reaches each OS 2200 host. Each route carries one or more open-ids and a station-name assignment scheme. HGS uses the route plus the inbound interface to pick a station name on session establishment.

Host Connections — MCP (T27)

T27 routes are virtual destinations on the MCP host. The Edit T27 Virtual Destination dialog lets you map the destination's network coordinates and the station behaviour HGS should present to clients.

Performance monitoring hooks

The Configuration Utility surfaces the Windows performance counters HGS publishes — connection counts, characters in/out, and per-interface throughput — so the same names line up with the Session and Performance Monitor and Windows Resource Monitor.