3.5.3 Configure Advanced Connection Settings Dialog Box (3270)

From this dialog box, you can define advanced TN3270 features.

Advanced TN3270

TN3270 Specific

Treat SYSREQ key as

Select the action that should be taken when you press the SYSREQ key. The definition of this key and its values vary by host application.

Treat ATTN key as

Select the action that should be taken when you press the ATTN key. The definition of this key and its values vary by host application.

Same model for primary and alternate screens

Select to use the same model type for both primary and alternate screen sizes. When selected, you can use a model type other than model 2 for primary screens.

TN3270 Enhanced Protocol

Enable associated printer

Select this option to associate a 3270 terminal session with a specific 3270 printer session, so that all print jobs from the selected terminal session are sent to the print device associated with the specified printer session.

Associated 3270 printer session

Select this option to specify the associated printer session by document name.

When you use this option, the printer session starts automatically when the terminal session connects to the host.

Association string

Select this option to specify the associated printer session using an association string. The string must use only uppercase characters, and is limited to a maximum of 300 characters.

The association string identifies the selected 3270 terminal session. Once you've entered the string here, you can select it from the TN Association list box when configuring the associated 3270 printer session.

When you use this option, you must start the printer session before you can use it.

Connection Action

You can configure a session to run a macro, start an application, open a Web page, send an e-mail message, or perform a variety of other actions before or after it connects to the host.

Run a macro or other action before the initial connection

Select to run the connection action after the session file is opened but before the session initially connects to a host. (This action is performed even if the session is not configured to connect automatically.)

Select Action

Click to select an action to perform or a macro to run before you connect to the host. By default, the Select Action window opens at the screen for selecting a macro. If you prefer to perform a different action when your session connects, you can select other actions from the task pane.

Run a macro or other action after the initial connection

Select to run the connection action when the session initially connects to a host.

Select Action

Click to select an action to perform or a macro to run when you connect to the host.

Run when reconnecting

Select to run the connection action when the session initially connects to a host, and every time it reconnects to the host.

Security

Security Settings

Secure data communications with SOCKS or SSL/TLS.

ELF application ID

Specify the application ID to use the IBM Express Logon Feature (ELF). This feature allows you to connect and logon without entering a user ID and password.

To enable this feature, click Security Settings, then select Use SSL/TLS Security. This feature also requires that you configure the host, install certificates (if necessary) on user computers, and create a connect macro. See Connect 3270 Sessions using the Express Logon Feature (ELF).

Miscellaneous

Keep Alive

Send Keep Alive packets

Select to provide a constant check between your session and the host so that you become aware of connection problems as they occur.

Choose one of the three types of keep-alive packets:

 

Choose

To cause

 

System

The TCP/IP stack to keep track of the host connection. This method requires less system resources than Send NOP Packets or Send Timing Mark Packets. However, most TCP/IP stacks send Keep Alive packets infrequently.

 

Send NOP Packets

InfoConnect to periodically send a No Operation (NOP) command to the host. The host is not required to respond to these commands, but the TCP/IP stack can detect if there was a problem delivering the packet.

 

Send Timing Mark Packets

InfoConnect to periodically send a Timing Mark Command to the host to determine if the connection is still active. The host should respond to these commands. If InfoConnect does not receive a response or there is an error sending the packet, it shuts down the connection.

Keep Alive timeout in seconds

Select the interval between the keep-alive requests. The range of values is 1 to 9999 seconds; the default value is 600 seconds.

Telnet Location

Telnet location

(Optional) Type up to 41 characters of descriptive text to provide information about your session. For example, you might include your system location, computer name, or IP address.

This features uses the SEND-LOCATION option supported under Telnet connections (RFC779).

InfoConnect does not initiate a WILL SEND command unless you activate theTelnet location option by typing information in this box.

HLLAPI

Options

Short name

By default, InfoConnect assigns the first available letter (A if no other sessions are running) and saves that short name value when you save your session document. If you open multiple sessions that have the same HLLAPI short name value, InfoConnect automatically reassigns the HLLAPI short name of each newly opened session using the next available letter.

Select a HLLAPI short name to associate with this session. This value is used by a HLLAPI application to identify a host session. Any single capital letter (A-Z) can be used as a short name.

If your HLLAPI application requires a specific short name value, specify this value, then save your session document. If you run multiple sessions, you must ensure that sessions running at the same time do not require the same HLLAPI short name.

If you want InfoConnect to generate new, arbitrary short name values for each new session, save all session documents with the HLLAPI short name set to A. InfoConnect will always set the HLLAPI short name to A for the first session, and will reset the short name to the next available letter for each subsequent session.

Long name

Enter a HLLAPI long name to associate with this session. A HLLAPI long name identifies the host session for the convenience of the user. It is not used by the HLLAPI application. The long name can be up to eight characters long and can include letters, numbers, and other characters.

Compatibility

If you are migrating from an Extra! or legacy Reflection product, and your application uses the default HLLAPI compatibility settings, simply select Reflection or Extra! from the Compatibility drop-down list. This configures the HLLAPI support in InfoConnect to match the default settings found in those applications.

If your application requires custom HLLAPI compatibility settings, select Custom from the Compatibility drop-down list. Once Custom is selected, you can enter a custom compatibility mask.

NOTE:Because of variations in the implementation of HLLAPI in previous products, when HLLAPI applications from Extra! and from previous versions of Reflection are run against InfoConnect, they may not behave exactly as they did when run against the product for which they were originally written. Even when you have selected the correct compatibility setting, minor differences may be seen in the status or return code reported by a handful of functions.

Custom Compatibility Masks

