xpre – XCICS translator

 Top  Previous  Next

XCICS supports a large part of the original IBM’s CICS Command Level services. Interfaces of user programs remain unchanged and programs using CICS, when migrated to UNIX/Linux or Windows, need only to be recompiled in the new environment.

Program compiling is performed through the following steps:

•Translation or precompiling;
•Compiling

The XCICS precompiler processes programs originally written in COBOL, PL/1 or C-language translates the EXEC CICS instructions coded in user programs into a language code that is compatible with the compiler and provides initialization for service functions.

The output of the precompilaton step consists of an intermediate source program that will be compiled with appropriate compiler, producing the final object module.

Syntax

xpre [options] <source>

Options

-v, --verbose

verbose messaging

-o, --output <file>

specifies an alternative output file

-l, --language=<lang>

specifies source code language. lang can be:        

COBOL2 (default)

COBOL

C

PL/I

-i, --ignore <cmd>

ignore the specified command while precompiling, option can be repeated

-t, --stdout

output flushes on standard output

-n, --stdin

input is read from standard input (--stdout is assumed)

-S, --nosevere

xprecob handles error like warnings

-h, --help

produces command line help

-d, --dump

produces the list of supported commands

-D, --debug

enables extra messages generation for debug

-P, --pooldir

enables XCICS pooldir addressing

-C, --cvda

changes CVDA values

-a, --autocommarea

   --gbd

   --noautoreturn

 

   --noexit

automatically adds DFHCOMMAREA

if not declared precompiles C language for GDB usage

prevents automatic EXEC CICS RETURN statemenst at end of PL/1 programs

prevents exit() to be transformed in EXEC CICS RETURN in C programs

-P, --pooldir

provides addressing for internal XCICS areas

-S, --nosevere

   --noreturn

   --alternatesplit

ignore severe errors

do not precompile EXEC CICS RETURN statements

use an alternate parser for COBOL

 

Variables to be set are :

XPREHOME=$XFRAMEHOME/xpre PATH=$PATH:$XPREHOME
PERL5LIB=$XPREHOME/bin:$PERL5LIB

xpre returns 0 upon a successful work, even if warning have been found. A negative value is returned if one or more errors have been found.

Messages are logged both on standard error and output file. No listing file is generated as the produced COBOL output contains remarked:

•warnings
•errors
•messages
•command report

Precompiler Messages

PROCEDURE DIVISION USING found

PROCEDURE DIVISION USING has been found. This is not normal for an XCICS program: a warning is issued.

no linkage section found: forcing

source code does not contains LINKAGE section. Xprecob forces it.

unsupported/wrong command

xprecob does not support/recognize the specified EXEC CICS command.

unsupported/wrong option(s)

xprecob does not support/recognize the specified EXEC CICS option.

command ignored

xprecob is ignoring the specified command: no code is generated for the specified EXEC CICS.

parameter ignored

specified parameter has no meaning for xprecob.

option required

specified option is required for the command

syntax error

xprecob does not recognize the format of specified EXEC CICS command.

Requires

specified command require specified options

no host defined

A literal is supplied as parameter in EXEC CICS while a working storage field is required.

requires user data

specified options requires user data