2.8 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:

kapc /inm  myprog.c  /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.c,file2.c

Observe the following syntax rules:

• Using the /ckapargs option

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

  kcc /ckapargs=(/optimize=5/roundoff=3/scalaropt=3)/nowarn myprog.c
  

  Never put spaces between KAP qualifiers enclosed by parentheses.

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

• Concantenating files with kcc

  Insert a plus + between file names as follows:

  kcc test.c+test2.c+test3.c
  

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

  kapc /cmp=test_kapcombined_cmp.c test_kapcombined.c
  
  cc/fast/optimize=(tune=host,level=5) test_kapcombined_cmp.c
  
  link /EXECUTABLE=test_kapcombined.exe test_kapcombined_cmp.obj
  

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

• 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 *.c
     

  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 .c files in the current directory one file name per row.

  3. Issue the command:

     kcc/ckapargs=(/ag=ab/ur2=560/conc)/files=list.lis
     

     If you issue the kcc 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 .

     kcc/ckapargs=(/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:

     kcc test.c,test2.c,test3.c
     

  2. Separate file names with spaces as follows:

     kcc test.c test2.c test3.c
     

• 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:

  kcc /DOUBLE_SIZE=64 test.c,test2.c,test3.c
  

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

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

  kcc /DOUBLE_SIZE=64 test.c,test2.c,test3.c/I4
  

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

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

  kcc /DOUBLE_SIZE=64 test.c,test2.c/G_FLOATING,test3.c/I4
  

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