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.

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
  Footer