Using the TN3270 client on MUSIC to connect to another system
-------------------------------------------------------------

                                     File:  $tcp:tn3270.txt
                                     Date:  Aug 14, 2004
                                     Last update:  Oct 18, 2006

A MUSIC/SP system with TCP/IP connectivity (running under the
Sim390 mainframe emulator, for example) can be used as a
Telnet 3270 (TN3270) client, to connect to another mainframe
system (VM, TSO, MUSIC, etc.) as an emulated 3270 terminal.
It can be used as an alternative to QWS3270, etc.

On MUSIC, TN3270 is an alias for the TELNET command.

NOTE: To have the required files for the telnet client, you must
restore the files from at least misc2.arc to the base Demo 6.1
system.  If you have the 6.2 (or later) Demo system, no update
is required.

To connect to a remote TN3270 server, sign on to MUSIC and enter
the following command in the MUSIC *Go command area:

      tn3270 host port -m

  or  telnet host port -m

where:  host    is the host name or IP address.
                The special name localhost (equivalent to
                127.0.0.1) can also be used.

        port    is the port number to connect to (default 23).

        -m      (optional) specifies that an automated connection file
                (named A.ipaddr), if one exists, is NOT to be used.
                Connection files are created by Learn mode, which
                is specified by the -l option.

Example:   tn3270 music.mcgill.ca 1234


Special commands, recognized by the TN3270 client program, can
be entered during the remote 3270 session, provided they are entered
at the beginning of the *first* modifiable field of a screen and
the Enter key is used:

     %exit     Terminates the session, and returns to the original
               *Go prompt of the client MUSIC system.
               This breaks the connection to the remote system.

     %help     Invokes "help telnet" on the client MUSIC system.
               When you exit from help by pressing F3, you are
               returned to the remote 3270 session.

     %xxx      where xxx is a MUSIC command, executes the command
               on the client MUSIC system. Use this with care.


To sign off and terminate the remote 3270 session:

(1) Sign off from the remote system. E.g. for a remote MUSIC system,
    use the OFF command.  For CMS or TSO, use the LOGOFF command.

(2) If you get a logo or sign-on screen again from the remote system,
    enter the special command %exit (in the *first* modifiable
    field of the 3270 screen), to terminate the telnet session.
    This returns you to the *Go prompt of the client MUSIC system.


Additional notes:

- The client will try to use the same 3270 screen size as the
  underlying MUSIC session.  Possible screen sizes are 24x80,
  32x80, 43x80, 27x132.

- The tn3270 session uses the same keyboard mapping as the
  underlying MUSIC session.  If the underlying session is a
  local 3270 session (under Sim390), the keys to know about are:

     3270 Function       Actual Key
     -------------       ----------

     Enter, Ins, etc.    (same)
     PA1                 Keypad -
     PA2                 Keypad +
     PA3                 Keypad /
     Clear               Ctrl+Z
     Reset               Esc
     NewLine             Keypad * or Ctrl+Enter
     Erase-EOF           Ctrl+End
     Erase-Input         Ctrl+Home
     Sys-Request         Ctrl+K
     PF1 to PF12         F1 to F12
     PF13 to PF24        Shift+F1 to Shift+F12
     PF7                 PageUp
     PF8                 PageDown

     Cut-and-paste keys (use the mouse to mark a block of text):

     Ctrl+C     Copy selected text to Windows Clipboard
     Ctrl+V     Paste from Clipboard to screen (modifiable field)
     Ctrl+X     Cut ( = copy & erase)
     Ctrl+E     Erase selected text (without copy to Clipboard)

     To unselect a block of text:  Mouse click anywhere