Chapter Contents

Previous

Next

Issuing CICS commands

You can use EXEC CICS commands in SPE applications written in C in exactly the same way as with the full library. Refer to Chapter 2, "The SAS/C CICS Command Preprocessor," in the SAS/C CICS User's Guide for details on using the SAS/C CICS command preprocessor. The use of the EXEC CICS RETURN or EXEC CICS XCTL command in an SPE application terminates the C environment before execution of the command. Registered atexit routines are also called before execution of the command.

Note the following:

• The HANDLE command is not supported in C code by SPE.

• The _eibptr global variable is set in L$UMAIN to point to the EXEC Interface Block. The global externs _commptr and _dibptr are not initialized by any SPE code. No DL/I initialization call is performed.

In addition to using CICS commands in your SPE C code, you may find it necessary to add CICS commands to library SPE routines in assembler when you modify them. EXEC CICS commands in assembler programs are translated into invocations of the DFHECALL macro, which uses EXEC interface storage, mapped by DFHEISTG, to build parameter lists to pass to CICS. The initial allocation of this storage occurs in L$UMAIN; its pointer is stored in the CRAB control block field CRABEIS. You can address this storage in the following manner:

L     Rx,CRABEIS
USING DFHEISTG,Rx
EXEC  CICS ....

Alternatively, you can provide a storage area in the DSA of an assembler function for the DFHECALL macro's use, as in the following example:

COPY DSA
DFHEIPL   DS   20F
DSALEN    EQU  *-DSA

Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.