1 HELP
    FTP is a Foreign Tape Processing utility. FTP can read and
    and write fixed length record tapes.  In addition  FTP can
    make an image copy of a tape to a disk file and from a FTP
    image  disk  file  back to tape  resulting in an identical
    copy of the tape.

1 $
    Usage:   $ dcl_command

    Causes FTP to spawn a subprocess to execute dcl_command.
2 Parameter
    Dcl_command  is any valid DCL command line.  Since logical
    names and  symbols are  passed on  to the  subprocess, any
    command  that  can be entered  at  the  '$'  prompt can be
    entered as Dcl command.
1 EXIT
    Usage:   EXIT

    Causes FTP to exit.
1 IMAGE
    Usage:   IMAGE file_name

    Instructs  FTP  to 1) read the tape and create a disk file
    containing  an exact copy  of the  tape or  2) transfer  a
    FTP tape  image  file on disk  back to tape.  This command
    gives  the  user the  ability  to easily  duplicate  tapes
    reguardless of the tape format.
2 Parameters
    File_name is the name of the file FTP is to use during the
    image copy process. If the /TO_DISK qualifier is used then
    a new  version of  file_name is created and is used as the
    output  file.  If  the  /TO_TAPE  qualifier  is used  then
    file_name is used as the input file.

    Note: FTP uses its own format  for making file_name.  Only
          files  created by FTP  can be  used as  input to the
          IMAGE /TO_TAPE command.
2 Command_Qualifiers
/LOG
    /LOG
    /NOLOG    Default

    Specifies that progress information is to be displayed.
/TO_DISK
    /TO_DISK

    Specifies that  FTP is to  create file_name  and copy  the
    contents  of  the  tape  into that  file.  Do not use this
    qualifier with the /TO_TAPE qualifier.
/TO_TAPE
    /TO_TAPE

    Specifies  that  file_name  is a disk  file that is  to be
    copied to tape. File_name must already exist and must have
    been created by FTP.  Do not use this  qualifier with  the
    /TO_DISK qualifier.
1 FTP
    Usage:   FTP tape_dev

    Starts FTP,  mounts tape_dev  if nessasary,  and assigns a
    channel to tape_dev.
2 Parameters
    Name of the tape drive.  This can be a logical or physical
    device name.
2 Command_Qualifiers
/ASSIST
    /ASSIST
    /NOASSIST	Default

    Specifies  that  operator assistance  should be requested,
    if needed, when mounting the tape.
/DENSITY
    /DENSITY=value

    Specifies the density at which the tape should be read or
    written. Valid density values are:

                           800
                          1600    Default
                          6250

    If /DENSITY is not  specified,  the default  drive density
    is used.
/LABEL
    /LABEL=string    

    Label of the tape. This qualifier is only needed when used
    with the /ASSIST qualifier.
1 PAUSE
    Suspends  execution  of  FTP  and  returns the user to DCL
    command level.  Type CONTINUE to return to FTP. This works
    like ^C. If the user activates another image then FTP will
    exit. SET DEFAULT and SHOW DEFAULT are commands which will
    not cause FTP to exit.
1 READ
    Usage:   READ file_spec

    Reads files from the tape.
2 Parameters
    File_spec is the name  of a valid  Files-11 disk file.  If
    the /INDIRECT qualifier is used then file_spec must exist.
    If not,  then a  new version of  file_spec is  created for
    each file read from the tape.
2 Command_Qualifiers
/ALL
    /ALL

    Causes all  files  on  the tape to be  processed until two
    consecutive end  of file marks are encountered or until an
    end of file is encountered in file_spec when the /INDIRECT
    qualifier  is used.  Do not use this  qualifier  with  the
    /FILE_COUNT qualifier.
/BLOCK_SIZE
    /BLOCK_SIZE=value

    Specifies the size of tape blocks.  If /BLOCK_SIZE  is not
    specified,  the current setting is used.  /BLOCK_SIZE must
    be in range of 14 - 65536.  If  the  physical  block  size
    differs from the specified block size, FTP will adjust the
    block size to fit the physical block size.
