Updated July 2022
VERSYS <wildspec> {switches}
VERSYS displays version and resource information, about a runnable A-Shell program, that relates to the environment in which it was created. Normal runnable program extensions are .RUN, .LIT and .SBX.
The file version shown in the examples below can also be gotten from the DIR/V command. But DIR/V cannot tell you the details about the ashell and cmdlin resource files, which were used to compile the copy of DIR. Periodically we update these resource files, which when used to re-generate the LIT commands, may create subtle differences which are not reflected in the version number.
VERSYS.LIT shows the program header flags, which indicate how the program was compiled and whether it is compatible with AMOS. Note that it cannot distinguish whether /A was used when compiling (although it can distinguish /AV, which implies /A), and it cannot tell between /X:1, /X:2 and /D, all of which show as /X and are incompatible with AMOS.
Switches
/CSV
creates VERSYS.CSV version of output
Example1
.VERSYS SYS:DIR.LIT
DIR.LIT -- A-Shell Version & System Information:
File Version: 1.5(125)
System Resource: ashell[74]
System Resource: cmdlin[24]: max devs = 300, max ppns = 512
Example2
.versys testsf
TESTSF.RUN -- A-Shell Version & System Information:
File Version: 1.0(100)
Program format: 0xF2F6 (compil/x?/av; requires A-Shell edit 1711+)
Program Size: 1,493,577
Object Code: 957,182
MAP Definitions: 516,264
Memory Required: 1,106,548
Auxiliary Blocks:
DynFunc Index: 14,861
Embedded Defstructs: 5,208
Defstruct Index: 32
Embedded Resources:
ashell.def[302]
ashell.sdf[103]
History
2023 February, A-Shell 6.5.1725, VERSYS.LIT 3.0(113): Refinement to recognize header signatures &hF202 (OCMPIL with minimum version) and &hF03 (COMPI with minimum version).
2023 February, A-Shell 6.5.1725, VERSYS.LIT 3.0(112): Add dynamic function index to the display.
2022 May, A-Shell 6.5.1716, VERSYS.LIT 3.0(110): The /CSV switch outputs all the display details to a CSV for a wildcard set of programs. .
2022 May, A-Shell 6.5.1715, VERSYS.LIT 3.0(109): The VERSYS display now includes many additional details about the specified program, memory requirements and the existence of embedded resources such as dynamic functions and embedded structure definitions.
2019 March, A-Shell 6.5.1657, VERSYS.LIT 3.0(108): Now recognizes the new header signature and reports the minimum A-Shell version needed to run the program. For example:
.VERSYS MYPROG.RUN
MYPROG.RUN -- A-Shell Version & System Information:
File Version: 1.0(100)
Program format: 0xF276 (compil/x?; requires A-Shell edit 1657+)
