FileKit & 3270 Terminal Emulation Software


 
 

Most users today rarely connect to IBM Mainframe systems using actual hardware 3270 terminals but do so using emulated 3270 terminals running on a PC workstation. Many of these 3270 terminal emulation products contain features and functionality that exceed that of a standard hardware 3270 terminal and keyboard. This allows tailoring of the look and feel of the individual's IBM Mainframe environment.

FileKit provides the user with a windowing environment within a 3270 session (i.e. supports multiple window display, window repositioning, resizing, maximising, etc.) As such, CBL has identified certain features offered by 3270 emulator packages that facilitate use of the FileKit environment.

The following table identifies commercially available 3270 emulation software products that have been tested at CBL and their ability to support those features pertinent to usage of FileKit. It does not, however, reflect the vast range of other facilities available in each product.

3270
Emulator
Large
Screen
Sizes
Keyboard
Map
Keyboard
Macros
Macros Mouse
Map
Mouse
Enter
Mouse
Wheel
Microfocus Reflection Yes Yes Yes Yes Yes Yes No
Rocket Terminal Emulator
(Formerly BlueZone)
Yes Yes Yes Yes Yes Yes No
OpenText HostExplorer Yes Yes Yes Yes Yes Yes Yes
IBM Personal Communications Yes Yes Yes Yes Yes Yes No
Microfocus Rumba Yes            
Nexus Terminal Yes Yes No Yes Yes Yes No
SDI TN3270 Plus Yes Yes Yes Yes Yes Yes  
Tom Brennan Vista tn3270 Yes Yes Yes Yes Yes Yes Yes

Large Screen Sizes

TN3270 terminals, served by the host TELNET server, may reference VTAM LOGMODEs that support non-standard screen sizes (i.e. indicate that a read partition query is to be issued by a host application to determine the capabilities of the device.) Standard screen size LOGMODEs are often referred to as Model 2/3/4/5 terminals and correspond to actual hardware 3270 terminals. Comprehensive 3270 emulator support of IBM-DYNAMIC TN3270 terminals will allow the user to specify the desired 3270 screen size (rows x columns) e.g. 40 x 132, 62 x 160 (maximum supported by ISPF), 86 x 190, etc.

Starting FileKit in a 3270 terminal of larger than standard dimensions allows the user to view more windows concurrently and to display more information within each window. Note that, when using terminals with large dimensions, it may be necessary to reduce the font size and/or increase the resolution of the display in order to view the entire emulated terminal within the physical display.

To take advantage of this facility, VTAM LOGMODEs that support non-standard screen sizes should be made available via the host TN3270 server. D4C32XX3 is an IBM supplied LOGMODE that matches this criteria and should already exist in your VTAMLIB. If not, update the VTAM source member ISTINCLM with a new, dynamic LOGMODE then re-assemble and Link Edit it. e.g.


    MODEENT LOGMODE=DYNAMICB,                  X
          FMPROF=X'02',                        X
          TSPROF=X'02',                        X
          PRIPROT=X'71',                       X
          SECPROT=X'40',                       X
          COMPROT=X'2000',                     X
          RUSIZES=X'0000',                     X
          PSERVIC=X'00C000000000000000000300'
              


A TELNETDEVICE statement should then be included in the TN3270 server configuration. e.g.


    TELNETDEVICE DYNAMIC ,D4C32XX3
    TELNETDEVICE DYNAMIC ,DYNAMICB
              


More detailed information on setting up Large Screen Sizes can be found on the Planet MVS website at: http://planetmvs.com/tn3270/faq.html


Keyboard Mapping

The 3270 keyboard may be configured so that specific actions (keyboard functions and 3270 emulator macros) can be mapped to any of the shift-states (Shift, Alt, Ctrl, etc.) of an individual key. This allows assigning actions to more meaningful key strokes e.g. in the editor where PF1 adds and PF13 deletes a line, Alt-A and Alt-D could be remapped to PF1 and PF13 respectively.

In addition, the limitation of only 24 PFKeys can be overcome by assigning meaningful key combinations to emulator macros that, by simulating keystrokes, automatically find the command line, type in the appropriate command and hit ENTER to issue it.

FileKit supports many functions and REXX macros that may be utilised via keyboard shortcuts. The Keyboard Map column indicates the emulator's ability to assign keyboard functions to key strokes, whereas the Keyboard Macro column indicates specifically its ability to assign emulator macros to key strokes.


Mouse Mapping

Like the 3270 keyboard, the mouse buttons may be configured so that they perform specific actions. For example, F4 is widely used within FileKit as a point-and-shoot action key, so the ability to set the mouse right-click to F4 becomes invaluable. CBL recommends use of Left click then Right click in quick succession to position the cursor and hit the action key. The Mouse Map column indicates whether the mouse buttons may be mapped.

Particularly useful in FileKit is the ability to use the double-left click mouse button to position the cursor and action <Enter>. (In the case of some 3270 emulators, this may depend on support of a HOTSPOT facility. e.g. IBM PCOMM.) The Mouse Enter column indicates the emulator's ability to assign <Enter> to the mouse button left-double click.

A very nice feature is the ability to map the Mouse wheel to FileKit scrolling commands. For example, MouseWheel-Up/Down issues F7/F8 to scroll up/down, Ctrl-MouseWheel-Up/Down issues F10/F11 to scroll left/right. Since FileKit window borders and title bars also respond to these function keys, a dragging effect can be acheived in order to move and resize windows. The Mouse Wheel column indicates the emulator's ability to map the mouse wheel.


