1. CICS Runtime RunTime must be installed. Some technical copy files used by prepro-cics.pl are delivered under cpylib CICS Runtime RunTime module.
2. The environment variable COBCPY, which indicates to the Micro Focus COBOL Compiler-or Cobol IT compiler where copybooks are stored, must be correctly set to include CICS Runtime RunTime copy files (cpylib) during compilation time.
• KIX--INDICS and KIX--ALL-ARGS, always;
• KIX--CONDITIONS, always;
• KIX--DFHRESP, always;
• KIX--DFHVALUE, if the DFHVALUE pseudo-function is used in the program or one of the copy files it includes;
•
5. The program must take exactly two parameters, DFHEIBLK (defined by the copy file of the same name) and DFHCOMMAREA, defined as suitable for the application PROCEDURE DIVISION. In other words, the program must look like this:prepro-cics.pl — A function that reads a Cobol program file from standard input, and outputs it with CICS instructions translated on standard output.prepro-cics.pl takes a COBOL program as input, reads it line by line, and output a file with CICS instructions translated.prepro-cics.pl performs only one pass and processes lines one by one. That is, it reads a line from the standard input, outputs one or several lines (it may output none depending on the output type), and then reads the next input line. This behavior enables it to be compatible for use as a preprocessor inside a compiler, but prohibits using the same file as input and output. Note that it will output lines at the end of the input file.notrec specifies the way instructions that are not fully supported are processed. (Some options of the instruction are not recognized, hence the "notrec"). There are two possibilities:type_output determines the way that output is printed; recognized values are:
•
• Instruction invalid (IGNORE and HANDLE instructions),IGNORE and HANDLE instructions messages are quite straightforward:IGNORE should be constructed with CONDITION.
• <command> expects one of <keyword list>, but none is present.
• <command> expects <keyword>, but couldn't find it.
• <command> does not know about <keyword>.
• In <command>, <keyword> expects either: … <keyword> (one of <keyword list>), … but none of them was found.
•
•
• Default value of <keyword> is supposed to be computed with value of <keyword>, but its value (<value>) is not a charstring.