   C I C S O P E R  -  Platform: MVS/CICS


   This program is a CICS automation utility to Open/Close file, Enable
Disable terminals or transactions, etc. In short, is a interface to
CEMT system transaction to facilitate CICS operator daily work.


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

CICSOPER.OBJ             executable for MVS/CICS mainframe, in obj form
CICSOPER.HIL             Hilmas source of this program
CXITOPER.OBJ             executable in Italian, in obj form
CXITOPER.HIL             Hilmas source of this program, in Italian
README.TXT               this help file 
LINKEDIT.JCL             job example to install CICSOPER
MAN_ITA.TXT              manual in Italian
MAN_ITA.DOC              Italian manual in Word 6.0/95 (RTF) format
(english manual available only on request)


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 CICSOPER.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: the only important thing is to define CICSOPER as Assembler program
  in PPT; then define OPERFIL file in FCT; this file contains procedure
  and file definition for OPER transaction: must be a KSDS with variable
  record length (from 20 to 100) and key length 16 (offset 0).
  See manual for details.


Program instruction:

   Run the program writing in a CICS session:

       OPER

   and you will see a list of available procedures, if the OPERFIL file
   is already filled. You can write commands beside the procedure name,
   to open / close file of the selected procedure, and so on.

   See manual of this utility.


   Important remark:

   English version don't has transaction serialisation, i.e. is possible
   run simultaneously OPER from many terminals (and isn't true what the
   manual tell).

   Italian version has serialisation but don't work in CICS 4.1 (abend
   ASRA at start); it can work if you find a CEDA parameter that permit 
   to the program to write a memory location inside itself (this is the
   mechanism to serialize that the program uses, but it yield the
   executable CICSOPER not fully reentrant).


