Verastream SDK for Airlines
Requesting a 3270 Screen Object

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

<ScreenTn3270>
        <Tn3270con>
                <Tcp3270con HostName="yourhost.com" SocketNumber="23"/>
        </Tn3270con>
        <ReadXlat XlateFileName=""/>
</ScreenTn3270>

Additional ScreenTn3270 XML parameters are shown in the table 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 add the TextCase parameter, the first line of the XML shown above would be changed from

<ScreenTn3270>
to
<ScreenTn3270 TextCase="Lower">

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.

ScreenTn3270 XML Parameters
Parameter Value Description
TextCase Mixed Text you type appears in both lowercase and uppercase.
Lower Text you type appears only in lowercase.
Upper Text you type appears only in uppercase.
LPenEnabled True Clicking a pen-detectable field with a light pen or a mouse sends a light pen event to the host.
False Clicking a pen-detectable field with a light pen or a mouse moves the cursor but does not send a light pen event to the host.
BackSpaceKey Backspace Sending a backspace character with SendKeys moves the cursor left one character without deleting the character.
Delete Sending a backspace character with SendKeys moves the cursor left one character and deletes that character.
ModelType 1 Auto senses the screen size.
2 Sets the screen size to 3270 Model 2 (24 x 80).
3 Sets the screen size to 3270 Model 3 (32 x 80).
4 Sets the screen size to 3270 Model 4 (43 x 80).
5 Sets the screen size to 3270 Model 5 (27 x 132).
Rows number The number of rows in the presentation space.

The default is 24 rows.
Columns number The number of columns in the presentation space.

The default is 80 columns.
AttributeStyle Normal Display attributes are processed by the presentation space.
Asterisk Display attributes appear as asterisks (*) in the presentation space.
Dot Display attributes appear as periods (.) in the presentation space.
NumFldOverride True You can enter alphanumeric data in a numeric-only field. Some host applications require this in order to transmit special commands.
False You can enter only numeric data in a numeric-only field.
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.
DestructiveSpace True The character at the cursor location is deleted when you send a space character with SendKeys.
False Sending a space character with SendKeys moves the cursor to the right without deleting any characters.

Back to top

Tn3270con XML Parameters
Parameter Value Description
LUName name Specifies the LU name. Default value is "". Specify an LU if required to do so in order to connect to host. For the appropriate LU, contact your administrator.
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).
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

Tcp3270con XML Parameters
Parameter Value Description
HostName ipaddr The IP address of the host front-end.
PortValue 23 The number of the host port to use. The default value is 23. Add a PortValue to the XML only if you need to use a different host port. For the appropriate port number, contact your administrator.

Back to top

Related Topics
Defining an XML Configuration
The Screen Object Model
Requesting a Screen Object