SAS/C C++ Development System User's Guide, Release 6.50

COOL Options

COOL Options lists the options available for the COOL utility and the systems to which these options apply. The majority of these options are documented in detail in the SAS/C Compiler and Library User's Guide. This table is primarily for reference only. A select few of the COOL options (the ones most applicable to the C++ environment) are documented following the table.

COOL Options
Option TSO CMS MVS Batch

allowrecool
X X X

allresident
X X

arlib
X

auto

X

cics
X X

cicsvse
X X

cxx
X X

dbglib
X X X

dupsname
X X X

enexit
X X X

enexitdata
X X X

entry
X

enxref
X X X

extname
X X X

files

X

genmod

X

global

X

gmap
X X X

gos
X X

ignorerecool
X X X

inceof
X X X

lib
X

libe

X

lineno
X X X

list
X X X

lked

X

lkedname
X
X

load
X

loadlib
X

nocool
X
X

output

X

pagesize
X X X

prem
X X X

print
X X

prmap
X X X

rtconst
X X X

smpjclin
X X X

smponly
X X X

smpxivec
X X X

spe
X X

start

X

term
X X X

upper
X X X

verbose
X X X

warn
X X X

xfnmkeep
X X X

xsymkeep
X X X

***COOL Options***
Option	TSO	CMS	MVS Batch
`allowrecool`	X	X	X
`allresident`	X	X
`arlib`	X
`auto`		X
`cics`	X	X
`cicsvse`	X	X
`cxx`	X	X
`dbglib`	X	X	X
`dupsname`	X	X	X
`enexit`	X	X	X
`enexitdata`	X	X	X
`entry`	X
`enxref`	X	X	X
`extname`	X	X	X
`files`			X
`genmod`		X
`global`		X
`gmap`	X	X	X
`gos`	X	X
`ignorerecool`	X	X	X
`inceof`	X	X	X
`lib`	X
`libe`		X
`lineno`	X	X	X
`list`	X	X	X
`lked`		X
`lkedname`	X		X
`load`	X
`loadlib`	X
`nocool`	X		X
`output`		X
`pagesize`	X	X	X
`prem`	X	X	X
`print`	X	X
`prmap`	X	X	X
`rtconst`	X	X	X
`smpjclin`	X	X	X
`smponly`	X	X	X
`smpxivec`	X	X	X
`spe`	X	X
`start`		X
`term`	X	X	X
`upper`	X	X	X
`verbose`	X	X	X
`warn`	X	X	X
`xfnmkeep`	X	X	X
`xsymkeep`	X	X	X

The following list describes the COOL options that are most applicable to the C++ environment.

allowrecool

specifies that the output object deck can be reprocessed by COOL. Therefore, the deck is not marked as already processed by COOL.

The default noallowrecool specifies that the output object cannot be reprocessed by COOL. A later attempt to reprocess the deck with COOL will produce an error.

The short form of this option is -rc .

Note: COOL does not modify the object deck to enable reprocessing. It is the user's responsibility to determine if a particular object is eligible for reprocessing. [cautend]

See SAS/C Software: Changes and Enhancements, Release 6.50 for more information on this option.

cxx

specifies that the LCXX CLIST or EXEC should add the C++ object library to the autocall list. This option is valid under TSO and CMS.

The short form of this option is -cxx .

dbglib

specifies a debugger file qualifier that provides for customization of the destination of the debugger file. For each platform, dbglib specifies something different:

On MVS:

A SAS/C file specification that denotes a PDS. The filename is constructed using whatever is supplied, followed by ( sname )

On CMS:

