Problem:
If you are trying to control the licensing errors that your application may return in a shell script, you may have realized that, for example, the following license error
ASLM: License database has been moved
returns a return code of 4.
Resolution:
The codes for the ASLM error messages that are in the documentation - Application Server > Help Topics > Licensing Error messages - should correspond to the return codes.
Not all possible messages are documented here so for the complete list please see below.
Messages 17, 23 and 24 are appended by text from the multipart message, whose numbers are 48, 49,50, giving a user level summary of what this means (so you should get a return code of 17, 23 or 24). In the same way, when you get a return code 28, messages 28, 29, 30, 31, 32 and 33 are shown...
0001 "ASLM: License database does not exist"
0002 "ASLM: No license database header"
0003 "ASLM: Error opening License database"
0004 "ASLM: License database has been moved"
0005 "ASLM: License database checksum failure"
0010 "ASLM: Unable to create pvc shm"
0011 "ASLM: shm index full"
0012 "ASLM: shm index header checksum fail"
0013 "ASLM: shm index record checksum fail"
0014 "ASLM: sysfile open fail"
0015 "ASLM: Bad sysfile"
0016 "ASLM: This boot time already recorded"
0017 "shm (index) missing"
0018 "ASLM: You need to rerun as root"
0019 "ASLM: Can't create index shm"
0020 "ASLM: shm index attach fail"
0021 "ASLM: shm open fail"
0022 "ASLM: shm attach fail"
0023 "ASLM: shm (pvc) attach fail"
0024 "ASLM: shm (pvc) content fail"
0025 "ASLM: shm control fail"
0026 "No CGI Application Server License available: %d installed %d in use"
0027 "No Application Server License available: %d installed %d in use"
The following messages form a single group.
0028 "All %d Application Server Licenses are in use"
0029 "You should order additional Application Server licenses if you require"
0030 "more users to be able to run this application."
0031 "You may continue for a temporary period to allow you time to order"
0032 "additional licenses."
0033 "Please wait..."
0034 "ASLM: Environment variable COBDIR not set, or inadequate permissions"
0035 "ASLM: cwd not detectable"
0036 "ASLM: Security failure checking ASSIG file"
0038 "Content-type: text/html"
0039 ""
0040 "<HTML><HEAD><TITLE>CGI Application Server status</TITLE></HEAD>"
0041 "<BODY><H1>CGI Application Server status</H1>"
0042 "</BODY></HTML>"
0043 "ASLM: COBOL execution would cause infinite loop"
0044 "ASLM: Semaphore failure. Rerun as root"
0045 "No Application Server License available:"
0046 "%d system and %d user license installed %d in use"
0047 "ASLM: Errno %d"
The following message appends previous messages 17, 23, 24 (Due to Misuse...)
0048 "ASLM: A shared memory area used by Apptrack licensing has been corrupted"
0049 "or deleted, and your system will need to be rebooted before this"
0050 "application can run."
0051 "\\nA lapsed time-limited developer license is installed."
0052 "To reactivate this license, first uninstall it, then reinstall again."
0053 "Error - No license key detected. Application Server requires"
0054 "a license key in order to execute."
0055 "Please refer to your application supplier."
0056 "Net Express Application Server will require a license key to run from"
0057 "2nd December 2002. If your application is not enabled with a key by this"
0058 "date, it will cease to run."
0059 "Run Apptrack to suppress this message until closer to 2nd December 2002"
0060 "30 Day Warning"
0061 "Urgent - 10 Day Warning"
0062 "ATTENTION - %d day Warning"
0063 "No Application Server License available at COBDIR location:"
0064 "A summary of all installed licenses can be found by running Apptrack"
0065 "Overdraft Error"