/CARRIAGE_CONTROL
    /CARRIAGE_CONTROL=type

    Specifies the type of carriage control attributes of the
    output file. Valid carriage control types are:

    'FORTRAN'    Standard FORTRAN interpretation of the first
                 character.
    'LIST'       Single spacing between records. Default

    'NONE'       No implied carriage control.
/FILE_COUNT
    /FILE_COUNT=value

    Specifies  the number of  files to be  read from the tape.
    Processing  is  terminated early if two consecutive end of
    file   marks  are   encountered  or  an  end  of  file  is
    encountered from file_spec when the /INDIRECT qualifier is
    used.
/FIXED
    /FIXED
    /NOFIXED    Default

    Specifies to  create the output  file  with  fixed  length
    record attributes. This implies that no record trimming is
    to be performed.  The  default, /NOFIXED, is to create the
    file with variable length records.
/INDIRECT
    /INDIRECT

    Specifies  that the  file_spec  parameter is a  file which
    contains names to be used for each input file processed.
/LOG
    /LOG
    /NOLOG	Default

    Specifies that progress information is to be displayed.
/PADDING_CHARACTER
    /PADDING_CHARACTER=(keyword:value,keyword:value)

    Specifies the ASCII characters that  are being used to pad
    records and blocks. Keywords are:

    		  BLOCK
    		  RECORD

    If  both  keywords  are  specified  then  enclose  them in
    parenthisis.

    Example:

        FTP> READ FO.BAR/PADDING_CHARACTER=(BLOCK:0,RECORD:32)

        This example sets the block padding character to  NULL
        (ASCII 0)  and  the record  padding character to SPACE
        (ASCII 32).
/RECORD_SIZE
    /RECORD_SIZE=value

    Specifies  the  size  of records to read from tape.  Value
    must  be  an  even  multiple  of the  tape block size.  If
    /RECORD_SIZE  is  not  specified,  the current record size
    setting is used.

/TRANSLATION
    /TRANSLATION=keyword

    Specifies  the type of translation to be  performed on the
    input records.  See SET TRANSLATION for valid keywords. If
    /TRANSLATION is not specified then the current translation
    setting is used.
/TRIM
    /TRIM[=(option[,...])]    Default = /TRIM=(RECORD,BLOCK)
    /NOTRIM

    Specifies whether or not record  and block trimming should
    occur.  By default,  records and blocks are trimmed of the
    ASCII  characters  specified   by  the  /PADDING_CHARACTER
    qualifier. The BLOCK and RECORD keywords allow the user to
    selectively turn off block and/or record trimming. Valid
    keywords for the /TRIM qualifier are:

        [NO]BLOCK    Specifies  whether  trimming of blocks is
                     to occur.
        [NO]RECORD   Specifies whether trimming  of records is
                     to occur.
        NONE         Specifies that no trimming is to occur.

    Note that /NOTRIM is equivalent to /TRIM=NONE and /TRIM is
    equivalent to /TRIM=(RECORD,BLOCK).
1 REWIND
    Usage:   REWIND

    Rewinds the tape.  Tape is positioned at the  beginning of
    tape (BOT) mark.
1 SET
    Usage:   SET keyword

    Allows the user to set  various parameters in FTP.  All of
    these  parameters  may also be  set via the READ and WRITE
    verb qualifiers.

2 BLOCK_SIZE
    Usage: SET BLOCK_SIZE=value

    Specifies  the size of  tape blocks.  Value must be in the
    range of 14 - 65536.
2 CARRIAGE_CONTROL
    Usage: SET CARRIAGE_CONTROL=type

    Specifies  the type of  carriage control attributes of the
    output file during a  READ  operation.  The Valid carriage
    control types are:

    'FORTRAN'    Standard  FORTRAN interpretation of the first
                 character.
    'LIST'       Single spacing between records. Default

    'NONE'       No implied carriage control.
