The complete package consists of the following parts, some or all of which may need to be downloaded/installed manually:
External library: The low-level code is packaged as a single external library file, which can be downloaded manually from the MicroSabio LibXL download directory.
For Windows, the file is libxl.dll, and can be just dropping in the A-Shell bin directory (where the ashw32.exe file is).
For Unix, the file is libxl.so.#.#.#.xxx, which can also be dropped into the A-Shell bin directory (where the ashell executable is). Then you must create a symbolic link to it named /usr/lib/libxl.so.1, e.g.:
$ sudo ln -s /vm/miame/bin/libxl.so.3.7.2.lnx /usr/lib/libxl.so.1
You can test that the library itself has all of its prerequisites with the ldd command:
$ ldd /usr/lib/libxl.so.1
linux-gate.so.1 => (0x00818000)
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x00279000)
libm.so.6 => /lib/libm.so.6 (0x00161000)
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x003c3000)
libc.so.6 => /lib/libc.so.6 (0x00506000)
/lib/ld-linux.so.2 (0x004e9000)
LIBXL: ersatz directory: define an ersatz device LIBXL: which points to the directory where you install the LIBXL API files. This directory is typically [908,68], and is included (as [908,68]) in the MicroSabio EXLIB Repository. You might as well just download the entire library, updating the existing one you may already have installed.
SOSFUNC: and ASHINC: Several files in these standard ersatz directories, typically [907,10] and [907,16] are used by the LibXL module and almost certainly require updating. Since they are both part of the MicroSabio SOSLIB Repository, the easiest way to satisfy this requirement is to download/update the entire set of [907,xxx] directories.
A-Shell 6.3.15xx: LibXL absolutely requires 6.3 as a minimum.
Compiler edit 793: If using APN, you should ideally have the 793 (or later) version of the standalone compiler. You’ll also need to update your compil command line in APN to include the -p or -px switch (see next section for details).
Having completed the above, you should be able to compile and run one of the sample programs, e.g.
.LOG LIBXL:
.COMPIL TSTACB/X:2/M/P
.RUN TSTACB
