Configuration in UNIX

The driver can be configured and commanded to issue and handle some LU 6.2 control modes and verbs.

Note: On AIX systems, the supported SNA product is IBM Communications Server.

Name pane

This table shows the parameters for the Name page:

Symbolic Name Specify the CPIC Symbolic Name. This is defined when configuring IBM Communication Server SNA (AIX).
Connection Type Select the appropriate connection type:
  • Call, or initiate connection, contacts a remote entity and requests a connection with an RTPN (Remote Transaction Program Name).
  • Listen, or await connection, connects user-specified local TPN (Transaction Program Name) requests to the driver for registering with SNA.
  • If the thread is not running, then applications attempting to connect to its TPN receive "TPN Not Recognized" errors.

Call Properties pane

This table shows the parameters for the Call Properties page:

RTPN For a Call connection, specify the RTPN (Remote Transaction Program Name). RTPN is an application that uses this connection to send data to another application.
Delay Select this to delay connection allocation until there is a message to write. When you use this option, the driver allocates a conversation only when required for an outbound message.

When this option is not selected, the driver attempts to allocate a conversation with the LISTENer as soon as possible. That is, during thread startup, after message writes if Deallocate is set, and so on.

Security pane

This table shows the parameters for the Security page:

Secure Select this to configure the driver to use the LU 6.2 security options. If this option is used, then the driver requests SECUR_PGM and includes the configured User ID and Password values. Otherwise, it uses SECUR_NONE. This option is available only if Call is selected.
User ID Specify the user ID. This option is available only if Secure is selected.
Password Specify the log-in password. This option is available only if Secure is selected.

Listen Properties pane

For a Listen connection, specify the TPN (Transaction Program Name). TPN is an application that uses this connection to receive data from another application.

Sync Level pane

This table shows the parameters for the Sync Level page:

Conversation sync level None means SNA provides no synchronization services.

Confirm prepares the conversation for possible CONFIRM/CONFIRMED verb use. If this option is used, then select Auto-confirm to automatically send a CONFIRM request with every message.

Auto-confirm Select this to request a Confirm for every message that is written to the connection. This option is available only if Confirm is selected.

Miscellaneous Properties pane

This table shows the parameters for the Miscellaneous Properties page:

Control Messages Select this to enable the driver to use the DRIVERCTL metadata. Modify the driver’s behavior by embedding certain control information in the metadata field. The driver also reports the state of the connection in the inbound message’s DRIVERCTL field values. Setting this option permits greater flexibility and control, but at the expense of memory and speed.
Deallocate Select this to configure the driver to deallocate the connection, or conversation, after every message send.
EBCDIC Alloc Select this to convert the RTPN/TPN to EBCDIC format. If this option is not selected, then ASCII is used.
Flush Select this to automatically flush the buffer after each operation.
Auto-Reconnect Select this to automatically reestablish a broken connection.
Full-Duplex Select this to place the conversation in a RECEIVE state after each message is sent. This requires a response for each request. The remote application must explicitly pass SEND control back to the driver. This option is unavailable if the connection is send-only.
Reopen Time Specify the minimum number of seconds to wait after connection failure before reconnection. The default is 5. This option is available only if Auto-Reconnect is selected.

Start-up Procedures pane

Click Edit to open the TPS Editor. Use this to select the Tcl procedures to run when the thread starts. This is a TPS (Tcl Procedure Stream). Use it to trade messages with the remote end.