Verastream SDK for Airlines
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 XML, its default value is used automatically.

Tcpa XML Parameters
Parameter Value Description
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.

The default value is blank.
Width number The number of columns in the presentation space.

The default value is 80. Acceptable values are 80 and 132.
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.
IDMgr URL The URL needed to access the Reflection ID Manager.
For example: “http[s]://DNSName.com[:port]/rwebidm”
*IDMgrPool PoolName Will be sent as specified
*IDMgrIPAddress address The actual IP address will be sent if you supply an empty string, but it may not be the address you expect.
*IDMgrDomainName name The DNS name of the system will be sent if you supply an empty string.
*IDMgrUserName user The name of the current user will be sent if you supply an empty string.
*IDMgrSessionName name A dummy session name will be sent if you supply an empty string.
*IDMgrHostAddr address Will be sent as specified.
*IDMgrHostPort port Will be sent as specified.
*IDMgrApplication appl Will be sent as specified.
*IDMgrAssocSet assoc Will be sent as specified.
*

The IDMgrPool, IDMgrIPAddress, IDMgrDomainName, IDMgrUserName, IDMgrSessionName, IDMgrHostAddr, IDMgrHostPort, IDMgrApplication, and IDMgrAssocSet take effect only if the IDMgr parameter is set with a URL.

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 presentation space 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.
InetAddress ipaddr The IP address of the host front-end.
SecureConnection true Create a TLS-secured connection.
false Create a normal unsecured TCP connection (default).
FIPSMode true Enforce FIPS 140-2 operation (default).
false Allow non-FIPS-approved operation.
KeyStoreFile path Path to the Key Store file (required).
KeyStoreFormat (JKS, BCFKS, PKS12) Format of the Key Store file (required).
KeyStorePWD password Password used to create the Key Store file (required).

Back to top

dcctrl XML Parameters
Parameter Value Description
SOH_ClrScreen True The page containing the cursor is cleared when the presentation space 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 presentation space takes no action when it receives an SOH character from the host.
SOH_ExitsForms True The presentation space exits forms mode when it receives an SOH character from the host.

This option applies to forms mode only.
False The presentation space takes no action when it receives an SOH character from the host.
DC1_Function StayInRcv When the presentation space receives a DC1 character from the host, it remains in receive mode.

If this parameter is StayInRcv, the presentation space remains in receive mode even if the value for the RcvModeHold parameter is False.
LineClr When the presentation space 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 presentation space 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 presentation space 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 presentation space when the presentation space receives an LF character from the host.

The best option for your application 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 presentation space would display two line feeds after each carriage return (one sent by the host and one created by the presentation space).
LFOnly Enter a line feed character in the presentation space when the presentation space receives an LF character from the host.
CR_Function CRLF Enter a carriage return and line feed character in the presentation space when the presentation space receives a CR character from the host.

The best option for your application 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 presentation space would display two line feeds after each carriage return (one sent by the host and one created by the presentation space).
CROnly Enter a carriage return character in the presentation space when the presentation space 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 presentation space receives an ETX (end-of-text) character from the host.
False The Datacomm pointer moves to the ETX location when the presentation space receives an ETX character from the host.
RcvModeHold True The presentation space remains in receive mode after receiving a message from the host.
False The presentation space switches to local mode after receiving a message from the host.

If DC1_Function is StayInRcv, the presentation space 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
Defining an XML Configuration
The Screen Object Model
Requesting a Screen Object