/STACKOS2

Syntax: /STACKOS2:nnnn

This option sets the size of the stack in the OS/2 header. The field nnnn contains the stack size in bytes. This option is equivalent to the Control Stack Size (/ST) (in LINK386 Help). OS/2 16-bit NE modules have a maximum stack size of 65,535. OS/2 32-bit LX modules have a maximum stack size of 4,294,967,295. The /STACKOS2 only changes the OS/2 header and has no effect on the DOS stub in the same module.

You can specify nnnn in decimal, hexadecimal, or octal radix using standard C language notation. For instance, an OS/2 stack size of 32,768 bytes can be expressed as any of the following:

• STACKOS2:32768

• STACKOS2:0x8000

• STACKOS2:0100000

Compare to /STACKDOS.

DO NOT USE /STACK

There is an old EXEHDR option /STACK that performed a function similar to /STACKDOS and /STACKOS2 combined. The /STACK option has serious limitations and has the potential to corrupt the header of an executable module. It it very strongly recommended that you do not use /STACK, and begin using /STACKDOS and /STACKOS2 instead.

• For a DOS-only application, the /STACK option will work correctly.

• For a 32-bit OS/2 application, the /STACK option will only change the stack value in the header of the DOS stub; it will not modify the OS/2 header, which is what the user may have intended.

• For a 16-bit OS/2 application, the /STACK option will attempt to change both the DOS stub and OS/2 application stack values to the same nnnn value. This can lead to application failures. The headers of the DOS stub and the OS/2 application should therefore be modified independently of each other using the /STACKDOS and /STACKOS2 options.