   E X E C P G M  -  Platform: MVS routine


   A routine to launch an executable program, that usually is a
stand-alone program.


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

EXECPGM.OBJ             executable for MVS mainframe, in obj form
EXECPGM.HIL             Hilmas source of this file
README.TXT              this help file 
LINKEDIT.JCL            job example to install EXECPGM
MAN_ENG.TXT             manual in English
MAN_ITA.TXT             manual in Italian
TESTEPGM.OBJ            Demo of use of EXECPGM in assembler
TESTEPGM.HIL            Source Hilmas of demo



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 EXECPGM.OBJ 'MYUSER.PROGRAM.OBJ'

- Prepare a Job to Linkedit transferred obj in a load library;
  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 in your compilation job.

- Recall this routine in your Cobol program as explained in manual;
  then linkedit your program with this routine, verifying that 
  this load library is included in your compilation procedure.


Program instruction:

    See the manual for examples in COBOL of the use of this routine.
Here we want explain the demo in Hilmas enclosed in distribution;
TestEPgm is a very simple program that display use of EXECPGM from
an assembler program. See source TESTEPGM.HIL.

    To install executable (OBJ) of this demo you must do the same things 
you have done for EXECPGM; pay attention that the linkedit library SYSLIB
(in the linkedit job) must already contains routines EXECPGM that
must be linked together with TESTEPGM. In others words, to
install TestEPgm you must have installed EXECPGM, too.

    To run demo TESTEPGM in your ISPF/TSO session write:
       TSO TESTEPGM        (if library of this executable is in linklist)
or, from =3.4 menu option, enter 'M' of the load library containing
TestAsk and, left to executable, write CALL <Enter>.

    TestEPgm show an interactive screen similar to this:


       --- TEST OF "EXECPGM" ROUTINE. ---
                                                                    
                                                                    
       WRITE PROGRAM NAME:
     iefbr14

       WRITE PARAM= :
                                                                    
       RETURN CODE : 0



     If program don't use  PARAM=, you can skip this answer.
Naturally, if the program you launch use some DDs, these must be preallocated
in your TSO session. To avoid this problem, you can launch a TSO program,
so you see it on the screen (for example QUEENS in this series of Hilmas
Zipped programs, if it is installed in linklist).
                                                               
