Release notes and installation guide for OS/2

• OS/2 installation
• OS/2 foreign language interface
• OS/2 Emacs Interface
• OS/2 limitations

This chapter assumes that the environment variable PATH includes %SP_PATH%\bin, where SP_PATH points to the SICStus installation directory.

Installation

The file `sp3os2.zip' contains the binary distribution. To install:

% unzip sp3os2.zip

This creates the directory sicstus3. The development system provides command line editing; see section Command line editing. To install runtime system components:

% unzip sp3os2r.zip

SICStus Prolog requires a license code to run. This is installed by typing the commands below. You should have received from SICS values for Site, ExpirationDate and Code:

% splm -i Site
% splm -a sicstus3.7 ExpirationDate Code

Foreign language interface

Linked foreign resources come in two flavors, static and dynamic.

Static linked foreign resources are static libraries on OS/2 (.lib files). These are not portable between different C-compiler environments. Static linked foreign resources are used for building statically linked runtime and development systems.

Dynamic linked foreign resources are DLLs on OS/2. They are C-compiler independent but must use the syscall calling convention.

Linked foreign resources may be created using the command splfr as described in the manual. This command invokes C-compiler and linker through the scripts `spcc.cmd' and `spld.cmd'. These scripts are configured by default for the GCC/EMX compiler. The distribution also includes alternative scripts:

• `spcc.o2e', `spld.o2e' for GCC/EMX
• `spcc.o2w', `spld.o2w' for Watcom 10.6
• `spcc.o2i', `spld.o2i' for IBM Visual Age C++ v3.0

Runtime systems and customized development systems may be created using the commands spmkrs and spmkds respectively. These commands too use the scripts `spcc.cmd' and `spld.cmd'. Customized development systems require the static library `$SP_PATH\bin\sicstus.lib' while runtime systems require `$SP_PATH\..\sprt37.dll' at runtime.

Customized development systems also require `$SP_PATH\..\spds37.dll' at runtime. Import libraries for these DLLs are easily created for EMX:

% emximp -o rtimpemx.lib sprt37.dll
% emximp -o dsimpemx.lib spds37.dll

or for Watcom:

% wlib rtimpwat.lib +sprt.dll
% wlib dsimpwat.lib +spds37.dll

The names of these .libs are assumed in respective spld.

Emacs Interface

Using Emacs 19.30 for OS/2, interrupting by C-c C-c (or from menu) does not seem to work. Choosing EOF from menu seems to generate an eternal EOF which is not useful for e.g. escaping a break level. Instead a C-d can be generated by typing C-q C-d.

Limitations

• File paths with both / and \ as separator are accepted. SICStus returns paths using /. Note that \, since it is escape character, must be given as \\ unless the prolog flag character_escapes is set to off.
• All file names and paths are converted to lowercase when expanded by absolute_file_name/2 etc.
• File paths of the form ~/ are expanded using the values of the environment variable HOME. The form ~username/ is not expanded. The form $VAR/ is expanded using the value of the environment variable VAR. The form %VAR%/ is not recognized.
• Running under Emacs has been tried with GNU-Emacs v.19.30. See above.
• No Tcl/Tk interface.
• stream_select/3 is not supported.
• stream_interrupt/3 is not supported.
• library(timeout) is not supported.
• library(sockets) is not supported.
• library(system): kill/2 attempts to terminate the requested process irrespectively of the 2nd arg.

Go to the first, previous, next, last section, table of contents.