3.2.2.1 Creating remote object libraries

If AcuServer or AcuLaunch is running on a remote machine, cblutil can read remote objects and write a remote library. The syntax rules that apply to specifying remote object libraries with cblutil are the same as those for compiling to remote object libraries with the compiler. See section 2.1.13.1, "Remote file name handling", for details.

This capability gives you the option to create a remote library from local object files or to create a local or remote library from remote object files.

Note: With cblutil, you can also use the regular AcuServer syntax for referring to the remote files. This syntax is not allowed with the compiler because the "@" is reserved for another purpose. See AcuServer User's Guide, section 7.2 "Accessing Remote Files" for details.

Note: You cannot use wildcard characters to create a library from a collection of remote object files.

Note: In the process of creating a remote library, cblutil overwrites the named library at the beginning of the operation. Then if something fails during the process, the library is removed. For that reason, you may consider creating a backup copy of the named library before executing the build library command. (Incidentally, when creating a local library, cblutil creates a temporary library first, and only after the library has been successfully compiled does the (existing) named library get removed and replaced by the new library.)

Examples:

The following command creates a library in /myapp/obj on the UNIX server myserver called "myapp.lib" from all the .acu files in the current directory.

cblutil -lib -o acurfap://myserver::/myapp/obj/myapp.lib *.acu

where acurfap stands for "Acu Remote File Access Protocol". The following command creates a library in /myapp/obj on the Windows server myserver where AcuServer is listening on port 6543. The library is named "myapp.lib". The files used to create the library are all in /myapp/obj on myserver. Because you cannot use wildcard characters, you need to list each file.

cblutil -lib -o 
   acurfap://myserver:6543:c:/myapp/obj/myapp.lib \
      acurfap://myserver:6543:/myapp/obj/test1.acu \
      acurfap://myserver:6543:/myapp/obj/test2.acu \
      acurfap://myserver:6543:/myapp/obj/test3.acu \
      acurfap://myserver:6543:/myapp/obj/test4.acu

Note: Using the backslashes ("\") as continuation characters works for UNIX only. If you are entering a command for Windows, you must type the entire command as a continuous string.