MIAMEX 93: Get ABOUT info

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

(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]

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

(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. 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

(String)

[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.