      Sample Data Transfer Program Customization Notes

This diskette contains the Sample Data Transfer programs for
use  on CMS. The host CMS system must be using VM/SP release
1.0  (or later) in order for the File Transfer Program to be
usable.

         Sample File Transfer Program CMS Data Sets

The UPLOAD procedure creates several files on CMS. These
files comprise the Sample File Transfer Program.


   Data Set Name   Contents       Description
   -------------   --------       -----------
   PCXFER EXEC     File Transfer  This EXEC will either invoke
                   Invocation     PCXFER MODULE directly, or use
                   EXEC           ISPF to allow invocation of
                                  PCXFER MODULE from a menu.

   PCXFER MODULE   File Transfer  Transfers files between the host
                   program        and the PC.

   PROFILE PCXFER  File Transfer  This file contains the default
                   profiles       characteristics for files
                                  transferred between the Personal
                                  Computer and CMS.

   PCXFER MACLIB   File Transfer  This file is only used if you
                   panels         have the Interactive System
                                  Productivity Facility (ISPF) program
                                  product (program number 5668-960)
                                  installed on your CMS system.
                                  Members PCXFER and PCXHLP are ISPF
                                  panels.

   PCXFER HELPCMS  File transfer  This file may be used with the
                   help           CMS HELP command to provide on-line
                                  information about the File Transfer
                                  Program.


                 Using the Sample File Transfer Program

The File Transfer Program may be used to transfer the contents of a
file from a Personal Computer diskette into a CMS file or to
transfer the contents of a CMS file to a diskette file on the
Personal Computer or to the Personal Computer printer.

To transfer a file, do the following:

  1. Switch to Personal Computer mode.
  2. Insert a diskette containing the HOST.EXE file into the Personal
     Computer. (This file contains the portion of the Sample File
     Transfer application program which runs on the Personal Computer.)
  3. Issue the following Personal Computer command:

         HOST

     The HOST command automatically switches to Host Computer mode when
     it is executing.
  4. If you are not already logged onto VM/CMS, logon to VM and IPL
     CMS.
  5. Invoke the PCXFER exec (see below).
  6. You may transfer one or more files by staying in Host Computer
     mode and issuing multiple PCXFER commands.
  7. When you have completed using the File Transfer Program, switch
     back to Personal Computer mode and press the ATTN key. This will
     terminate the Sample File Transfer Program on the Personal
     Computer.

               Invoking the Sample File Transfer Program

To invoke the CMS File Transfer Program and be prompted for all required
information from an ISPF panel (if the ISPF Program Product is installed
on your CMS system), issue the following command:

    PCXFER

When using the ISPF panel to specify the file transfer information, you
may request multiple file transfer requests by filling in the panel
each time it is displayed (i.e. after each file has been transferred).
After all files have been transferred, you may return to the CMS
command environment or ISPF by pressing the PF3 key to exit from the
PCXFER panel.

