The runtime system gracefully handles errors relating to shared code and license management. Refer to section 2.11 of the ACUCOBOL-GT User's Guide for information about shared memory errors.
If a new process exceeds the limits specified in a site's license file, the new process exits gracefully with a message, and all other runtime processes continue uninterrupted.
If acushare stops running or is stopped while networked processes are active, the product issues a warning message, to alert the user to restart acushare. If the product later detects that acushare has not been restarted, it exits.
If you have the runtime's warning messages enabled (see the WARNINGS configuration variable and the "-w" command line option), then certain errors will cause a warning message to be printed. These messages are:
"Shared memory and license manager (acushare) is not running"
This indicates either: (1) code sharing has been requested (with the
SHARED-CODE configuration entry), but cannot be implemented because the acushare memory manager is not currently running, or (2) a multiple-user license file
is in effect, and a runtime process cannot register itself with acushare because acushare is not running. The runtime process will exit.
"Timeout waiting for reply from acushare"
A connection has been made with acushare, but acushare did not respond to a request within 15 seconds. This typically indicates
that acushare has been killed. For sites having a multiple-user runtime license file
configuration, a new runtime process that cannot register itself with acushare will exit.
You can increase the length of time that an ACUCOBOL-GT process will wait for
a response from acushare for license file validation. To do this, set the environment variable
ACUSHARE_TIMEOUT to the number of seconds you want the process to wait. The default
is 15 seconds.
"Error sending message to acushare"
The system has returned an error of an unknown nature when it tried to send a
message to acushare. On a system with a multiple-user license file, a new process cannot
continue if it cannot register itself with acushare.
The following error messages indicate a serious problem detected by the license manager. These messages are:
"You have exceeded the licensed number of users for ACUCOBOL-GT. If you would
like to add users, please contact your customer service representative."
A new process cannot be registered with acushare, either because (1) the maximum number of users has already been reached on
the network, or (2) the maximum number of processes has been reached. The new
process will exit.
"License manager (acushare) is not running"
This is a one-time message warning you that the product will exit soon if acushare is not restarted immediately. It indicates that a multiple-user license file
is in effect, and the product has detected that acushare has been stopped and not restarted.
"The license manager (acushare) has been killed and restarted. You have
exceeded the licensed number of users for ACUCOBOL-GT. If you would like to add
users, please contact your Customer Service representative."
This message may follow the warning message listed immediately above. It
indicates that a process detected that acushare had been stopped and restarted, so the product attempted to re-register
itself. However, it could not register itself, either because (1) the maximum
number of users had already been reached on the system, or (2) the maximum number of
processes had been reached. The process will now exit.
Important: If there are no shared memory identifiers or message queue identifiers
available, acushare will abort and print one of these error messages:
"acushare: can not create shared memory"
"acushare: cannot create message queue"
These messages indicate that you do not have enough of the proper resource
(either shared memory or message queues) configured in your system. Either your
UNIX kernel does not have the resource configured, or all of the resource is in
use by other programs. In either case, you should regenerate your UNIX kernel
for more shared memory or message queues. Because license file management
requires shared memory, you must be able to execute acushare to qualify for a multiple-user license file.