Airlines SDK Help Globe Icon

Requesting a T27 Screen Object

The XML to request a T27 screen object is as follows:

<ScreenT27>
        <Tcpa StationID="Terminal" Width="80">
                <Tcpcon InetAddress=yourhost.com\>
	            <TcpXlat TcpaXlat=""\>
        <\Tcpa>
        <T27Config>
                <dcctrl\>
	            <ctldisp\>
	            <tedisp Pages="1" Rows="24" Columns="80"\>
                <tekbd\>
                <tetabs\>
			
        <\T27Config>
        <ReadXlat XlateFileName=""\>
<\ScreenT27>

Additional Tcpa, Tcpcon, dcctrl, ctldisp, tedisp, tekbd, and tetabs XML parameters used by the T27 screen object 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 Tcpa TerminalType parameter, the Tcpa line of the XML shown above would be changed from

        <Tcpa StationID="Terminal" Width="80">
to
        <Tcpa StationID="Terminal" Width="80" TerminalType="UNISYS-TD830-ASCII">

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.

Tcpa XML Parameters
Parameter Value Description
AddressPool poolname The name of the address pool from which to obtain a station ID. This name must match an address pool name in ID Manager.

If UseTidServer is False, any value associated with AddressPool is ignored. If a value is specified for AddressPool, any value associated with UserName is ignored.

The default value is blank.
UseTidServer True The viewer obtains its station ID (SID) from ID Manager.

If UseTidServer is True, any value associated with SID is ignored.

False The viewer uses the station ID specified by the SID parameter.

If UseTidServer is False, any value associated with UserName or AddressPool is ignored.

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 UseTidServer is False, or if a value is specified for AddressPool, any value associated with UserName is ignored.

The default value is blank.
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 knows as a TID.

The default value is blank.

StationID stationid The station identifier (up to 16 characters) to use to connect to the host.

Each station ID should be unique within the entire network. In addition, if UseTidServer is True, any value associated with StationID is ignored.

The default value is blank.
Width number The width of the embedded viewer window in pixels.

The default value is 0. This ensures that an empty area does not appear within the Web page. The size of the framed viewer window is determined not by this parameter, but rather by the font, font size, and other configuration parameters.

TerminalType Auto Select Connect to the host using the first terminal emulation type that works. (Each possible terminal emulation type is tried sequentially until a successful connection is established.)

Some hosts require that the terminal type be specified. If your host requires this, use one of the values listed below.

UNISYS-TD830 Connect to the host using the Unisys TD830 terminal emulation type.

UNISYS-TD830-ASCII Connect to the host using the Unisys TD830 ASCII terminal emulation type.

UNISYS-TD830-INTL Connect to the host using the Unisys TD830 INTL terminal emulation type.

UNISYS-TD830-NDL Connect to the host using the Unisys TD830 NDL terminal emulation type.

Back to top

Tcpcon XML Parameters
Parameter Value Description
Lingering seconds The number of seconds to wait for an acknowledgment from the host when the viewer closes the connection. If an acknowledgment is not received within this amount of time, the connection closes anyway.

The value must be between 3 and 20 inclusive. If you specify a value less than 3, the default value is used.

The default value is 3.
RemotePortAddress 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.

Back to top

dcctrl XML Parameters
Parameter Value Description
SOH_ClrScreen True The page containing the cursor is cleared when the viewer receives an SOH character from the host. This ensures that the host has an empty page on which to write data.

This option applies only to nonforms mode.

False The viewer takes no action when it receives an SOH character from the host.
SOH_ExitsForms True The viewer exits forms mode when it receives an SOH character from the host.

This option applies to forms mode only.

False The viewer takes no action when it receives an SOH character from the host.
DC1_Function StayInRcv When the viewer receives a DC1 character from the host, it remains in receive mode.

If this parameter is StayInRcv, the viewer remains in receive mode even if the value for the RcvModeHold parameter is False.

LineClr When the viewer receives a DC1 character from the host, it clears the page from home to the end of the line where the cursor is located.
DC2_Function ToggleForms When the viewer receives a DC2 character from the host, it switches from forms mode to nonforms mode, or from nonforms mode to forms mode if at least one unprotected field exists on the page.
AdvanceDCP When the viewer receives a DC2 character from the host, it stays in the current mode and moves the Datacomm pointer forward one space.
LF_Function CRLF Enter a carriage return and line feed character in the viewer window when the viewer receives an LF character from the host.

