File Syntax for Importing IDs

To import IDs, create a text file that uses the following syntax, one ID per line:

pool name,pool_type,ID,ID_type,[lease_timeout],[inactivity_timeout],[set],terminal_type,[ordinal],[host_name_alias]

The items in brackets are optional. If you include these items, do not type the brackets. If you include some optional items but omit others, retain the commas as placeholders, as in the following example:

Alice,1,T101,terminal,,,,3270,,
Alice,1,T102,terminal,,,,3270,,

The following table describes each parameter of this syntax.

Parameter Description
pool name One of the following:
  • A user name
  • The IP address of the client
  • The DNS name of the client
  • The name of the named pool

The user name must match a user name in the directory service used by Management & Control Services (MCS). If the client is not prompted for a user name when accessing a configuration or application, you cannot assign IDs to user names; you must assign them to named pools, IP addresses, or DNS names.

In addition, if the user types both a domain or server name and user name when accessing the configuration or application, both must be included in the data file, as in domain_1/user_1.

Pool names cannot contain spaces.

For more information about ID pools, see Configuring ID Pools.

pool_type One of the following:
Pool type
Value
A user or group name 1
An IP address 2
A domain name 8
A named pool 4

Some products support only some of the pool types. For information about the pool types you can use, see the documentation for your product.

ID One of the following:
  • A UTS terminal ID (up to 12 characters)
  • A T27 station ID (up to 16 characters)
  • A 3270E or 5250E logical unit
  • An Apollo Galileo client ID (in the format wxxx####, where xxx is usually a three-letter airport code, and #### is usually the workstation number)
  • An EDS SHARES or Sabre LNIATA (a unique six-digit hexadecimal number)
  • A MATIP ALC terminal address (a unique two-digit hexadecimal number)
  • A MATIP UTS station ID (a unique two-digit hexadecimal number)

Do not assign the same ID to different pools if the ID is being used by both pools to connect to the same host.

Do not assign IDs for both T27 and UTS sessions to the same name if the IDs are configured for use with e-Vantage Gateway (that is, if ID_type is an asterisk).

ID_type One of the following:
For
The ID_type is this
A direct connection for T27, 3270, 5250, or ALC viewer terminal
A direct connection for a T27, 3270, 5250, or PTR printer applet. printer
A direct connection for a UTS configuration or application to a specific host application. The name of the host application, such as UDSSRC or Demand.
A direct connection for a UTS configuration or application to any host application. *
Any e-Vantage Gateway connection. *
Note Note for UTS connections: For direct connections, if you use an asterisk (*), the clients will be able to access any host application. If all of the IDs for a pool specify a host application name, the clients will be able to access only the specified host applications. To use the same ID for multiple host applications, create a record for each host application, as in the following example:

Alice,1,T101,UDSSRC,,,,UTS,,
Alice,1,T101,DEMAND,,,,UTS,,

For e-Vantage Gateway connections, the configuration of the host path determines which environments are accessible. For more information, refer to the documentation for e-Vantage Gateway.

lease_timeout The number of hours that must elapse before the ID is made available for another session.

If this value is 0 or omitted, the ID is made available for another session as soon as the first session closes. This value must be the same for all entries associated with a particular pool.

For more information about the timeouts, see Reclaiming IDs.

inactivity_timeout The number of minutes of inactivity that must elapse before the session with the host closes automatically.

If this value is 0 or omitted, the session never closes automatically. This value must be the same for all entries associated with a particular pool.

set The name of an ID set.

All IDs with the same set name are grouped together.

For more information about ID sets, see Configuring ID Sets.

terminal_type The type of host that the ID can be used with:
Host type
Value
ClearPath IX or 2200 Series (INT1 connection) UTS
ClearPath IX or 2200 Series (MATIP connection) MATIP-UTS
ClearPath NX, ClearPath LX, or A Series T27
IBM Mainframe 3270
IBM AS/400 5250
Apollo Galileo Airline Reservation System Apollo
EDS SHARES Airline Reservation System SHARES
IBM TPF MATIP-ALC
Sabre Airline Reservation System Sabre
ordinal A number other than zero. Use ordinals to control which IDs in a set are allocated to specific configurations. You must assign the same ordinal value to both the ID in the set and the session configuration that should use that ID.

If you specify an ordinal value, you must also specify a set value.

host_name_alias A name that matches a host name on the Host Mappings dialog box.

If you include a host_name_alias, the specified ID can be used only with the IP addresses or DNS names associated with that alias.

For more information about mapping host names, see Mapping Host Addresses to a Single Host Name.

Related Topics
Bullet Managing Host Access IDs, Overview
Bullet Configuring ID Pools
Bullet Reclaiming IDs
Bullet Configuring ID Sets
Bullet Mapping Host Addresses to a Single Host Name
  Footer