UFTXIN Routine

The UFTXIN sample exit routine performs functions to support a single UFTD connect request. Multiple UFTD link drivers can be defined using this sample exit. It also performs simple translation of data to EBCDIC.

Attention
The UFTXIN sample UFTD link driver exit will operate more consistently and seamlessly if UFT commands are sent prior to the data. UFTXIN will accept UFT commands sent after the data, but information required for file processing might not be set up as desired.
The UFTXIN routine parses the user name on the USER command received from the UFT client, as shown in the following examples:
KERRY@GDLVM7
Sets the node ID to GDLVM7 and the user ID to KERRY, causing the file to be sent to user KERRY at node GDLVM7.
KERRY%GDLVM7
Sets the node ID to GDLVM7 and the user ID to KERRY, causing the file to be sent to user KERRY at node GDLVM7.
KERRY@
Sets the node ID to the local node name and the user ID to KERRY, causing the file to be sent to user KERRY on the local system.
KERRY%
Sets the node ID to the local node name and the user ID to KERRY, causing the file to be sent to user KERRY on the local system.
KERRY
Sets the node ID to the local node name and the user ID to KERRY, causing the file to be sent to user KERRY on the local system.
@LASER3
Sets the node ID to LASER3 and the user ID to SYSTEM, causing the file to be sent to the network node LASER3.
%LASER2
Sets the node ID to LASER2 and the user ID to SYSTEM, causing the file to be sent to the network node LASER2.
Notes:
  1. UFTXIN will use only the first 32 characters of the user name.
  2. If you are using a UFTXIN configuration file, UFTXIN will first look for a user name record with that name, or a record called DEFAULT. See UFTXIN Configuration File. If UFTXIN cannot find a matching user name record (or a DEFAULT record), or if it cannot find the configuration file, it will parse the user name as described above.
  3. When parsing the user name, UFTXIN will assume that any user name which does not include the @ or % operator is a user ID.
  4. UFTXIN will limit the length of the user ID and node ID to 8 characters each and will discard any extra data in those fields of the user name.