Columbia Kermit/kermit.zip/old/misc/prime/primek.doc

Text File | 2020-01-01 | 12KB | 335 lines

PRIME KERMIT Documentatino

Contents                                                     i


 CONTENTS

Transferring files between the Prime and your PC  . . . . .  1

 1     Running Kermit on the Prime . . . . . . . . . . . . .  1
       2     File Naming Conventions . . . . . . . . . . . .  3
       3     Default Kermit-R19 SET Parameters . . . . . . .  3
 4     Kermit Commands Available for the Prime . . . . . . .  3
       5     SERVER Command  . . . . . . . . . . . . . . . .  3
       6     INIT Command  . . . . . . . . . . . . . . . . .  4
       7     PORTFILE Routine  . . . . . . . . . . . . . . .  4
       8     Sample Session  . . . . . . . . . . . . . . . .  5
ii


 TRANSFERRING FILES BETWEEN THE PRIME AND YOUR PC



 Normally, when you use your PC, you are "talking" directly to
 it; your commands are interpreted directly by the operating
 system or by some program, such as an editor, a text
 formatter, or SPSS/PC.  Kermit is a means for connecting two
 computers through their terminal (TTY) ports, tricking one
 computer (or both) into acting as though the other is a
 terminal.  Once two computers are connected in this way,
 cooperating programs can be run on each computer to achieve
 the desired communications by means of a communication
 protocol.

    Kermit embodies a set of rules for transferring files
 reliably between computers.  In general, one computer is a
 large system (the mainframe Prime acts as a host, and contains
 many terminals) and the other is a personal computer (PC).
 The host believes that the PC is an ordinary terminal.  In
 order for the Kermit protocol to occur, a Kermit program must
 be running on each end of the communication line--one on the
 Prime as host, one on the PC.

    This documentation supplements the documentation in
 SPSS/PC.  You should read that documentation first.

    Tranfer of SPSS portable system files requires the use of
 the PORTFILE command described below.

1  Running Kermit on the Prime

The Prime version of Kermit was developed under Prime REV19
 and issues the prompt KERMIT-R19>.  It has run successfully
 under REV18, also.  Kermit-R19 does not accept any
 abbreviations for commands; you must type command names in
 full.  It does not give guide words or respond to ? with
 information on what may be done next.  Kermit-R19 does not
 accept tree names.  It searches for and places files in the
 currently attached directory.  If you want to send or receive
 files from another directory, exit from Kermit, attach to the
 desired UFD, and restart Kermit-R19.

    Kermit lets you use your PC as a remote Prime terminal,
 where you issue PRIMOS commands; as a "dumb" terminal which
 accepts Kermit-R19 and Kermit-PC commands; and as a regular
 PC.  You can always verify which operating system or Kermit
 you are at by typing a carriage return and examining the
 prompt.  The PRIMOS prompt does not appear when you transfer
 from the PC to PRIMOS.
2


  1  First you start Kermit on the PC by typing

            KERMIT

    Once you have activated PC Kermit, use the STATUS command
     to make sure that parity is set to "MARK," the back-arrow
     is set to "backspace," and that the baud rate is correct
     for the modem.  If these parameters have to be changed,
     use the Kermit-PC SET command.

 2  Dial the number required to activate a port on the
     mainframe Prime.  Connect the link by typing "C" (for
     CONNECT) on the PC.  Now the PC is functioning like a
     remote terminal.

 3  Login normally to the Prime.  You may have to hit the
     carriage return a couple of times to get "LOGIN PLEASE"
     message.

 4  Check to make sure your kill character is a non-printing
     character.  (On the Prime, the kill character indicates a
     line delete.)  You must change the default kill character
     from a question mark (?)  to some non-printing character
     (such as CTRL-X), so that Kermit does not interpret it as
     a signal to erase the line.

 5  Attach to the directory in which you want to send or
     receive files.  If you are sending SPSS portable files,
     they must be processed with PORTFILE prior to sending them
     to the PC.

 6  Start-up Prime Kermit.  At some sites this is done with
     the command

           KERMIT

    Check with your local systems staff to see how this is
     done at your site.

 7  Set up the Prime Kermit environment and perform file
     transfers using the commands listed in the PC Kermit
     Documentation or use the SERVER command described below.

 8  If you have sent SPSS portable files from the PC to the
     Prime, be sure to run them through PORTFILE prior to
     reading them with the SPSS-X IMPORT command.  PORTFILE is
     run on Prime Kermit.

 9  Exit from Prime Kermit.

10  LOGOUT from Prime.

11  Exit from PC Kermit
Contents                                                     3

 2  File Naming Conventions

Kermit makes every attempt to retain the names of transferred
 files.  The file naming conventions on the PC allow filenames
 of eight characters followed by a three character extension.
 PRIMOS uses filenames of up to 32 characters, including
 suffixes.  When you send files "down" to the PC or "up" to the
 Prime, some file names or extensions may be truncated if the
 names are too long or changed by Kermit to prevent filename
 conflicts and conform to naming conventions.  Check your
 directory or UFD to see if any names have changed.

3  Default Kermit-R19 SET Parameters

The default SET parameters for Kermit-R19 (shown with the SHOW
 ALL command) are

            Delay (seconds) before sending 1st packet........     5
             File Type to send/receive........................ASCII
             Number pad chars to send.........................     0
             Pad character to send............................200 (octal)
             Quote character to receive.......................'#'
             8-bit Quoting character desired (good
             only if the file type is BINARY).................'N'

