Requesting a UTS INT-1 Screen Object

The XML to request a UTS INT-1 screen object is as follows:

<ScreenUts Columns="80" Rows="24">
        <Int1Interface EnvironmentName="UDSSRC" AutoConnect="True"  TerminalID="T1234" DeviceType="UTS60" envPath="yourpath" \>
<\ScreenUts>

Additional ScreenUts, Int1, Int1Interface, tp0 and telcon XML parameters are shown in the tables below. Except where noted, these parameters use the following syntax:

name="value"

where name is the name of a parameter and value is a valid value for that parameter. These tags should be placed within the object being defined. For example, to set the TransmitMode parameter, the first line of the XML shown above would be changed from

<ScreenUts Columns="80" Rows="24">

<ScreenUts Columns="80" Rows="24" TransmitMode="ALL">

The default values are shown in bold in the Value column or given in the Description column. If a parameter is not included in the Web page, its default value is used automatically.

ScreenUts XML Parameters
Parameter	Value	Description
TransmitMode	VAR	Only unprotected data is transmitted.
	ALL	All data is transmitted.
	CHAN	Only changed data is transmitted.
DestructiveSpace	True	The character at the cursor location is deleted when you press the space bar.
DestructiveSpace	False	Pressing the space bar moves the cursor to the right without deleting any characters.
UpperCaseOnly	True	Only uppercase characters are displayed in the viewer window. The letters that appear uppercase only are determined by the CaseLowBoundry and CaseHighBoundry. Any letters between the specified letters display only in uppercase.
UpperCaseOnly	False	Both lowercase and uppercase characters are displayed.
CaseLowBoundry	character	The letter that indicates the beginning of the range of characters that should appear in uppercase when UpperCaseOnly is True. For example, if CaseLowBoundry is b and CaseHighBoundry is y, and UpperCaseOnly is True, the letters b through y will appear only in uppercase, but any characters outside of that range (in this example, a and z) will appear in both lowercase and uppercase. The default value is a.
CaseHighBoundry	character	The letter that indicates the end of the range of characters that should appear in uppercase when UpperCaseOnly is True. The default value is z.

Int1 XML Parameters
Parameter	Value	Description
InitTrans	transaction	The character, word, or phrase that the client sends to the host when communication with the host is first established (up to 15 characters). This parameter is optional and is primarily used with TIP. For example, you might use ^ to run MAPPER. This parameter can also be used to transmit passwords.
InsertPads	True	The session will insert INT1 PADs into the datastream. Some older host applications expect pieces of the INT1 data to be received in a fixed format; when this is the case, setting InsertPads to True will satisfy the host application.
InsertPads	False	The session will not insert INT1 PADs into the datastream.
DeviceType	value	The type of terminal the viewer emulates. Valid values are UTS20, UTS40, and UTS60. The default is UTS60.

Int1Interface XML Parameters
Parameter	Value	Description
EnvironmentName	filename	The name of the environment XML file found in envPath or on the MCS server.
envPath	path	The full path to the XML specified in the EnvironmentName parameter.
TerminalID	terminalid	The terminal identifier (up to 12 characters) to use to connect to the host. Each terminal ID should be unique within the entire network. The terminal ID is also known as a TID. The default value is blank.
DeviceType	value	The type of terminal the viewer emulates. Valid values are UTS20, UTS40, and UTS60. The default is UTS60.
AutoConnect	True	The UTS session connects to the host when the Open method is called.
AutoConnect	False	The UTS session does not connect to the host when the Open method is called. This allows your session to be connected to Int1 without automatically being connected to the host.
ConnectString	string	The command to use to establish a session with the host (up to 10 characters). The default value is $$OPEN.
DisconnectString	string	The command to use to end a session with the host (up to 10 characters). The default value is $$CLOSE.
AddressPool	poolname	The name of the address pool from which to obtain a terminal ID. This name must match an address pool name in ID Manager. If a value is specified for AddressPool, any value associated with UserName is ignored. The default value is blank.
UserName	username	The name of the user for whom to obtain a terminal ID from ID Manager. This name must match a user name in ID Manager. If a value is specified for AddressPool, any value associated with UserName is ignored. The default value is blank.

tp0 XML Parameters

Parameter

Value

Description

RemotePort

number

The number of the host port to use.

The default value is 102. Add a RemotePort to the environment file only if you need to use a different host port. For the appropriate port number, contact your host administrator.

Lingering

seconds

Instructs the TCP stack how to close host connections. A value of 0 tells the stack to send a TCP RST when the connection is closed and flush any pending data. With any other value, the stack will send a TCP FIN after waiting the specified number of seconds for any unsent data to be sent.

This parameter may not work with some older JVMs.

The value must be greater than or equal to zero. The default is 3.

InetAddress

ipaddr

The IP address of the host front-end.

Tsap

string

The Transport Service Access Point to use to access the specified host application (up to 32 characters). For example, you might use TIPCSU for TIP connections, or RSDCSU for Demand connections. If you're not sure of the value to use, contact your host administrator.

telcon XML Parameters