Macros

3270 emulator macros may be written or recorded to perform multiple functions and keystrokes supported by the emulator. Each macro uses a macro language that may be unique to the particular emulator package (though many emulators now also support standard Visual Basic script.) In most emulators, a macro file may be mapped to a particular key stroke on the 3270 keyboard. The names and descriptions of 3270 emulator macros, generated at CBL, and their recommended key assignments for use with FileKit, are displayed below.

Macro Name Key Map Description
All Alt-9 Issues CBLe ALL command with no parameters to display excluded lines.
AltL Alt-L Issues CBLe MARK LINE command to mark the edge of a line block.
Bof Ctrl-F8 Issues CBLe BOTTOM/BACK/DOWN commands to display bottom lines of the edited text.
CcDate Ctrl-F3 Issues CBLe Macro CCDATE to output today's date (yyyy/mm/dd) at the cursor position.
CmdLine Alt-NumHome Positions cursors on the Command Line.
CmdTexte Alt-F4 Issues CBLe CMDTEXT command to execute a command on the focus line with action of '<' reversed.
CopyBlockAlt-C Issues CBLe COPY BLOCK command to copy a marked line or box block to the focus position.
CurAll Ctrl-A Creates CBLe ALL command at the command prompt with target string equal to text at the focus position.
CurHome Ctrl-NumHome Issues CBLe CURSOR HOME command to toggle cursor between command line and focus position.
CurScale Alt-S Issues CBLe Macro CURSCALE to produce a numeric scale at the focus position in the edited text.
DelWord Alt-W Deletes a blank delimitted token at or following the cursor position.
ECmx Alt-0 Issues FileKit EDIT command to edit the default CMX file. (Specified on System.CmdText in CBLIINI.)
EditAdd Alt-A Issues CBLe SOS ADD command to add a blank line following the focus line.
EditDel Alt-D Issues CBLe SOS DELLINE command to delete the focus line.
EditDup Alt-2 Issues CBLe DUPLICATE command to duplicate the focus line.
EditSJ Alt-J Issues CBLe SPLITJOIN command to split the focus line or join the focus line with the one following.
Exclude Alt-X Issues CBLe SELECT command to exclude the focus line from the display view.
Fill Alt-F Creates CBLe FILL command at the command prompt ready to fill a marked block with text.
HdSub Alt-8 Issues CBLe Macro HD SUB to convert the focus line into a section sub-heading.
HiLo Alt-7 Issues CBLe Macro HILO to toggle highlighting of the focus line with triple asterisk.
ISPFSwaL Ctrl-F10 Issues FileKit ISPF command to open the ISPF SWAP LIST. (Only applicable when running under ISPF.)
ISPFSwap Ctrl-F9 Issues FileKit ISPF command to SWAP to alternate ISPF screen. (Only applicable when running under ISPF.)
LDiff Alt-= (equals)Issues CBLe Macro LDIFF to compare the current view with the next in the ring.
MakeCurr Ctrl-F6 Issues CBLe Macro MAKECURR to make the focus line the current line.
MinorDo Alt-F6 Issues CBLe Macro BLOCK DOWN MINOR to place focus on the next line containing double asterisk/equals.
MinorUp Alt-F5 Issues CBLe Macro BLOCK UP MINOR to place focus on the previous line containing double asterisk/equals.
Prev Alt-F9 Issues FileKit MDIPREV command to place focus on the previous MDI window (e.g. edit view) in the ring.
Reset Alt-U Issues CBLe RESET command to reset a marked line or box block.
RetrieveFAlt-F12 Issues CBLe RETRIEVE + command to place previously issued commands at the command prompt.
Sv Ctrl-S Issues CBLe Macro SV to update timestamp and level in the header of the current file and save it to disk.
TagTog Ctrl-H Toggles highlighting of the focus line on and off. (Sets/unsets the LINEFLAG bit for tag.)
Tof Ctrl-F7 Issues CBLe -*/DOWN commands to display top lines of the edited text.
Trb Alt-T Issues CBLe Macro TRB to insert TRACE functions around a marked block in an edited REXX macro.
TrbOff Ctrl-T Issues CBLe Macro TRB OFF to remove TRACE functions inserted by a previous invocation of TRB.
WinMax Ctrl-+ (plus) Issues CBLe WINDOW MAXIMISE command to maximise the current edit view (CBLe child window.)
WinMaxFr Ctrl-Num+ Issues CBLe WINDOW MAXIMISE FRAME command to maximise the current CBLe parent window.
WinRes Ctrl-- (minus)Issues CBLe WINDOW RESTORE command to restore the current edit view (CBLe child window.)
WinResFr Ctrl-Num- Issues CBLe WINDOW RESTORE FRAME command to restore the current CBLe parent window.

3270 Emulator Configuration

FileKit takes advantage of features provided by certain 3270 emulator software packages. Configuration files, including settings for large screen definition, keyboard/mouse mapping, keyboard macros, etc. as used at CBL, can be downloaded for the following emulators:

3270 Emulation Product Zip File Size Last Update
IBM Personal Communications (PC3270) 124,910 bytes 2014/02/03 11:57
Tom Brennan Vista tn3270 50,145 bytes 2012/02/16 16:51