15.00 - Changing Maximum Sessions Per Gateway - Teradata Database

Teradata Database Utilities

Teradata Database
Release Number
Content Type
Publication ID
English (United States)
Last Update

Changing Maximum Sessions Per Gateway

The number of supported sessions is based on the following:

  • The number of allotted Parsing Engines (PEs)
  • Usage (resources consumed)
  • Maximum number of sessions per gateway setting
  • If your site runs jobs that are CPU or I/O intensive, you might find that a lower session limit gives better performance. You cannot set the maximum sessions to a negative number.

    To view the current maximum sessions, type:

    gtwcontrol -d

    To set the maximum sessions to 1000, type:

    gtwcontrol -g 1 -s 1000

    where 1 is the number of the host group, and 1000 is the desired maximum number of sessions.

    The new limit is effective immediately.

    If more sessions are active than the new maximum sessions limit allows, then no new sessions are started. No new sessions can log on until the number of sessions is below the maximum sessions limit.