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 target 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. 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 Sample aftp.ini Initialization File, for a sample aftp.ini initialization file.

For information about asuite.tps, see Configuring Target Programs (Applications).

2.1.1 Sample aftp.ini Initialization File

A sample aftp.ini file is shown in the following figure:

Sample aftp.ini File

/*
   This file must be copied to the user's $HOME directory and
   renamed to ".aftp"
*/
map source_mask(*.NONE)     target_mask(*.)       options();
map source_mask(*.LABEL)    target_mask(*.LBL)    options();
map source_mask(*.NONEBIN)  target_mask(*.)       options(binary);
map source_mask(*.ASSEMBLE) target_mask(*.A37)    options();
map source_mask(*.LISTPS)   target_mask(*.PS)     options(binary);
map source_mask(*.APLTF   ) target_mask(*.ATF)    options(binary);
map source_mask(*.EXEC    ) target_mask(*.EXC)    options();
map source_mask(*.PACKAGE ) target_mask(*.PKG)    options();
map source_mask(*.SCRIPT  ) target_mask(*.SCR)    options();
map source_mask(*.NEWS )    target_mask(*.NEW)    options();
map source_mask(*.DOCUMENT) target_mask(*.DOC)    options();
map source_mask(*.BOOK    ) target_mask(*.BOO)    options(binary);
map source_mask(*.ARC     ) target_mask(*.*  )    options(binary);
map source_mask(*.*BIN    ) target_mask(*.*[BIN]) options(binary);
map source_mask(*.BAS     ) target_mask(*.*  )    options(binary);
map source_mask(*.CFG     ) target_mask(*.*  )    options(binary);
map source_mask(*.COM     ) target_mask(*.*  )    options(binary);
map source_mask(*.EXE     ) target_mask(*.*  )    options(binary);
map source_mask(*.FLS     ) target_mask(*.*  )    options(binary);
map source_mask(*.LIB     ) target_mask(*.*  )    options(binary);
map source_mask(*.OBJ     ) target_mask(*.*  )    options(binary);
map source_mask(*.PIC     ) target_mask(*.*  )    options(binary);
map source_mask(*.RAM     ) target_mask(*.*  )    options(binary);
map source_mask(*.SYS     ) target_mask(*.*  )    options();
map source_mask(*.WKS     ) target_mask(*.*  )    options(binary);
map source_mask(*.WK1     ) target_mask(*.*  )    options(binary);
map source_mask(*.WK3     ) target_mask(*.*  )    options(binary);
map source_mask(*.ZIP     ) target_mask(*.*  )    options(binary);
map source_mask(*.AVAIL   ) target_mask(*.AVL)    options();
map source_mask(*.PLAS    ) target_mask(*.PLS)    options();
map source_mask(*.BMP     ) target_mask(*.*  )    options(binary);
map source_mask(*.DLG     ) target_mask(*.*  )    options(binary);
map source_mask(*.DLL     ) target_mask(*.*  )    options(binary);
map source_mask(*.ICO     ) target_mask(*.*  )    options(binary);
map source_mask(*.FNT     ) target_mask(*.*  )    options(binary);
map source_mask(*.PTR     ) target_mask(*.*  )    options(binary);
map source_mask(*.RES     ) target_mask(*.*  )    options(binary);
map source_mask(*.ANNOUNCE) target_mask(*.ANN)    options();
map source_mask(*.DOC     ) target_mask(*.DOC)    options();
map source_mask(*.CATALOG ) target_mask(*.CAT)    options();
map source_mask(*.IMG     ) target_mask(*.*  )    options(binary);
map source_mask(*.KPS     ) target_mask(*.*  )    options(binary);
map source_mask(*.KPL     ) target_mask(*.*  )    options(binary);
map source_mask(*.PAL     ) target_mask(*.*  )    options(binary);
map source_mask(*.PLX     ) target_mask(*.*  )    options();
map source_mask(*.R1P     ) target_mask(*.*  )    options(binary);
map source_mask(*.WRK     ) target_mask(*.*  )    options(binary);