The following applies to the addressing of a partner system:
You can specify the name of the partner from the partner list provided that the partner has been entered in the partner list.
A partner has to be entered in the partner list by the FT administrator. For this purpose, the FT administrator can use the following commands:
ADD-FT-PARTNER
MODIFY-FT-PARTNER
You can access a partner directly via its address in FT or file management requests even if it is not entered in the partner list. This is only possible if the “dynamic partner” function is enabled via operating parameters.
Partner addresses
A partner address has the following structure:
[protocol://]host[:[port].[tsel].[ssel].[psel]]
host (= computer name, see host) is mandatory; all other specifications are optional. In many cases, the other specifications are covered by the default values, so that the host name suffices as the partner address, see Examples. Final ’.’ or ’:’ can be omitted.
The individual components of the address have the following meanings:
protocol://
Protocol stack via which the partner is addressed. Possible values for protocol (uppercase and lowercase are not distinguished):
openft
openFT partner, i.e. communication takes place over the openFT protocol.
ftam
FTAM partner, i.e. communication takes place over the FTAM protocol.
ftp
FTP partner, i.e. communication takes place over the FTP protocol.
ftadm
ADM partner, i.e. communication takes place over the FTADM protocol for remote administration and ADM traps.
Default value: openft
host
Computer name via which the partner is addressed. Possible entries:
BCAM processor name, length 1 to 8 characters
only with FTP partners:
internet host name (e.g. DNS name), length 1 to 80 characters
IPv4 address with the prefix %ip, i.e. for example %ip139.22.33.44
The IP address must always be specified as a sequence of decimal numbers separated by dots and without leading zeros.
IPv6 address with the prefix %ip6, i.e. for example
%ip6[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210](ipv6) or%ip6[FE80::20C:29ff:fe22:b670%5](ipv6 with scope ID)The square brackets [..] must be specified.
The scope ID designates the local network card via which the remote partner can be accessed in the same LAN-Agment. It must be appended to the address with a % character. In Windows systems, this is a numerical value (e.g. 5). On other systems, it may also be a symbolic name (e.g. eth0). The scope ID can be identified using the ipconfig command.
When the SHOW-FT-PARTNERS command is issued, openFT attempts to determine the DNS name and displays this instead of the IPv4-/IPv6 address.TNS name from the z/OS library (TNSTCPIP member), up to 8 characters in length.
port
When a connection is established over TCP/IP, you can specify the port name under which the file transfer application can be accessed in the partner system.
Permitted range of values: 1 through 65535.
Default value:
1100 for openFT partners.
A different default value can also be set in the operating parameters using the following command: MODIFY-FT-OPTIONS4800 for FTAM partners.
21 for FTP partners
11000 for ADM partners
tsel
Transport selector under which the file transfer application is available in the partner system. The transport selector is only relevant for openFT partners and FTAM partners. You can specify the selector in printable or hexadecimal format (0xnnnn...).
The specification will depend on the type of partner:
openFT partner:
Length, 1 through 8 characters; alphanumeric characters and the special characters # @ $ are permitted. A printable selector will be coded in EBCDIC in the protocol and may be padded with spaces internally to the length of eight characters.Default value: $FJAM
FTAM partner:
Length 1 to 10 characters; a printable selector will be coded as variable length ASCII in the protocol. Exception: T-selectors that start with $FTAM (default value) are coded in EBCDIC and padded with spaces to the length of 8 characters.All alphanumeric characters and the special characters @ $ # _ - + = and * can be used with ASCII selectors.
Default value: $FTAM
Note:
As a rule, SNI-FTAM must be specified for Windows partners with openFT-FTAM up to V10. As of openFT-FTAM V11 for Windows, the default value has been changed to $FTAM and can therefore be omitted.
Printable transport selectors are always used in uppercase in openFT even if they are specified or output in lowercase.
ssel
Session selector under which the file transfer application is accessible in the partner system. You can specify the selector in printable or hexadecimal format (0xnnnn...). Length, 1 through 10 characters; alphanumeric characters and the special characters @ $ # _ - + = * are permitted. A printable selector is encoded in ASCII with a variable length in the log.
Default value: empty
Printable session selectors are always used in uppercase in openFT even if they are specified or output in lowercase.
psel
Only relevant for FTAM partners.
Presentation selector under which the file transfer application is available in the partner system. You can specify the selector in printable or hexadecimal format (0xnnnn...). Length, 1 through 10 characters; alphanumeric characters and the special characters @ $ # _ - + = * are permitted. A printable selector is interpreted as ASCII with a variable length in the log.
Default value: empty
Printable presentation selectors are always used in uppercase in openFT even if they are specified or output in lowercase.
Examples
The partner computer with the host name FILESERV is to be addressed over different protocols/connection types:
Connection type/protocol | Address specification |
openFT partner | FILESERV |
FTAM partner (Windows system as of V11.0, | ftam : / /FILESERV |
FTAM partner (Windows system with default | ftam : / /FILESERV:.SNI-FTAM |
Third-party FTAM partner | ftam: / /FILESERV:102.TS0001.SES1.PSFTAM |
FTP partner | ftp : / /FILESERV |
FTADM partner | ftadm://FILESERV |