Chapter Contents

Previous

Next
Using the SAS/C CICS Command Preprocessor

Option Descriptions

This section provides a description of each of the options recognized by the ccp command.

Note:    To negate most of these options, precede the option with ! instead of - . For example, to disable -c , use !c .   [cautionend]

-a N,M
adds sequence numbers to the output file. N specifies the first sequence number and M the incrementing value. If both N and M are 0 , then the output file is not sequenced. The default for both M and N is 0 . The -a N,M option is equivalent to the mainframe CICS preprocessor OUTSEQ option.

Note:    Since the cross-platform compiler does not support sequence numbers, you cannot use the -a option if you intend to compile the preprocessor output on UNIX.  [cautionend]

-b
enabled by default, causes the CICS preprocessor to produce code for the Execution Diagnostic Facility (EDF). The -b option is equivalent to the mainframe CICS preprocessor DEBUG option.

-c
enabled by default, indicates the preprocessor should translate EXEC CICS commands. The -c option is equivalent to the mainframe CICS preprocessor CICS option.

-d
causes the CICS preprocessor to process EXEC DLI commands. The -d option is equivalent to the mainframe CICS preprocessor DLI option.

-e
allows interception of all commands by the EDF. The -e option is equivalent to the mainframe CICS preprocessor EDF option.

-f x
emits message only of level x and above, x may be: I (notes), W (warnings), E (errors) or S (severe errors). The default is -f I . The -f x option is equivalent to the mainframe CICS preprocessor FLAG option.

-g
shows C code generated for commands in the source listing. The -g option is equivalent to the mainframe CICS preprocessor EXPAND option.

-i
lists the CICS preprocessor options in effect on the listing file. The -i option is equivalent to the mainframe CICS preprocessor OPTIONS option.

-j
results in uppercased C keywords ( VOID , INT , and so on) in the command translation. This is intended for use with the compiler's japan option. The -j option is equivalent to the mainframe CICS preprocessor JAPAN option.

-l filename
produces a CICS preprocessor listing named filename. The -l filename option is equivalent to the mainframe CICS preprocessor PRINT option.

-m
indicates that the BMS maps were generated specifically for C language programs, which is supported in CICS/ESA 3.3 and later. The preprocessor generates different default values for the FROM option of the SEND MAP command and the TO option of the RECEIVE MAP command depending on the presence (or absence) of this option. If the TO and FROM options are always explicitly coded, this option has no effect. The -m option is equivalent to the mainframe CICS preprocessor CBMSMAPS option.

-n
handles nested comments. The -n option is equivalent to the mainframe CICS preprocessor COMNEST option.

-o filename
writes the preprocessed output to the named file. This option cannot be negated.

-p
generates a prototype for ccp_exec_cics for each call to the EXEC command interface function. This is enabled by default. The -p option is equivalent to the mainframe CICS preprocessor PROTO option.

-r N
specifies the LRECL of the CICS preprocessor output file. N may be in the range 40 to 255, inclusive. The default is 255. The -r N option is equivalent to the mainframe CICS preprocessor OUTLRECL option.

-x
enables the CICS external call interface. This option allows a non-CICS program that is running on OS/390 to call a CICS program that is running in a CICS region. The non-CICS program can be translated, compiled, and prelinked under UNIX, but the final link-editing must take place on MVS. For example, this command prepares a program that uses the CICS external call interface for final link-editing on MVS:
sascc370 -WP,-x -WP,-m -Krent -Aclet myfile.cpp
Since the object shipped from UNIX is prelinked, you should specify the mainframe COOL option NOCOOL to run only the linkage-editor.

The -x option is equivalent to the mainframe CICS preprocessor EXCI option. For details on the CICS external call interface, see the SAS/C CICS User's Guide, Second Edition.

Note:    When using the CICS external call interface, the program must be linked with the standard resident library, STDOBJ , and not the CICS library.  [cautionend]

-z
defines the number of lines per page in the listing file. The default is 60. The -z option is equivalent to the mainframe CICS preprocessor PAGESIZE option.


Chapter Contents

Previous

Next

Top of Page

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