The possible numeric values for the custom compatibility mask styles are "bit masks" that contain separate bits of information about InfoConnect's HLLAPI configuration. Each style is equated to a decimal and hexadecimal value. A list of the styles and values is shown in the table below.

To create a compatibility mask, add the decimal or hexadecimal values of each style and enter the sum into the Custom Compatibility Mask field. Values can be entered in either decimal or hexadecimal format; however, when using hexadecimal values, replace the 0x at the front of the value with &H. For example, to use hexadecimal value 0x5380, enter &H5380 in the Custom Compatibility Mask field.

For example, to turn on the Propagate EAB (decimal value = 1), Input Inhibited Position (decimal value = 8), and Don't Wrap at PS End (decimal value = 512), add these three numbers (1 + 8 + 512 = 521) and enter the total into the Compatibility Mask field.

 

Style

Decimal Value

Hex Value

 

Propagate EAB When this bit is on, executing a Copy Presentation Space or Copy Presentation Space to String function, with the EAB and NOXLATE session parameters, causes each extended attribute specified at the start of a field to be copied to all characters in the field that do not have the corresponding extended attribute explicitly on. When this bit is off, the attribute is not copied to such characters. This bit applies only to 3270 sessions.

1

0x0001

 

Query Host Update Protocol When this bit is on, Query Host Update functions report changes to the presentation space only if they are initiated by the host. When this bit is off, functions report changes initiated from the host or from the keyboard.

2

0x0002

 

Input Inhibited Position This bit determines the position of the "input inhibited" indicator in the string returned from Copy OIA. When it is on, the indicator appears at position 9. When it is off, the indicator appears at position 5.

4

0x0004

 

Copy PS to String Beyond End This bit determines what happens when the Copy Presentation Space to String function specifies a string that goes beyond the end of the presentation space. When it is on, no error is reported, the data from the position specified to the end of the presentation space is copied, and the remainder of the result string is set to binary zeros. When it is off, InfoConnect returns an error (APIPARAMETERERROR, value 2).

8

0x0008

 

Wait a Second When this bit is on, HLLAPI waits one second beyond the last host-initiated presentation space modification before attempting to return a result. When it is off, HLLAPI does not wait. This affects functions Copy OIA, Query Host Update, Copy Presentation Space to String, and Copy Presentation Space.

16

0x0010

 

Modify Protected Field When this bit is on, the Copy Presentation Space to String function can be used to copy to protected fields. When it is off, such copies are disallowed.

32

0x0020

 

Translate 5250 Attributes to 3270 When this bit is on, attributes copied by the HLLAPI application from the 5250 presentation space are translated to 3270 attributes. When it is off, InfoConnect returns 5250 attribute values (with the high order 2 bits on).

64

0x0040

 

Always Blank When this bit is on, data characters found in the presentation space (by Copy Presentation Space to String or Copy Presentation Space) that can not be translated to ASCII are always translated to spaces. When it is off, the ATTRB setting is used to specify what should be done with such characters (if ATTRB is on, they are passed as their original value; if it is off, they are translated to spaces).

128

0x0080

 

Transmit Modified Protected Fields This bit is relevant when HLLAPI modification of protected fields is allowed (see Modify Protected Field). When it is on, the modified protected field is not sent to the host in response to a read modified command. When it is off, the modified protected field is sent.

256

0x0100

 

Don't Wrap at PS End This bit determines what happens if, on a copy from a string to the presentation space, the end of the presentation space is reached before the string is completely copied. If this bit is on, the operation terminates and returns an APITRUNCATED error. If it is off, copying continues at the beginning of the presentation space.

512

0x0200

 

Error on Bad Escape When this bit is on, undefined escape sequences passed to Send Key are reported by returning APIPARAMETERERROR. When it is off, such errors are ignored.

2048

0x0800

 

Terminate Send Key at AID The default behavior for Send Key is to divide strings to be sent into segments terminated by an AID key, and then to send these segments sequentially, reporting an error only if the emulator objects (through input inhibited or busy status). When this bit is on, HLLAPI terminates the send after the first such segment, reporting an error if Error on Send Key Past AID is on. When this bit is off, HLLAPI does not report an error under such circumstances.

4096

0x1000

 

Error on Send Key Past AID When this bit is on, the HLLAPI application reports an error if Send Key continues to send characters after a transmitted AID key. When it's off, the application does not report an error under such circumstances.

8192

0x2000

 

Return Zero Length Fields If this bit is set, Find Field Position (31) returns APIOK and position of next field (in the position parameter) for a zero length field. Otherwise, it returns APIZEROLENFIELD and a 0 in the position parameter.

16384

0x4000

 

Caching Off When set on, this bit disables the caching mechanism that increases performance. If you are having problems with your application synching with the InfoConnect screen, try turning on this bit. After enabling this bit, you may notice some degradation in HLLAPI performance.

32768

0x8000

 

Old Flashpoint Flashpoint versions 3.1 and earlier expect consecutive CopyPS calls to include or not include attributes regardless of how attributes are set. Turning on this bit makes HLLAPI accept this behavior.

65536

0x10000

 

DOS ASCII Converter This bit converts a HLLAPI character to DOS ASCII format.

131072

0x20000

 

Extra! OIA Values When this bit is on, the Copy OIA returns OIA buffer values that match the Extra! values instead of the default InfoConnect values.

262144

0x40000

 

Rumba Style The InfoConnect HLLAPI configuration matches the default settings found in Rumba.

297

0x0129

 

Extra! Style The InfoConnect HLLAPI configuration matches the default settings found in Extra!.

21376

0x5380