2.7 Using KAP Syntax

You may specify qualifiers in upper or lowercase with the syntax /qualifier[=value]. Do not leave spaces between the qualifier name and the value. Qualifiers can appear before or after the input file as follows:

kapf /inm  myprog.f  /roundoff=2

KAP recognizes standard abbreviations for qualifiers. Qualifiers that take a list of names must have the names separated by commas and with no spaces, for example:

/inff=file1.f,file2.f

Observe the following syntax rules:

• Using the /fkapargs option

  Enclose KAP command qualifiers passed through kfort by using the /fkapargs qualifier with parentheses as follows:

  kfort /fkapargs=(/optimize=5/roundoff=3/scalaropt=3)/nowarn myprog.f
  

  Never put spaces between KAP qualifiers enclosed by parentheses.

  Digital Fortran compiler qualifiers, for example, /nowarn , do not require parentheses.

• Concantenating files with kfort

  Insert a plus + between file names as follows:

  kfort test.f+test2.f+test3.f
  

  KAP creates a file on the current directory named test_ kapcombined.f that is derived from the name of the first file in the concatenation list. test_kapcombined.f is a file with all the files concatenated. The following results from the example:

  kapf /cmp=[]test_kapcombined_cmp.f test_kapcombined.f   /natural
  
  for/fast/optimize=(tune=host,level=5) test_kapcombined_cmp.f
  
  link /EXECUTABLE=test_kapcombined.exe test_kapcombined_cmp.obj
  

  test_kapcombined.f remains in the current directory with the transformed file test_kapcombined_cmp.f

• Using the files= option

  The size of the input line in OpenVMS requires that you specify a large number of file names on the driver input line as follows, using fpppp as an example:

  1. Create a file list.lis by using the following command:

     dir /col=1/out=list.lis *.f
     

  2. Edit list.lis to remove the first line and the last line that are echos of the dir command. The remaining file contains a list of the .f files in the current directory one file name per row.

  3. Issue the command:

     kfort/fkapargs=(/ag=ab/ur2=560/conc)/files=list.lis
     

     If you issue the kfort command with an option following file.lis , VMS protocol specifies that the option applies only to the last file name in file.lis . In the following example, /DOUBLE_ SIZE=64 applies to the last file name in file.lis .

     kfort/fkapargs=(/ag=ab/ur2=560/conc)/files=list.lis/DOUBLE_SIZE=64
     

• Listing file names

  List file names in either of the following two ways:

  1. Use commas and no spaces between file names as follows:

     kfort test.f,test2.f,test3.f
     

  2. Separate file names with spaces as follows:

     kfort test.f test2.f test3.f
     

• Using options with a list of file names

  Preceding a list of files with an option causes the option to apply to all files in the list, for example:

  kfort /DOUBLE_SIZE=64 test.f,test2.f,test3.f
  

  /DOUBLE_SIZE=64 applies to test.f, test2.f and test3.f .

  Placing an option immediately following a list of files causes the option to apply to the last file only, for example:

  kfort /DOUBLE_SIZE=64 test.f,test2.f,test3.f/I4
  

  /I4 applies only to test3.f . /DOUBLE_SIZE=64 applies to test.f, test2.f and test3.f .

  Inserting an option inside a list of files causes the option to apply only to the file it immediately precedes, for example:

  kfort /DOUBLE_SIZE=64 test.f,test2.f/G_FLOATING,test3.f/I4
  

  /G_FLOATING applies only to test2.f . /DOUBLE_SIZE=64 applies to all the files. /I4 applies only to test3.f .