Updated February 2017; see History
xcall MIAMEX, MX_ABOUT, prdname, version, serial, coname, key, licnodes, phynodes, lognodes, licoptions, expflags, reldate, expdate, inifile {,jobtbl'fspec, jobtbl'inode, jobtbl'cdate, jobtbl'ctime}
MX_ABOUT retrieves several pieces of information relating to the current license and environment. It is mainly used by ABOUT.LIT, but might be useful within in application to check for maintenance expiration, number of licensed users, etc. A quick look at the output of ABOUT.LIT will answer many questions about the parameter output.
Parameters
Parameter |
Type |
I/O |
Description |
prdname |
[out] |
will return the A-Shell platform-specific name, e.g. "A-Shell/Linux" or "A-Shell/Windows/32". | |
version |
[out] |
will return the A-Shell version string, e.g. "Ver 4.7(825)". | |
serial |
(Num) |
[out] |
will return the serial number. |
coname |
[out] |
will return the company name that the license was issued to. | |
key |
[out] |
will return the license key (aka PIC code). | |
licnodes |
(Num) |
[out] |
will return the maximum number of nodes licensed. |
phynodes |
(Num) |
[out] |
will return the current number of physical nodes in use. |
lognodes |
(Num) |
[out] |
will return the current number of logical nodes in use. (The logical node count should count each job, whereas the physical count may be less if multiple jobs are identified as being connected with the same session or are running in background.) |
licoptions |
[out] |
will return a string of descriptive tokens identifying license options, such as "COM-XCALL", "PolyShell", etc. | |
expflags |
(Num) |
[out] |
Returns indication of the license status combined with a flag indicating whether there is a runtime (vs. maintenance) expiration. See EF_xxx flags in ashell.def, reproduced below. |
reldate |
[out] |
will return the release date of the current executable (dd-mon-yyyy). | |
expdate |
[out] |
will return the maintenance or runtime expiration date of the license (dd-mon-yyyy). | |
inifile |
[out] |
will return the fully qualified native filespec of miame.ini. | |
jobtbl’fspec |
[out] |
will return the fully qualified native filespec of the jobtbl.sys file. | |
jobtbl’inode |
(Num) |
[out] |
will return the inode of the jobtbl.sys file. (Applies to UNIX only; will be set to 0 under Windows.) |
jobtbl’cdate |
[out] |
will return the creation date (or last status change date) of the jobtbl.sys file (dd-mmn-yy) format. Note that under UNIX, the "c date" will be updated by any change to the privileges or ownership of the file, so it may not reliably indicate the actual creation time. | |
jobtbl’ctime |
[out] |
will return the creation time (or last status change time) of the jobtbl.sys file (hh:mm) format. |
EF_xxx Flags
Symbol |
Value |
Description |
EF_NORMAL |
0 |
license good |
EF_DEMO |
1 |
demo mode |
EF_BADKEY |
2 |
bad key |
EF_BADCO |
3 |
bad company |
EF_BADOS |
6 |
bad os |
EF_EXPIRED |
7 |
expired runtime |
EF_EXPIRED_EXE |
8 |
expired maint |
EF_ATSD |
10 |
ATSD not licensed |
EF_BADMAC |
12 |
MAC address not valid |
EF_SERIAL |
13 |
serial # out of range |
EF_BADKEYFMT |
14 |
bad key format |
EF_BADKEYVER |
15 |
bad key version |
The following bit is independent of those above | ||
EF_RUNTIME |
&h020 |
runtime expiration, else maint |
History
2017 February, A-Shell 6.3.1544: Updated expflags. Previously, it returned only 0 (maintenance) or 1 (runtime), plus 16 to indicate expired.