Return to readme CVS log

Up to [OS/2 SDKs] / os2sdk

Microsoft OS/2 SDK 03-01-1988

C-Language Header Files for MS OS/2
===================================

The MS OS/2 C-language header files contain the definitions you need to
use the functions, data types, structures, and constants described in the
Microsoft Operating System/2 Programmer's Reference. 

When you include the OS2.H file, the C preprocessor automatically defines
many, but not all, of the most commonly used MS OS/2 functions. The OS2.H
header file is the first file of a set of files that contains the MS OS/2
function definitions. Each file contains definitions for the functions,
data types, structures, and constants associated with a specific group of
MS OS/2 functions. To minimize the time required to process the many
header files, each function group is conditionally processed depending on
whether a corresponding constant is defined within the program source
file. The following is a list of these constants with descriptions of the
function groups they represent: 

Constant Meaning
INCL_BASE		Includes all MS OS/2 1.0 system function 
			definitions. 
INCL_DOS		Includes all MS OS/2 1.0 kernel function 
			definitions (Dos). 
INCL_SUB		Includes all MS OS/2 1.0 video, keyboard, 
			and mouse functions (Vio, Kbd, and Mou). 
INCL_DOSDATETIME	Includes all date/time and timer functions. 
INCL_DOSDEVICES		Includes the device and IOPL support functions. 
INCL_DOSERRORS		Includes the MS OS/2 error constants. 
INCL_DOSFILEMGR		Includes all file-management functions. 
INCL_DOSINFOSEG		Includes all information-segment functions. 
INCL_DOSMEMMGR		Includes all memory-management functions. 
INCL_DOSMISC		Includes miscellaneous functions.
INCL_DOSMODULEMGR	Includes all module-manager functions. 
INCL_DOSMONITORS	Includes all monitor functions. 
INCL_DOSNLS		Includes national-language-support functions. 
INCL_DOSPROCESS		Includes all process- and thread-support functions. 
INCL_DOSQUEUES		Includes all queue functions. 
INCL_DOSRESOURCES	Includes resource-support functions (not
			available in MS OS/2 1.0). 
INCL_DOSSEMAPHORES	Includes all semaphore functions. 
INCL_DOSSESMGR		Includes all session-manager functions. 
INCL_DOSSIGNALS		Includes all signal functions. 
INCL_NOCOMMON		Excludes any function group not explicitly defined. 

To use a function within your program function, you simply define the
corresponding constant by using the #define directive before including the
OS2.H file. 



C-Language Library Files for MS OS/2
====================================

The MS OS/2 C-language Run-Time Libraries contain the necessary code to
make your C program an OS/2 executable, including run-time routines such
as "printf()" which you may have used in your program.	The example
programs in this toolkit assume that you have Microsoft C 5.10 and that
you have run its SETUP program to install libraries for MS-DOS (real-mode)
as well as MS OS/2 (protected-mode).  If you have done this, you will have
run-time libraries named SLIBCEP.LIB, LLIBCEP.LIB, etc.  This is what this
toolkit expects.  If you have told MS C 5.10 SETUP that you wish to write
only Protected Mode programs, it will have created the protected mode
libraries (required by this toolkit) using the names SLIBCE.LIB, LLIBCE.LIB,
etc., instead of SLIBCEP.LIB, LLIBCEP.LIB, etc.  In this case, you will have
to rename those libraries from SLIBCE.LIB to SLIBCEP.LIB, etc. in order for
the makefiles in this toolkit to work.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.