To start AcuConnect on restricted UNIX sites

For sites with a restricted user license, AcuConnect relies on acushare to monitor and enforce the site license. If you modified the root user's PATH environment variable to contain the directory where you installed AcuConnect (acucobol5xx/bin by default), then acushare starts automatically when required by AcuConnect. You can follow the instructions for an unrestricted site to start AcuConnect.

If you did not modify the root user's PATH variable, then you must start acushare manually before starting AcuConnect. To do this, change to the directory where you installed AcuConnect and issue the "acushare -start" command. On UNIX systems, acushare runs as a background server process that responds to requests from various runtimes. If desired you can include the following option:

acushare -start [ -e errorfile ]

Typically, you will want to have acushare automatically start each time you boot your system. To do so, add lines similar to the following to your system startup file:

  if [ -f /acucobol5xx/bin/acushare ]; then
     echo Starting acuconnect shared-code and license daemon > /dev/console
     /acucobol5xx/bin/acushare -start > /dev/console
  fi

This assumes that you have placed acushare in "acucobol5xx/bin". You may need to adjust these sample lines to match the conventions used by your machine.

Once you have acushare running or accessible to your system, you can issue the "acuconnect -start" command as described in the previous section.

Note: There is usually no reason to stop acushare. In fact, you are advised not to kill acushare with conventional methods. You should halt acushare only with its own "-kill" option or with the UNIX "kill -9" command. The "-kill" option is highly recommended because it causes acushare to perform an orderly shutdown, so you avoid manual cleanup. The only time "kill -9" can be used safely is during system shutdown.

If you kill acushare with "kill -9", then you have a disorderly shutdown, and you will need to manually clean up shared memory and the message queues. You can do this with the UNIX utility "ipcrm". Use "ipcs" and acushare's key, "0x01DCF4C9", to determine acushare's id number (id#) in the message queue and in the shared memory queue. Then type the command "ipcrm -q id#" to clear the message queue, and then "ipcrm -m id#" to clear the memory queue.