Updated January 2016; see History
LICENS {/ATESRV}
LICENS provides the means to display your A-Shell license information, and to optionally update that information. Other methods of updating the license are to edit miame.ini directly, and to respond to the prompt which appears on startup if your license has expired.
When executed, LICENS displays information about the current license (similar to the ABOUT command), and asks if you want to update the license. It then prompts you for a new serial number, license key, and company name, verifies that they are correct, and asks if you want to save the updated information.
To display the license information, you may be logged into any account. To update the license, you must be logged into the OPR: account.
LICENS is also used to generate a license for ATE, the A-Shell Terminal Emulator. When updating the license, you will be asked whether you wish to update the license for A-Shell or ATE; select the appropriate one and proceed.
The /ATESRV switch, which is only applicable when using ATE, causes LICENS to request an ATE license from the server. You do not need to be logged in as OPR: when using the /ATESRV switch. Note that for ATE GUI terminal emulations—i.e. those ending in "G"—LICENS/ATESRV will be executed automatically when the client connects. As of A-Shell build 997.3, this is also true for all clients connecting as wyse50, am65, and am75 emulations. However, it does no harm to execute the command manually, and this is can be helpful in debugging if the server-issued licensing isn't working.)
For PC-based ATE licensing, the MAC address is automatically added to the company name if it is not done manually.
Note
If you came to this page wanting to update your license, only to find out that LICENS does not run, the problem is that your version of A-Shell predates LICENS (version 4.8, build 830, of 30 April 2003). To update the license, you will need to use the "Old Method" described in Updating the License. In brief, you will have to run A-Shell from the host prompt with the start-up switch -k (e.g. ashell -k), which will prompt you for license information. If you need to use this method, be advised that your version of A-Shell is no longer supported! You should update to a more recent version.
See Also:
History
2016 January, A-Shell 6.2.1425, LICENS.LIT 2.4(133): Changed PIC code format to XXXXXXX-XXXXXX-XXXXXX-XXXXXXX to allow various extensions and improved localization in A-Shell 6.3.
2015 May, A-Shell 6.1.1408, LICENS.LIT 2.4B(132): Updated routine to recognize and preserve a new unique identifer field in the JOBTBL. The new version is backward compatible with earlier versions of A-Shell and has a "B" in the version number to help easily identify it.
