   C I C S S D S P  -  Platform: MVS/CICS


   This program message scheduler in CICS environment.


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

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


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

- Prepare a Job to Linkedit transferred obj in a load library visible by
  CICS: 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 CICS address space.

- Complete installation defining program and transid in PPT and PCT CICS
  tables: 

PPT :
         DFHPPT   TYPE=ENTRY,PROGRAM=CICSSDSP,RSL=PUBLIC

PCT :
         DFHPCT   TYPE=ENTRY,
               TRANSID=SDSP,PROGRAM=CICSSDSP,RSL=PUBLIC

  Put similar parameter if use CEDA interactive CICS management transaction.
  The only important thing is define the language as Assembler (that
is the default in traditional tables, but not in CEDA).


Program instruction:

  SDSP is for StartDiSPlay, that is a transaction that display a message
started with TIME() or INTERVAL() option.

  Its use is:

    SDSP term hhmmss parm 'Message'

  where 'term' is terminal name to which you want to send the message
        hhmmss is the time to send, in hours, minutes and seconds;
               time can be written as +hhmmss to signify an interval from
               actual time
        'parm' is an optional parameter; can be
               /E    to clear the screen before display the message
               /T    to do a 'SEND TEXT' instead of a normal SEND
        'Message' must be enclosed with quotation mark (')