If the option specified starts with a ' / ' , then it is assumed that this is either a ' //sf: ' file specification or an SFS path. In this case, the specification is prepended to the filename. For example:

 dbglib(//sf:/ted/)

will generate the name

 //sf:/ted/sname.DB

If the option specified does not start with a ' / ', then it is considered to be a filemode, and will be appended to the filename. For example:

 dbglib(d2)

will generate the name

 sname.db.d2

The option has different defaults on the various platforms:

On MVS:: dbglib(ddn:sysdblib)
On CMS:: dbglib(A)

For the various platforms, this default causes the filename to take different forms:

On MVS:: ddn:sysdblib(sname)
On CMS:: sname.DB.A

The short form of this option is -db .

enxref

controls the production of the cross-references that are produced by default when COOL produces object files that contain extended names. The default value is noenxref .

If enxref is specified, COOL produces three cross-references that are generated in a table that follows all other COOL output. These three cross-references are SNAME, CID, and LINKID. SNAME is in alphabetical order by the SNAME that uniquely identifies an object file. CID displays the extended names in alphabetical order by C identifier. LINKID displays the extended names in alphabetical order by a link ID that COOL assigns. When REFERENCES is specified, referenced symbols as well as defined symbols are included in the cross-reference listing. noenxref suppresses the production of all extended names cross-references.

Under TSO, the enxref option takes the following form:

 enxref('cross-ref,cross-ref,cross-ref')

where cross-ref is SNAME, CID, or LINKID, or its negation. For example, the following specification suppresses the SNAME cross-reference and enables the CID cross-reference:

 enxref('nosname,cid')

Under CMS, the enxref option takes the following form:

 enxref <cross-ref> <cross-ref> <cross-ref>

where cross-ref is SNAME, CID, or LINKID, or its negation. For example, the following specification suppresses the SNAME cross-reference and enables the CID cross-reference:

 enxref nosname cid

Under CMS, if you specify enxref with no arguments, all three listings are produced.

Under MVS batch, the enxref option takes the following form:

 enxref(cross-ref,cross-ref,cross-ref)

where cross-ref is SNAME, CID, or LINKID, or its negation. For example, the following specification suppresses the SNAME cross-reference and enables the CID cross-reference:

 enxref(nosname,cid)

The short forms of this option are:

-xxx for enxref(cid)

-xxe for enxref(linkid)

-xxs for enxref(sname)

-xxy for enxref(references)

genmod

specifies that the COOL EXEC is to create a MODULE file named filename , using the genmod options that are specified. The genmod option takes the following form:

 genmod <filename <options>>

The genmod option must follow any use of any other option on the command line. The genmod option causes the COOL EXEC to issue the following CMS commands after COOL has created the COOL370 TEXT file:

 LOAD COOL370 (NOAUTO NOLIBE CLEAR
GENMOD filename

where filename is either the filename specified following the genmod keyword or the first name specified in the COOL command. If no filenames are specified in the command, the COOL EXEC issues an error message. The genmod option is valid only under CMS.

ignorerecool

specifies that if any marks are detected indicating that COOL has already processed an input object deck, then the marks are to be ignored. If the ignorerecool option is specified along with the verbose option, then a diagnostic message is issued and processing continues.

The default noignorerecool specifies that any marks indicating that COOL has already processed an input object deck should result in an error message and process termination.

The short form of this option is -ri .

See SAS/C Software: Changes and Enhancements, Release 6.50 for more information on this option.

lib

specifies the data set name of an autocall object library containing functions that are to be linked automatically into the program if referenced. The lib keyword has the following form:

 lib (dsname)

(Note that load module libraries cannot be used.) If the library belongs to another user, the fully qualified name of the data set must be given, and the name must be preceded and followed by three apostrophes. No final qualifier is assumed for a lib data set. This option is valid only under TSO.

load

names the data set into which the linkage editor stores the output load module. The load keyword has the following form:

 load (dsname)

This keyword should specify a PDS member. If the data set belongs to another user, the fully qualified name of the data set must be given and the name must be preceded and followed by three apostrophes. If the data set name is not specified within three apostrophes, it is assumed to be a data set name with a final qualifier of LOAD. Additional information about the load option is available in the SAS/C Compiler and Library User's Guide. This option is valid only under TSO.

print

controls where COOL and linkage editor output listings should be printed. The print keyword has two forms. The first form is as follows:

 print(*)

This form of the print keyword indicates that the COOL and linkage editor output listings should be printed at the terminal.

The other form of the print keyword is as follows:

 print (dsname)

This form of the print keyword specifies that the COOL and linkage editor listings should be stored in the named data set. This data set must be sequential; a PDS member is not allowed. If the data set belongs to another user, the fully qualified name of the data set must be given, and the name must be preceded and followed by three apostrophes. If the data set name is not specified within three apostrophes, it is assumed to be a data set name with a final qualifier of LINKLIST. noprint specifies that no linkage editor or COOL listing is to be produced. If you use the noprint option with CLK370, COOL, and linkage editor output, except for diagnostic messages, is suppressed. If neither print nor noprint is used, the default is noprint . This option is valid only under TSO.

The short form of this option is -h .

term

specifies that COOL error messages be written to the standard error output file (the terminal or the SYSTERM DD statement in MVS batch) as well as to COOL's standard output. noterm suppresses COOL's error output.

Under TSO, term is the default if the print option is not used, or if the print option specifies a data set. The default is noterm if print(*) is specified.

Under CMS and MVS batch, the default is noterm .

The short form of this option is -t .

upper

produces all output messages in uppercase. This option is valid in TSO, CMS, and MVS batch.

The short form of this option is -u .

warn

specifies that warning messages (which are associated with RC=4) are to be issued. This is the default. nowarn suppresses warning messages. This option is valid in TSO, CMS, and MVS batch.

The short form of this option is -w .

Chapter Contents
Previous
Next
Top of Page

`-xxx`	for `enxref(cid)`
`-xxe`	for `enxref(linkid)`
`-xxs`	for `enxref(sname)`
`-xxy`	for `enxref(references)`