   P A R M 2 O U T  -  Platform: MVS batch


   Little Hilmas utility to write in output the content of 'PARAM='


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

PARM2OUT.OBJ               executable for MVS mainframe, in obj form
PARM2OUT.HIL               Hilmas source of this file
README.TXT                 this help file
LINKEDIT.JCL               job example to install PARM2OUT
PARM2OUT.JCL               job example to use PARM2OUT


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 PARM2OUT.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 your JCLs (i.e. in //JOBLIB ) or a linklist library
  (in this case, you must refresh linklist with F LLA,REFRESH command)



Program instruction:


      PARM2OUT batch utility writes on DD SYSPRINT (or in SYSLIST
in VSE) what is specified in PARM= in EXEC jcb control statement.
      This can be useful to write some commands in the header or trailer
of an output; can be useful in MVS to give console commands, in a 
particular order or moment inside a job.
      Another use can be to parametrize SYSIN cards in MVS: because SYSIN
cards cannot contain variables whereas what is in PARM= yes, redirectioning
SYSPRINT on a sequential file you have this SYSIN file with variables
already evaluated.

      In the same PARM you can write more lines of output, dividing
them with semicolons (;). Repeat two time the semicolon (;;) to write
in output a single semicolon. If you want write in output the running
date and time, write in PARM the string $T (T must be in uppercase and
muse be followed by at least a blank).


      For example in VSE, to give a command to XEROX laser printer:
      // EXEC PARM2OUT,PARM=' $DJDE$ JDL=COOP,JDE=DFLT,END;;'

      In MVS, to give a console command, SYSPRINT must be directed to 
      internal reader:

      //STEP01 EXEC PGM=PARM2OUT,PARM='/*$VS,''V NET,ID=EV1EVC4,ACT'''
      //SYSPRINT DD SYSOUT=(A,INTRDR)

      (double quote ('') inside PARM has the purpose to put in output
         a single quote)


