   T S O C L E A R    -  Platform: MVS/TSO


   Little Hilmas utility clear the screen of a TSO user.


   In this distribution file (TSOCLEAR.ZIP) there is:

TSOCLEAR.OBJ            executable for MVS/TSO mainframe, in obj form
TSOCLEAR.HIL            Hilmas source of this file
LINKEDIT.JCL            Job example to linkedit TSOCLEAR obj
README.TXT              this help file


OBJ installation:

- Create in MVS a sequential file, for example 'MYUSER.PROGRAM.OBJ'
  with RECFM=FB and LRECL=80, for example of 1 cylinder.

- SEND obj module from PC to MVS in this file in BINARY form, with your 
  3270 emulation; the most important thing is a binary transfer (therefore 
  without ASCII CRLF) in a file with record length of 80 bytes.
  Use this PC command (in a PC with IBM/PCOMM 4.1 3270 emulation installed):

     SEND TSOCLEAR.OBJ 'MYUSER.PROGRAM.OBJ'

- Prepare a Job to Linkedit transferred obj in a load library (possibily
  in Linklist): use LINKEDIT.JCL as example: fit this JCL to your needs
  changing library names

- Submit linkedit job to create load module; output library must be a
  load library used by TSO users (i.e. in  //JOBLIB ) or a linklist library
  (in this case, you must refresh linklist with F LLA,REFRESH command)



Program instruction:

   This is a routine similar to 'VMFCLEAR' in VM/CMS environment, that
is a program that clear the terminal screen.
Whereas in VM/CMS this routine is supplied by IBM, not so in MVS/TSO;
if you want a minimum aesthetical improvement of your REXX or CLIST
routines in TSO, you need this little program. 
In a REXX program write:

   ADDRESS TSO        /* <-- optional, is the default  */

    . . . . .

  "TSOCLEAR"          /* <-- this instruction clear the screen  */