2 PADDING_CHARACTER
    Usage:   SET PADDING_CHARACTER=(keyword:value,keyword:value)

    Specifies  the ASCII characters that are to be used to pad
    records and blocks. Valid keywords are:

                     BLOCK
                     RECORD

    If  both  keywords  are  specified  then  enclose  them in
    parenthisis.

    Example:

        FTP> SET PADDING_CHARACTER=(BLOCK:0,RECORD:32)

        This example sets the block padding character to  NULL
        (ASCII 0)  and  the record  padding character to SPACE
        (ASCII 32).
2 RECORD_SIZE
    Usage:   SET RECORD_SIZE=value

    Specifies  the size of records to  be read from or written
    to tape.  Value must be an even multiple of the tape block
    size.  This command will not report an error if the record
    size is not an even  multiple  of  the block size,  but an
    error will occur when the READ or WRITE verbs are used.

2 TRANSLATION
    Usage:   SET TRANSLATION=keyword

    Specifies  the type of translation to be  performed on the
    input records.  When reading a tape,  translation  is done
    before the trimming of records and block.  When writeing a
    tape,  translation is  done after  padding the records and
    blocks.
3 ASCII_TO_EBCDIC
    Usage:   SET TRANSLATION=ASCII_TO_EBCDIC

    Specifies  that the  input is in the ASCII character  code
    and should be translated into EBCDIC character code before
    it is output. The translation table used is LIB$AB_ASC_EBC
    and can be found in the  VAX/VMS Run-Time Library Routines
    Manual, Part II, under the LIB$MOVTC routine.
3 EBCDIC_TO_ASCII
    Usage:   SET TRANSLATION=EBCDIC_TO_ASCII

    Specifies  that the  input is in the EBCDIC character code
    and should be translated  into ASCII character code before
    it is output. The translation table used is LIB$AB_EBC_ASC
    and can be found in the  VAX/VMS Run-Time Library Routines
    Manual, Part II, under the LIB$MOVTC routine.
3 NONE
    Usage:   SET TRANSLATION=NONE    Default

    Specifies  that no  translation  is to be performed on the
    input records.
3 OTHER
    Usage:   SET TRANSLATION=OTHER:file-name

    Specifies that  the input  is to be  translated using  the
    translation table stored in file-name.  The  format of the
    table is the same as  the tables  specified in the VAX/VMS
    Run-Time  Library  Routines  Manual,  Part II,  under  the
    LIB$MOVTC routine.
4 Example
    This is an example of an ASCII to EBCDIC translation table.

           00 10 5C 5C 20 26 2D 5C 5C 5C 5C 5C 7B 7D 5C 30 ! Line 1
           01 11 5C 5C 5C 5C 2F 5C 61 6A 7E 5C 41 4A 5C 31 ! Line 2
           02 12 5C 16 5C 5C 5C 5C 62 6B 73 5C 42 4B 53 32 !   .
           03 13 5C 5C 5C 5C 5C 5C 63 6C 74 5C 43 4C 54 33 !   .
           5C 5C 5C 5C 5C 5C 5C 5C 64 6D 75 5C 44 4D 55 34 !   .
           09 5C 0A 5C 5C 5C 5C 5C 65 6E 76 5C 45 4E 56 35
           5C 08 17 5C 5C 5C 5C 5C 66 6F 77 5C 46 4F 57 36
           7F 5C 1B 04 5C 5C 5C 5C 67 70 78 5C 47 50 58 37
           5C 18 5C 5C 5C 5C 5C 5C 68 71 79 5C 48 51 59 38
           5C 19 5C 5C 5C 5C 5C 60 69 72 7A 5C 49 52 5A 39
           5C 5C 5C 5C 5B 5D 7C 3A 5C 5C 5C 5C 5C 5C 5C 5C
           0B 5C 5C 5C 2E 24 2C 23 5C 5C 5C 5C 5C 5C 5C 5C !   .
           0C 1C 5C 14 3C 2A 25 40 5C 5C 5C 5C 5C 5C 5C 5C !   .
           0D 1D 05 15 28 29 5F 27 5C 5C 5C 5C 5C 5C 5C 5C !   .
           0E 1E 06 5C 2B 3B 3E 3D 5C 5C 5C 5C 5C 5C 5C 5C ! Line 15
           0F 1F 07 1A 21 5E 3F 22 5C 5C 5C 5C 5C 5C 5C FF ! Line 16
          0        1        2        3        4        5
          1        0        0        0        0        0  
          |--------|--------|--------|--------|--------|--
	               File Column Number

    The format  of the translation file must be in this format
    inorder for  translation to  occur correctly.  The  FORMAT
    used to  read  this  file  is  (16Z3)  and  only the first
    sixteen line are read.
