5 Command Qualifiers

This chapter describes the command-line qualifiers of the basic KAP Fortran for Compaq OpenVMS Alpha.

To specify a command qualifier, you can use the long name or short name. Additionally, you can specify command qualifiers on the first line of the source file. (See the description of the C*$* qualifier line at the end of this chapter.)


Note
The short names for qualifiers are provided for the convenience of interactive users. Because the short names may not be unique in future versions of KAP, the long names should be used when compatibility between versions is required.

Many KAP command qualifiers can also be set with inline directives or assertions. See Chapter 6 for information about directives and Chapter 7 for information about assertions. Chapter 9 shows extensive examples of transformations controlled by these qualifiers.

Table 5-1 lists the command qualifiers. The first column lists the long name of each qualifier, and also shows the functional categories of qualifiers, as follows:

The next two columns list the short names and default value of each qualifier.

See Chapter 10, the /listoptions=k qualifier, for how to get the qualifier values active for a given KAP run.


Note
A backslash (/) is required before each qualifier name, but the hyphen is not shown in Table 5-1.

Table 5-1 Command-Line Qualifiers

Long Name  Related Qualifier  Short Name  Default Value 
General Optimization       
[no]interchange  o,so  interchange  interchange 
[no]namepartitioning= (<integer>,<integer>)  so  [n]namepart= (<integer>,<integer>)  nonamepartitioning 
optimize=<integer>    o=<integer>  optimize=5 
roundoff=<integer>  o, so  r=<integer>  roundoff=3 
scalaropt=<integer>  so=<integer>  scalaropt=3 
[no]skip  sk  [n]sk  noskip 
tune=<architecture>    tune=<architecture>  tune=<architecture> 
Parallel Processing Qualifiers       
[no]compiler=<list>      openvmsf90 (no compiler with kapf command) 
[no]concurrentize    [n]conc  noconcurrentize 
minconcurrent=<integer>    mc  minconcurrent=1000 
[no]parallelio    [n]pio  noparallelio 
scheduling=<list>    sched=<list>  scheduling=e 
Fortran Dialect       
align_ common=<integer>    align_common=<integer>  align_ common=1 
align_ struct=<integer>    align_ struct=<integer>  align_struct=4 
assume=<list>    a=<list>  assume=cel 
noassume    na   
[no]datasave  sv  [n]ds  datasave 
[no]dlines    [n]dl  nodlines 
[no]escape    noescape  escape 
[no]freeformat    [n]ff  nofreeformat 
integer=<integer>    int=<integer>  integer=4 
[no]intlog  sy  [n]intl  intlog 
kind=<integer>  log, real, int  kind=<integer>  kind=4 
logical=<integer>    log=<integer>  logical=4 
[no]natural    [n]nat  see Section 5.3.12 
[no]onetrip    [n]1  noonetrip 
real=<integer>    rl=<integer>  real=4 
save=<list>  ds, rc  sv=<list>  save=manual_adjust 
scan=<integer>    scan=<integer>  scan=72 
syntax=<list>    sy=<list>  (off) 
[no]type    [n]ty  notype 
Directives       
directives=<list>    dr=<list>  directives=ak 
nodirectives=<list>    ndr   
[no]ignoreoptions    [n]ig  noignoreoptions 
Inlining and IPA       
inline[=<names>]  ag  inl[=<names>]  off 
noinline[=<names>]    ninl[=<names>]  off 
ipa[=<names>]    ipa[=<names>]  off 
noipa[=<names>]    nipa[=<names>]  off 
inline_and_copy=<names>    inlc=<names>  off 
inline_create=<file>  ipa  incr=<file>  off 
ipa_create=<file>    ipacr=<file>  off 
inline_depth=<integer>    ind=<integer>  inline_ depth=2 
ipa_ depth=<integer>    ipad=<integer>  ipa_depth=2 
inline_from_files=<file>,<file>  inl  inff=<file>,<file>  current source file 
ipa_ from_files=<file>,<file>  ipa  ipaff=<file>,<file>  current source file 
inline_from_libraries= <library>,<library>  inl  infl=<library>, <library>  off 
ipa_from_ libraries=<library>,<library>  ipa  ipafl=<library>, <library>  off 
inline_looplevel=<integer>    inll=<integer>  inll=2 
ipa_looplevel=<integer>    ipall=<integer>  ipall=2 
inline_ manual    inm  off 
ipa_ manual    ipam  off 
inline_ optimize=<integer>  see Section 5.4.11    inline_ optimize=0 
ipa_ optimize=<integer>      noipa_optimize=0 
Input- Output       
cmp=<file>    cmp=<file>  nocmp 
fortran=<file>    f=<file>  nof 
list=<file>    [n]l   
[no]list    [n]l   
Listing       
cmpoptions[=<list>]    cp[=<list>]  cmpoptions=n 
nocmpoptions    ncp   
lines=<integer>    ln=<integer>  lines=55 
listingwidth=<integer>  lo  lw=<integer>  listingwidth=132 
listoptions=<list>    lo=<list>  listoptions=0 
suppress=<list>    su=<list>  off 
Advanced Optimization       
aggressive=<list>  nat, inl  ag=<list>  noaggressive 
noaggressive    nag   
[no]arclimit=<integer>  so, r  [n]arclm=<integer>  arclimit=5000 
cacheline=<integer>[,<integer>]    chl=<integer> [,<integer>]  cacheline=32,32 
cache_prefetch_line_ count=<integer>    cplc=<integer>  cache_prefetch_line_ count=0 
cachesize=<integer>[,<integer>]    chs=<integer> [,<integer>]  cachesize=8,0 
dpregisters=<integer>    dpr=<integer>  dpregisters=32 
each_invariant_if_ growth=<integer>  so, r, miifg  eiifg=<integer>  eiifg=20 
fpregisters=<integer>    fpr=<integer>  fpr=32 
[no]fuse  so,o  fuse  nofuse 
fuselevel=<integer>  fuse  fuselevel=<integer>  fuselevel=0 
generateh  hdir,useh    off 
[no]hdir=<directory name>    hdir=<directory name>  hdir=<current directory> 
heaplimit=<integer>    heap=<integer>  heaplimit=116 
hoist_ loop_invariants=<integer>    hli  hli=1 
[no]interleave    intl  interleave 
library_calls=<name>  ro  lc=<name>  off 
limit=<integer>    lm=<integer>  lm=20000 
[no]machine=<list>  so, r  ma=<list>  ma=s 
max_invariant_if_ growth=<integer>  so, r, eiifg  miifg=<integer>  miifg=500 
[no]routine= <routine_name>/<limited qualifiers>  See text  [n]rt=<routine_name> /<limited qualifiers>  noroutine 
setassociativity=<integer>  so, r  sasc=<integer>  sasc=1 
[no]srlcd  so  [n]srcld  nosrlcd 
unroll=<integer>  so, r  ur=<integer>  unroll=4 
unroll2=<integer>  so, r  ur2=<integer>  unroll2=160 
unroll3=<integer>  so, r  ur2:<integer>  unroll3=20 
useh  hdir,genh    off 

The subheadings in the following sections list the long and short names for each qualifier, followed by its default in parentheses.

Unless otherwise noted, the code examples in this chapter were run with /optimize=5, /scalaropt=2, /roundoff=2 , and /unroll=1 .


Previous Page | Next Page | Contents | Index |
Command-Line Qualifiers

Copyright © Digital Equipment Corporation. 1999. All Rights Reserved.