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}
This function 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
prdname (String) [out]
will return the A-Shell platform-specific name, e.g. “A-Shell/Linux” or “A-Shell/Windows/32”.
version (String) [out]
will return the A-Shell version string, e.g. “Ver 4.7(825)”.
serial (Num) [out]
will return the serial number.
coname (String) [out]
will return the company name that the license was issued to.
key (String) [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 (String) [out]
will return a string of descriptive tokens identifying license options, such as “COM-XCALL”, “PolyShell”, etc.
expflags (Num) [out]
will return 0 to indicate the normal maintenance expiration, or 1 to indicate that the license has a runtime expiration (i.e. will stop running after the expiration date). A 16 or 17 indicates that the expiration date has passed.
reldate (String) [out]
will return the release date of the current executable (dd-mon-yyyy).
expdate (String) [out]
will return the maintenance or runtime expiration date of the license (dd-mon-yyyy).
inifile (String) [out]
will return the fully qualified native filespec of the miame.ini file.
jobtbl’fspec (String) [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 (String) [out]
will return the creation date (or last status change date) of the jobtbl.sys file (dd-mmn-yy) format.
jobtbl’ctime (String) [out]
will return the creation time (or last status change time) of the jobtbl.sys file (hh:mm) format.
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.