1 SKIP
    Usage:   SKIP keyword

    Causes the tape  tape to be repositioned  depending on the
    keyword specified.
2 END_OF_TAPE
    Usage:   SKIP END_OF_TAPE

    Cause the tape to be positioned past the end of tape mark.
    The end of tape mark is two consecutive end of file marks.
2 FILE
    Usage:   SKIP FILE

    Causes the tape to skip a specified number of files.
3 Command_Qualifiers
/BACKWARD
    /BACKWARD

    Causes the tape to skip the specified number of files in
    the reverse direction.
/COUNT
    /COUNT=value

    Specifies the number of files to skip in either the foward
    or the reverse direction.  If /COUNT is not specified then
    one file will be skipped.
2 LABEL
    Usage:   SKIP LABEL

    Causes the tape to rewound to the beginning of tape (BOT)
    mark and then advanced past the volume label. This is the
    same as the following commands:

              FTP> REWIND
              FTP> SKIP FILE

    Unless  the  volume label is followed  by two consectutive
    end of file marks then the equivalent commands would be:

              FTP> REWIND
              FTP> SKIP END_OF_VOLUME
1 SPAWN
    Usage:   SPAWN

    Causes  FTP  to  create  a   subprocess  or  attach  to  a
    previously created subprocess.  Control is turned  over to
    the subprocess until the user either logs off or issues an
    'ATTACH' command. At that time control is returned to FTP.
1 STATUS
    Usage:   STATUS

    Displays current settings and tape drive characteristics.
1 VERSION
    Usage:   VERSION

    Displays FTP's current version and revision level.
1 WRITE
    Usage:   WRITE file_spec

	Writes onto the tape.
2 Parameters
    File_spec  is the  name of the file to be written to tape.
    File_spec may  contain  wild-card  characters.  All  files
    matching file_spec  will be written to the tape.  Standard
    VMS wild-carding is used.
2 Command_Qualifiers
/BLOCK_SIZE
    /BLOCK_SIZE=value

    Specifies the  size of tape  blocks to be written to tape.
    If  /BLOCK_SIZE is not specified,  the current  block size 
    setting is used. Value must be in range of 14 - 65536.
/LOG
    /LOG
    /NOLOG	Default

    Specifies that progress information is to be displayed.
/PADDING_CHARACTER
    /PADDING_CHARACTER=(keyword:value,keyword:value)

    Specifies the  ASCII characters to use  for to pad records
    and blocks. Keywords are:

    		  BLOCK
    		  RECORD

    If  both  keywords  are  specified  then  enclose  them in
    parenthisis.

    Example:

        FTP> WRITE F.BAR/PADDING_CHARACTER=(BLOCK:0,RECORD:32)

        This example sets the block  padding character to NULL
        (ASCII 0)  and the record  padding  character to SPACE
        (ASCII 32).
/RECORD_SIZE
    /RECORD_SIZE=value

    Specifies  the size of records to  written to tape.  Value 
    must be an even multiple of block size. If /RECORD_SIZE is
    not specified then current setting is used.
/TRANSLATION
    /TRANSLATION=keyword

    Specifies the  type  of translation to be performed on the
    input records.  See SET TRANSLATION for valid keywords. If
    /TRANSLATION is not specified then the current translation
    setting is used.