The best option for your Web page depends on how your host application formats its transmissions. For example, your host application might transmit both CR and LF characters. If you set this option to CRLF, the viewer window would display two line feeds after each carriage return (one sent by the host and one created by the viewer).

LFOnly Enter a line feed character in the viewer window when the viewer receives an LF character from the host.
CR_Function CRLF Enter a carriage return and line feed character in the viewer window when the viewer receives a CR character from the host.

The best option for your Web page depends on how your host application formats its transmissions. For example, your host application might transmit both CR and LF characters. If you set this option to CRLF, the viewer window would display two line feeds after each carriage return (one sent by the host and one created by the viewer).

CROnly Enter a carriage return character in the viewer window when the viewer receives a CR character from the host.
ETX_Advance True The Datacomm pointer moves one position to the right of the ETX location when the viewer receives an ETX (end-of-text) character from the host.
False The Datacomm pointer moves to the ETX location when the viewer receives an ETX character from the host.
RcvModeHold True The viewer remains in receive mode after receiving a message from the host.
False The viewer switches to local mode after receiving a message from the host.

If DC1_Function is StayInRcv, the viewer stays in receive mode even if RcvModeHold is False.

FormXmitToCursor True When the session is in forms mode, all transmittable fields between home and the cursor position are transmitted.
False When the session is in forms mode, all transmittable fields on the page are transmitted.
LineAtATimeXmit True Only the line containing the cursor is transmitted.
False The entire page is transmitted.

This parameter does not affect the TransmitLine action. That action always transmits only the line containing the cursor.

EnableMobileHome True Host sequences can set a mobile home.
False Any host sequence that sets a mobile home is ignored.
RawEightBit True Extended characters are transmitted to the host, preserving the values above ASCII 127.

To use the euro symbol, the value for RawEightBit must be True.

False Extended characters are transmitted as 7-bit characters.

Back to top

ctldisp XML Parameters
Parameter Value Description
VT_PageAdvance True If the session is configured for 32 lines per page, vertical tabs are set on lines 1, 9, 17, and 25.
False No vertical tabs are set.
TranslateSOSI True Convert the SO character to Esc ' . and convert the SI character to Esc ' /. Any extended characters are preceded by Esc SO (which converts any subsequent 8-bit characters to 7-bit characters) and followed by Esc SI (which indicates that any subsequent characters will be handled as they normally would).

If ExtendedSOSI is set to True, then the setting of this option has no effect. This option performs the functions described here only if ExtendedSOSI is set to False.

False SO/SI characters are sent to the host without being converted, and any extended characters are preceded by Esc SO and followed by Esc SI.
ExtendedSOSI True Convert the SO character to Esc ' . and convert the SI character to Esc ' /. Any extended characters are preceded by SO (making them appear in reverse video) and followed by SI (making any subsequent characters underlined).

This option applies only to data being transmitted to the host, not data received from the host.

False If you set both this option and TranslateSOSI to False, SO/SI characters are sent to the host without being converted. Any extended characters are preceded by Esc SO (which converts any subsequent 8-bit characters to 7-bit characters) and followed by Esc SI (which indicates that any subsequent characters will be handled as they normally would).

If you set this option to False and set TranslateSOSI to True, SO characters are converted to Esc ' . and SI characters are converted to Esc ' /. Any extended characters are preceded by Esc SO and followed by Esc SI.

Back to top

tedisp XML Parameters
Parameter Value Description
Alt_Left_Delim 0x0-0x7F The hexadecimal value of the character to use for the unit separator (left delimiter).

The default value is 0x1f.

Alt_Right_Delim 0x0-0x7F The hexadecimal value of the character to use for the record separator (right delimiter).

The default value is 0x1e.

NoSkipField True The cursor remains in the current field, even when it is full.
False The cursor advances to the next field as soon as the current field is completely full.

Back to top

tekbd XML Parameters
Parameter Value Description
DispTabSym True When you press Tab, a tab symbol appears.
False When you press Tab, no tab symbol appears.
SpecialScroll True Display any data received from the host on the subsequent page when the current page is filled.
False Data appears only on the current page. When the current page is filled, the cursor moves home on the same page, and the data received from the host overwrites the data currently on the screen.

Back to top

tetabs XML Parameters
Parameter Value Description
Columns number The width of the T27 terminal. The default is 80.

Back to top

Related Topics
The Screen Object Model
Requesting a Screen Object
Common Tasks
  Footer