To invoke the CMS File Transfer Program and directly specify all
required information, issue the following command:

    PCXFER  CMS-fileid
            TO | FROM
            PC-filespec
            < (
            < NEWfile | REPlace >
            < EDIT | BAS | VAR | LIST | LIST2 | UNFM >
            < TRAN < (fn <ft <fm> > ) > | NOTRAN >
            < UNNum >
            < LRecl nnnnn >
            < RECfm F/V > >
            < Compress | UNCompress >

The complete syntax for the PCXFER command and the explanation of all
keywords is documented in the CMS file PCXFER HELPCMS.

                   Using the PCXFER Optional Keywords

The PCXFER command can be invoked without any options most of the
time. However, the optional keywords can be used to tailor the file
transfer to fit your special needs.

The REP keyword must be specified if the target file already exists
and you want to replace it.

One of the file format keywords (EDIT, BAS, VAR, LIST, or UNFM) may be
specified to override the file format which was found in the entry in
the PROFILE PCXFER file which corresponds to the file type of
the CMS file. For example, a file named TEST SCRIPT would be
transferred as an EDIT format file, because the SCRIPT entry in
the PROFILE PCXFER file indicates EDIT format.

The choice of the file format to be used depends on how you intend to
use the file on CMS or the PC. The following guidelines may be used to
choose an appropriate file format:

    File Format   PC File Source   Use
    -----------   --------------   ---
    EDIT          Edlin, Visicalc, Any file which you want to be able to
                  Easywriter       edit, display, or list on both the
                                   Personal Computer and on CMS. This
                                   includes program source files (e.g.
                                   assembler, pascal, PL/I source
                                   programs) and editable files,
                                   including DIF format files used by
                                   the Personal Computer Visicalc
                                   program.

    BAS           Basic editor     Any file which is created by the
                                   BASIC or BASICA interpreter on the
                                   Personal Computer. If you save the
                                   file with the ASCII option, the file
                                   will actually be transferred in EDIT
                                   format, and may be edited on CMS.
                                   If you save the file with no option
                                   or with the Protected option, the
                                   file will be transferred in UNFM
                                   format, and may not be usable on
                                   CMS.

    VAR           A CMS file       Any non-editable CMS file which
                  transferred as   contains variable length records
                  a VAR format     should be transferred to the PC
                  file             in VAR format. This will preserve
                                   the record format, so the file can be
                                   transferred back to CMS and
                                   recreated exactly. This category
                                   includes CMS load modules.

    LIST          Listing output   Any file which contains printer
                  of Assembler,    control characters should be
                  Pascal Compiler, transferred as LIST format. This
                  Basic Compiler,  includes the output of the Personal
                  Cobol Compiler,  Computer Assembler, Pascal Compiler,
                  Fortran Compiler Basic Compiler, Fortran Compiler, and
                                   Cobol Compiler. The file transfer
                                   program will convert the ASCII
                                   printer control characters into
                                   System/370 printer machine control
                                   characters. If you transfer a
                                   CMS listing file, the printer
                                   control bytes will be replaced
                                   with ASCII printer control
                                   characters.

    LIST2         Listing output   LIST2 is used with files that are
                  of Assembler,    printed on the 3800 printer. Host
                  Pascal Compiler, files that are used with LIST2
                  Basic Compiler,  format contain font control
                  Cobol Compiler,  characters. PC files that are used
                  Fortran Compiler with LIST2 format are the same as
                                   those used with LIST format.
                                       If a file is transferred
                                   from the Personal Computer, the file
                                   transfer program will convert the
                                   ASCII printer control characters
                                   into System/370 printer machine
                                   control characters. It will also
                                   add the base font character X'F0'
                                   to the 2nd byte of each printable
                                   record. If you transfer a CMS
                                   listing file to the Personal
                                   computer, the file transfer program
                                   will convert the printer control
                                   bytes to ASCII printer control
                                   characters and delete the font
                                   control characters.

    UNFM          Visicalc,        Any file which does not fit into
                  Basic program,   any of the above categories should be
                  Pascal program   transferred as an UNFM format file.
                                   This includes the standard output of
                                   the Personal Computer Visicalc
                                   program (e.g. TEST.VC).

One of the code translation keywords (TRAN or NOTRAN) may be specified
to override the code translation option which was found in the entry in
the PROFILE PCXFER file which corresponds to the file type in
the CMS file name. For example, a file named TEST SCRIPT would
be transferred with ASCII to EBCDIC (or EBCDIC to ASCII) code
translation. If the file being transferred contains only printable
characters (e.g. a CMS EXEC, ISPF panel or message file, etc.)  and
you want to be able to display or process the file on the Personal
Computer, you should specify the TRAN option.  You can specify
(fn ft fm) to identify a CMS file that contains updates to the
translate table used during file transfer. If the file contains
non-printable characters (e.g. a CMS object deck or load module, a
Personal Computer object file or executable file), you should specify
the NOTRAN option.

The UNNUM keyword specifies that sequence numbers are to be removed from
a CMS file when it is being transferred to a Personal Computer file.
If UNNUM is not specified, then sequence numbers are not removed. When
the CMS file has a RECFM of fixed, the sequence numbers are removed
from the last 8 characters of each record. When the RECFM is variable,
the sequence numbers are removed from the first 8 characters of each
record. UNNUM does not apply to files transferred from the Personal
Computer to a CMS file.

The LRECL and RECFM keywords specify the logical record length and
record format of the CMS file. These options are ignored if a CMS
file is being transferred to a Personal Computer file. If LRECL or
RECFM are not specified when transferring a Personal Computer file
to a CMS file, the logical record length and record format are
taken from the PROFILE PCXFER file.

COMPRESS and UNCOMPRESS are used to control the way in which the file
contents are sent to and from the PC. If Compress is specified, the
data is compressed as it is sent. If UNCompress is specified, the data
is not compressed as it is sent. The PCXFER program will use a default
value for Compress or UNCompress that will transfer most files as
quickly as possible. You may want to override the defaults, however,
to improve 3274 performance. The 3274 will perform better if Compress
is used.

Compress and UNCompress can be used in the PROFILE PCXFER file. They
should be added after the PC file format of each profile entry.
