IBM XL Fortran for AIX, V15.1.3 IBM Compiler Reference Version 15.1.3 SC27-4244-02 IBM XL Fortran for AIX, V15.1.3 IBM Compiler Reference Version 15.1.3 SC27-4244-02 Note Before using this information and the product it supports, read the information in “Notices” on page 417. First edition This edition applies to IBM XL Fortran for AIX, V15.1.3 (Program 5765-J09; 5725-C74) and to all subsequent releases and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product. © Copyright IBM Corporation 1990, 2015. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this document ........ vii Compiling Fortran 2008 programs ...... 25 Who should read this document ....... vii Compiling and linking a library ...... 26 How to use this document ......... vii Compiling XL Fortran SMP programs .... 28 How this document is organized ....... vii Compilation order for Fortran programs.... 29 Conventions .............. viii Canceling a compilation ......... 29 Related information ........... xii XL Fortran input files .......... 29 IBM XL Fortran information........ xii XL Fortran output files ......... 31 Standards and specifications ....... xiii Scope and precedence of option settings .... 33 Other IBM information ......... xiv Specifying options on the command line.... 33 Technical support ............ xiv Specifying options in the source file ..... 34 How to send your comments ........ xiv Passing command-line options to the "ld" or "as" command .............. 35 Chapter 1. Introduction ........ 1 Compiling for specific architectures ..... 35 Passing Fortran files through the C preprocessor 36 cpp directives for XL Fortran programs .... 37 Chapter 2. Overview of XL Fortran Passing options to the C preprocessor .... 37 features ............... 3 Avoiding preprocessing problems ...... 37 Hardware and operating-system support ..... 3 Linking XL Fortran programs ........ 38 Language support ............ 3 Compiling and linking in separate steps .... 38 Source-code conformance checking ....... 4 Linking 32–bit SMP object files using the ld Highly configurable compiler ......... 4 command .............. 38 Diagnostic listings ............ 6 Linking 64-bit SMP object files using the ld Symbolic debugger support ......... 6 command .............. 39 Program optimization ........... 6 Linking 32–bit non-SMP object files using the ld command .............. 40 Chapter 3. Setting up and customizing Linking 64-bit non-SMP object files using the ld XL Fortran.............. 7 command .............. 41 Where to find installation instructions ...... 7 Passing options to the ld command ..... 41 Correct settings for environment variables .... 7 Checking for interface errors at link time ... 41 Environment variable basics ........ 7 Linking new objects with existing ones .... 41 Environment variables for national language Relinking an existing executable file ..... 42 support ............... 8 Dynamic and static linking ........ 43 IPA environment variables ......... 9 Avoiding naming conflicts during linking ... 43 LIBPATH: Setting library search paths ..... 9 Running XL Fortran programs ........ 44 Profile-directed feedback environment variables 10 Canceling execution .......... 44 TMPDIR: Specifying a directory for temporary Running previously compiled programs .... 45 files ................ 11 Compiling and executing on different systems.. 45 XLFSCRATCH_unit: Specifying names for scratch POSIX Pthreads binary compatibility ..... 45 files ................ 11 Runtime libraries for POSIX pthreads support .. 46 XLFUNIT_unit: Specifying names for implicitly Selecting the language for runtime messages .. 47 connected files ............ 11 Setting runtime options ......... 47 Using custom compiler configuration files .... 11 Other environment variables that affect runtime Creating custom configuration files ..... 12 behavior ............... 59 Editing the default configuration file ...... 15 XL Fortran runtime exceptions ........ 59 Configuration file attributes ........ 16 Determining which level of XL Fortran is installed 18 Chapter 5. Tracking and reporting Running two levels of XL Fortran ....... 19 compiler usage ........... 61 Understanding utilization tracking and reporting .. 61 Chapter 4. Editing, compiling, linking, Overview .............. 61 and running XL Fortran programs ... 21 Four usage scenarios .......... 62 Editing XL Fortran source files ........ 21 Preparing to use this feature......... 70 Compiling XL Fortran programs ....... 21 Time synchronization .......... 70 Compiling XL Fortran Version 2 programs ... 24 License types and user information ..... 70 Compiling Fortran 90 or Fortran 95 programs .. 24 Central configuration .......... 71 Compiling Fortran 2003 programs ...... 25 Concurrent user considerations ....... 71 © Copyright IBM Corp. 1990, 2015 iii Usage file considerations ......... 72 -O ................. 137 Regular utilization checking ........ 74 -o ................. 140 Testing utilization tracking ......... 74 -p ................. 141 Configuring utilization tracking ....... 75 -q32 ................ 142 Editing utilization tracking configuration file -q64 ................ 143 entries ............... 76 -qalias ................ 144 Understanding the utilization reporting tool ... 79 -qalias_size .............. 147 Utilization reporting tool command-line options 79 -qalign ............... 148 Generating usage reports .......... 83 -qarch ................ 150 Understanding usage reports ....... 84 -qassert ............... 153 Pruning usage files ............ 86 -qattr ................ 155 Diagnostic messages from utilization tracking and -qautodbl............... 155 reporting ............... 87 -qbindcextname ............ 158 Tracking compiler usage with Software License -qcache ............... 159 Metric Tags logging ........... 87 -qcclines ............... 162 -qcheck ............... 162 Chapter 6. Summary of compiler -qci................. 165 options by functional category .... 91 -qcompact .............. 166 -qcr................. 167 Output control ............. 91 -qctyplss ............... 168 Input control .............. 93 -qdbg ................ 169 Language element control ......... 94 -qdbgfmt ............... 171 Floating-point and integer control ....... 96 -qddim ............... 172 Object code control ............ 97 -qdescriptor .............. 173 Error checking and debugging ........ 98 -qdirective .............. 174 Listings, messages, and compiler information... 101 -qdirectstorage ............. 176 Optimization and tuning ......... 102 -qdlines ............... 176 Linking ............... 106 -qdpc ................ 177 Portability and migration ......... 107 -qdpcl ................ 178 Compiler customization .......... 109 -qenum ............... 179 Deprecated options ........... 109 -qescape ............... 180 -qessl ................ 181 Chapter 7. Detailed descriptions of the -qexpfile ............... 182 XL Fortran compiler options ..... 113 -qextchk ............... 183 -# ................. 114 -qextern ............... 184 -1 ................. 115 -qextname .............. 185 -B ................. 115 -qfdpr ................ 186 -b64 ................ 116 -qfixed ............... 187 -bdynamic, -bshared, and -bstatic ....... 117 -qflag ................ 188 -bhalt ................ 118 -qfloat ................ 189 -bloadmap .............. 119 -qfpp ................ 194 -bmaxdata, -bmaxstack .......... 120 -qflttrap ............... 195 -brtl ................ 121 -qfree ................ 197 -bshared ............... 122 -qfullpath .............. 198 -bstatic ............... 122 -qfunctrace .............. 199 -C ................. 122 -qfunctrace_xlf_catch ........... 201 -c ................. 123 -qfunctrace_xlf_enter ........... 202 -D ................. 123 -qfunctrace_xlf_exit ........... 203 -d ................. 124 -qhalt ................ 204 -e ................. 125 -qhaltonmsg .............. 205 -F ................. 125 -qhelp ................ 206 -g ................. 127 -qhot ................ 206 -G ................. 130 -qieee ................ 209 -I ................. 131 -qinfo ................ 210 -k ................. 132 -qinit ................ 215 -L ................. 132 -qinitalloc .............. 215 -l ................. 133 -qinitauto............... 217 -MF ................ 134 -qinlglue ............... 220 -MMD................ 135 -qinline ............... 221 -MT ................ 136 -qintlog ............... 223 -NS................. 137 -qintsize ............... 224 iv XL Fortran: Compiler Reference -qipa ................ 226 -qthreaded .............. 316 -qkeepparm .............. 233 -qtimestamps ............. 317 -qlanglvl ............... 234 -qtune ................ 318 -qlargepage .............. 236 -qufmt................ 321 -qlibansi ............... 237 -qundef ............... 321 -qlibessl ............... 238 -qunroll ............... 322 -qlibmpi ............... 238 -qunwind............... 324 -qlibposix............... 239 -qvecnvol............... 324 -qlinedebug .............. 240 -qversion ............... 325 -qlist ................ 241 -qvisibility .............. 327 -qlistfmt ............... 242 -qwarn64 ............... 328 -qlistopt ............... 245 -qweakexp .............. 329 -qlog4 ................ 246 -qxflag=dvz .............. 330 -qmakedep .............. 246 -qxflag=oldtab ............. 331 -qmaxerr ............... 249 -qxlf77...............