HP-UX SNAplus2 R7 APPC Application Suite User's Guide

AFTP
AFTP Configuration
2 AFTP
APPC File Transfer Protocol (
AFTP) provides file manipulation and transfer services to application programs and
end users. With
AFTP, you can copy ASCII and binary files between your computer and any computer running the
AFTPD
provider program.
The
AFTP
application provides a common naming convention for files, a common directory structure, and a common
set of file attributes. This common format enables you to locate and transfer files without knowing how the files are
actually named and stored on the target computer. If the format of your files is supported by the operating system
on each platform, you can share and store files among different platforms that support
AFTP.
If either the source or the destination is an EBCDIC computer, the EBCDIC computer performs ASCII-to-EBCDIC
translation when it receives a file from the ASCII computer, and EBCDIC-to-ASCII translation when it sends a file
in the opposite direction.
In addition to transfer commands, the
AFTP application has subcommands that help you locate the files with which
you want to work. These subcommands enable you to:
• Set and query the current directory setting at the source computer and at the target computer
• List files in a selected directory at the source computer and at the target computer
• Set file transfer options
2.1 AFTP Configuration
You must configure the following files before using the
AFTP application:
• aftp.ini (stored in the /opt/sna/samples subdirectory)
• asuite.tps (stored in the /etc/opt/sna subdirectory)
The aftp.ini initialization file is included with the AFTP
and ACOPY applications. This file specifies masks for
specific source and target files to ensure correct file renaming and proper transfer mode. On HP-UX systems, place
this file in your home directory and rename it to .aftp.
The aftp.ini file maps a source mask for a particular type [for example, source_mask (*.ANNOUNCE)] to a target
mask [for example, target_mask (*.ANN)]. In this example, a file on the source machine called test.ANNOUNCE
is renamed to test.ANN on the target machine. This mapping ensures that correct file renaming is performed
during the file transfer. The file type determines whether files are transferred in binary mode or the default ASCII
mode. See Section 2.1.1,
Sample aftp.ini Initialization File, for a sample aftp.ini initialization file.
On Windows clients, the aftp.ini file is also used by the
AFTP
provider program to restrict access to files based
on the conversation security user ID. See the sample aftp.ini file below for information about how to do this.
For information about asuite.tps, see Section 1.2.2, Configuring Your System.
2.1.1 Sample aftp.ini Initialization File
A sample aftp.ini file is shown in the following figure:
Figure 2–1 Sample aftp.ini File
/*
This file must be copied to the user’s $HOME directory and
renamed to ".aftp"
*/
15