ContentsIndexPreviousnext1.gif

F.7 Acu4GL for DBMaker: Common Questions and Answers

Question: I can't seem to get Acu4GL to create the files via DBMaker. They keep coming up as Vision files.

Answer: Check to see that the DEFAULT_HOST variable is set in the runtime configuration file or the environment. Setting DEFAULT_HOST in the environment overrides the setting in the runtime configuration file.

Enter the following command:

     runcbl -vv

to make sure that the version number of Acu4GL for DBMaker is reported. This tells you that Acu4GL for DBMaker has been installed successfully. If "-vv" does not return the product information for Acu4GL for DBMaker, make sure the linked runtime has the name you used, and is the first so-named executable on the PATH.

If you cannot locate a runtime that displays a Acu4GL for DBMaker product version number using "-vv", you must create one by relinking the runtime. If you must do that, make sure that USE_DBMAKER is set to "1" in the file "filetbl.c" before you relink.

Question: Can I use both DBMaker and Vision at the same time?

Answer: Yes, you can. In the runtime configuration file, set DEFAULT_HOST to the file system you want the runtime to use automatically. Then, for selected files, assign them to an alternate file system with the variable filename_HOST. For example, to put CUSTFILE into DBMaker and everything else into Vision, you would add:

     DEFAULT_HOST  Vision
     CUSTFILE_HOST  DBMAK

Question: Which files do I need in order to link my C routines into Acu4GL?

Answer: You will need everything in the LIB directory of your ACUCOBOL-GT runtime media.

From your Acu4GL media you need:

      dbmak32.obj for Windows
      dbmaker.o for UNIX

From CASEMaker you need:

      dmapi30.lib for Windows
      libdmapic.a for UNIX

Instructions for linking are given in section F.2.1, "Acu4GL for DBMaker Installation Overview".

Question: How can I find out what the DBMaker error message is?

Answer: If you run your application with the "-x" option, you receive secondary error numbers that include those returned by DBMaker, in addition to the ACUCOBOL-GT error. If you have sent the errors to an output file with the "-e" option, the runtime also attempts to include the text that explains the errors. You can also retrieve error codes from within your COBOL program by using library routine C$RERR. See section F.6, "Acu4GL for DBMaker: Troubleshooting", for additional details.

Question: Do my XFD files have to be in the same directory as my object files?

Answer: No. You can instruct the compiler to put the XFD files in a directory other than the current one with the "-Fo" option, or you can move the XFD files after they're created. Then, at runtime, make sure you have the XFD_DIRECTORY runtime configuration variable set to that same directory.

Question: Why aren't my keys being retrieved in the correct order?

Answer: You may have illegal data in the field. For example, if you've used LOW-VALUES or HIGH-VALUES in a numeric key to mark control records, those values are considered invalid and can cause the records containing them to be retrieved in an unexpected sequence.

Signed numeric data in key fields can also be a problem; the records may not sort, or be retrieved, in the same sequence as under the Vision file system.

Question: Can I open tables in different databases and share the data?

Answer: Yes. But you must set up the databases one at a time, as described in this section. Remember, you can set up databases dynamically at run time by adding a line like this before the statement that opens the file:

     SET ENVIRONMENT "A_DBM_DATABASE TO "database name"

Question: I keep receiving an error message saying that my login is invalid. But I'm sure I'm using the correct username and password.

Answer: All usernames, passwords, and database names are case sensitive. Be sure that you are typing the names exactly as they are set up.

Question: Are there any ACUCOBOL-GT library routines that do not work with or would not make sense to use with Acu4GL for DBMaker?

Answer: Yes. There are two ACUCOBOL-GT library routines that either don't work with or do not make sense to use with Acu4GL for DBMaker: C$COPY and RENAME.