These parameters can be changed using the SET command,
 described in the SPSS/PC Kermit documentation.  You do not
 have to make any changes to transfer portable files.  Portable
 files must be sent as ASCII files.

    The Kermit-PC STATUS command lists other available
 options, including the baud rate and parity settings.

4  Kermit Commands Available for the Prime

Kermit on the Prime always issues the prompt, KERMIT-R19>.  In
 response to this prompt, you can issue commands which give
 help, show current parameter settings, and transfer files.
 These commands are described in the SPSS/PC Kermit
 Documentation.

    The Prime implementation of Kermit supports the use of the
 SERVER command and allows you to set parameters from an
 external file with the INIT command.

5  SERVER Command

The SERVER command saves you from moving back and forth
 between Kermit-PC and Kermit-R19.  Once you have established
 the connection between your PC and the Prime, you type SERVER
 at Kermit-R19, reconnect to Kermit-PC and then issue commands
 that transfer files.
4

  1  Follow steps 1 through 7 above.

 2  Issue the SERVER command by typing SERVER.

 3  Reconnect to Kermit-PC by typing CTRL-] c

 4  Issue commands recognized by the server described below.

The available commands for the SERVER are

SEND     transfers files from the current PC directory to the
          currently attached Prime directory.  SEND takes a
          filename as the argument or you can send groups of
          files using the PC wildcard conventions.

RECEIVE  transfers files from the currently attached Prime
          directory to the current PC directory.  RECEIVE takes
          a filename as the argument or you can receive groups
          of files using Prime wildcard conventions.

FINISH   exits from Kermit-R19 and returns control to PRIMOS.
          You should re-connect to the Prime and perform
          additional operations or LOGOUT.

BYE      (alias LOGOUT) exits from Kermit-R19 and LOGOUT from
          Prime.

6  INIT Command

The INIT command uses a file containing SET parameters to
 establish the Kermit environment.  You build this file on the
 Prime using an editor.  The file serves a command input (COMI)
 file.  The INIT command is used at the Kermit-R19 level and
 executes the SET commands contained in the file.  The INIT
 command takes the following form

            INIT filename

The file contains commands that are available for Kermit-R19.
 After establishing the Kermit-R19 environment with SET
 commands, you can issue PORTFILE (with the appropriate
 responses), SHOW, or HELP commands.  If you issue the SERVER,
 SEND or RECEIVE command, it must be the last command in the
 INIT file.  The first SERVER, SEND, or RECEIVE command
 encountered is executed and expects a response from Kermit-PC.

7  PORTFILE Routine

The PORTFILE routine run within Kermit-R19 is used to
 translate characters contained in SPSS portable files
 transferred by Kermit between your PC and the Prime.  The
 current portable file configuration forces Kermit to replace
 some characters which are not interpreted by IMPORT and
Contents                                                     5

 EXPORT.  The PORTFILE routine takes care of any problematic
 characters.  PORTFILE is run on the Prime prior to sending a
 portable file to the PC or after receiving a portable file
 from the PC.  You must not run data or command files through
 the PORTFILE routine.

    PORTFILE is an interactive routine which prompts you for
 the type of file, the name of the input file, and a name for
 the translated file.  PORTFILE queries you until it has all
 the information it needs to perform the translation.  If one
 of the file names already exists, PORTFILE asks if you want to
 overwrite the file.  You cannot use the same name for the
 input file and the converted version.  A run to translate a
 portable file received from the PC looks like

            Are you converting a file to send to a PC?  NO
             Are you converting a file received from a PC? YES
             Name of file to convert: almanac.ker
             Name for converted file: almanac.kermxfil
             File already exists. Do you wish to overwrite? NO
             Name for converted file: almanac.kxfil

The file is then converted and both files appear in the
 current Prime directory.

8  Sample Session

In this sample session, a portable file is being sent from the
 PC to the Prime using the SERVER command and then translating
 the file using the PORTFILE command.  Assume that steps one
 through six have been followed and that the Kermit-R19
 environment has been established.

    At Kermit-R19 level, type

            SERVER

To return to Kermit-PC, type

            CTRL-] C

Now you issue one of the commands available with the server to
 send or receive files.  To send the portable file, type

            SEND ALMANAC.KER

You do not have to receive the file.  The SERVER operates at
 the Kermit-R19 level and receives the file.  You can send
 groups of files using PC-DOS wildcard conventions.  To exit
 from the SERVER, type

            FINISH
6

 The FINISH command exits from Kermit-R19.  To reconnect to
 PRIMOS, type

            C

Now your PC is acting as a terminal connected to the Prime.
 Since a portable file has been sent, the Kermit-R19 PORTFILE
 routine must be executed.  To enter Kermit-R19, type

            KERMIT

To get to the translation routine, type

            PORTFILE

The PORTFILE routine asks questions about the type of
 conversion, the name of the input file, and the name of the
 output file.  You must answer each question.

            Are you converting a file to send to a PC?  n
             Are you converting a file received from a PC? y
             Name of file to convert: almanac.ker
             Name for converted file: almanac.kxfil

When you use SPSS-X IMPORT commmand, the converted file,
 almanac.kxfil, is used.

To leave Kermit-R19, type

            EXIT

You can continue to use your PC as a remote terminal to the
 Prime or logout by typing

            LOGOUT

To return to Kermit-PC, type

            CTRL-] C

To exit from Kermit-PC and return control to DOS, type

            EXIT