Manual de programación de OS/2/Llamadas DOSxxx para multitarea

DosCreateThread

DosCreateThread crea un nuevo Thread asíncrono. El código especificado empieza su ejecución de forma paralela al código que ejecutó la instrucción. En el caso del EMX, debe usarse la función _beginthread(), a menos que el código no haga llamadas a funciones estandar de C. Ver la documentación del compilador.

'#define INCL_BASE
'#include <os2.h>

PTID ptidThreadID;
PFNTHREAD pThreadAddr;
ULONG ulThreadArg;
ULONG ulThreadFlags;
ULONG ulStackSize;
APIRET rc; /* Codigo de error */

rc = DosCreateThread(ptidThreadID, pThreadAddr, ulThreadArg, ulThreadFlags, ulStackSize);

Parámetros

ptidThreadID	Un puntero donde OS/2 devuelve el identificador del thread creado.
pThreadAddr	Un puntero a la rutina a ser ejecutada por el nuevo thread. Esta función admite un parámetro ThreadArg y retorna una doble palabra al terminar. El retorno desde la función con DosExit hace que el thread finalice.
ulThreadArg	Un argumento que es pasado a la rutina del thread como un parámetro. Normalmente es un puntero a un bloque de parámetros.
ulThreadFlags	Si el bit 0 está puesto a cero, el nuevo thread comienza inmediatamente. Si está puesto a uno, queda dormido, y el creador del thread tiene que usar DosResumeThread para que empiece la ejecución. El resto de bits debe estar a cero.
ulStackSize	La longitud, en bytes, de la pila del nuevo thread. El tamaño es redondeado a un número completo de páginas, o bien a 2 páginas si el tamaño es menor.

Codigos de error

0 Sin error
8 No hay suficiente memoria
95 Interrupción
115 Violación de protección
164 No se pueden crear más threads

DosEnterCritSec

DosEnterCritSec duerme todos los threads pertenecientes al proceso actual excepto el que realiza la llamada. Puede ser útil para casos en los que se quiera sincronizar accesos muy esporádicos, sin tener que usar semáforos.

'#define INCL_BASE
'#include <os2.h>

APIRET rc; /* Codigo de error */

rc = DosEnterCritSec();

Codigos de error

0 Sin error
309 Identificador de Thread no válido
484 Desbordamiento de CritSec

DosExecPgm

DosExecPgm permite a un programa ejecutar a otro como un proceso hijo.

'#define INCL_BASE
'#include <os2.h>

PCHAR pObjNameBuf;
LONG lObjNameBufL;
ULONG ulExecFlags;
PSZ pszArgPointer;
PSZ pszEnvPointer;
PRESULTCODES pReturnCodes;
PSZ pszPgmPointer;
APIRET rc; /* Codigo de error */

rc = DosExecPgm(pObjNameBuf, lObjNameBufL, ulExecFlags, pszArgPointer, pszEnvPointer, pReturnCodes, pszPgmPointer);

Parámetros

pObjNameBuf	Puntero a un buffer donde OS/2 devuelve el nombre del objeto que ha contribuido al fallo de DosExecPgm.
lObjNameBufL	Longitud en bytes del buffer ObjNameBuf
ulExecFlags	Indica como se debe ejecutar el programa, según los valores siguientes: 0 (EXEC_SYNC): La ejecuci&oacutE;n es síncrona con el proceso padre (éste queda dormido hasta que el proceso hijo ha terminado de ejecutarse). El código de terminación es almacenado en las dos dobles palabras apuntadas por ReturnCodes. 1 (EXEC_ASYNC): La ejecución es asíncrona. Cuando el proceso hijo termina, el código de terminación es descartado. El PID es almacenado en la primera doble palabra apuntada por ReturnCodes. 2 (EXEC_ASYNCRESULT): La ejecución es asíncrona. Cuando el proceso hijo termina, su codigo de terminación es almacenado para ser examinado posteriormente con DosWaitChild. El PID es almacenado el la primera doble palabra apuntada por ReturnCodes. 3 (EXEC_TRACE): La ejecución es igual que en el caso 2, pero con las condiciones de debugging para el proceso hijo. 4 (EXEC_BACKGROUND): La ejecución es asincrona, y se efectua como una sesión sin pantalla ni teclado (detached). Cuando el proceso hijo empieza, no se ve afectado por el fin del proceso padre, sino que es tratado como un proceso huerfano. Un programa ejecutado de esta forma funciona siempre en background, y no puede pedir ninguna entrada de teclado o salida por pantalla, aparte de VioPopups. No puede ejecutar ninguna entrada o salida de consola (VIO, KBD o MOU). 5 (EXEC_LOAD): El programa es cargado y preparado, pero no se ejecuta hasta que el gestor se sesiones despacha el último thread del proceso. 6 (EXEC_ASYNCRESULTDB): La ejecución es igual que en el caso 2, con el añadido de las condiciones de debugging para el proceso hijo y todos sus descendientes. De esta forma, es posible trazar procesos síncronos y detached.
pszArgPointer	Puntero de las cadenas pasadas al programa. Representan los parametros del programa, que son copiados al segmento de entorno del nuevo proceso. La convención usada por CMD.EXE es que el primer string es el nombre del programa, y el segundo son los parametros. Un valor de cero indica que no hay parámetros para el programa.
pszEnvPointer	Puntero a las variables de entorno pasadas al programa. Estos strings representan variables de entorno y sus valores actuales.
pReturnCodes	Puntero a una estructura de dos dobles palabras donde el PID o el código de terminación es almacenado. Tiene dos zonas, a saber: termcodepid Para una petición asíncrona, contiene el PID del proceso hijo. Para una petición síncrona, el codigo de terminación describe por qué terminó el hijo. Los valores son: Valor Definicion 0 Salida normal 1 Error grave 2 El proceso genero un trap 3 Se mato el proceso con DosKillProcess 4 El proceso genero una excepción resultcode Codigo de terminacion especificado en DosExit
pszPgmPointer	Puntero al nombre del fichero que contiene el programa a ser ejecutado.

Codigos de error

0 Sin error
1 Función no válida
2 Fichero no encontrado
3 Path no encontrado
4 Demasiados archivos abiertos
5 Acceso denegado
8 No hay suficiente memoria
10 Entorno no válido
11 Formato no válido
13 Datos no válidos
26 Disco sin sistema de ficheros
32 Violación de compartición
33 Violación del bloqueo
36 Desbordamiento del buffer de compartición
89 Sin slots de procs
95 Interrupción
108 Unidad bloqueada
127 Proc no encontrado
182 Ordinal no válido
190 Tipo de módulo no válido
191 Signatura de EXE no válida
192 Marca de EXE no válida
195 MINALLOCSIZE no válido
196 Enlace dinámico pedido desde un anillo no válido

DosExit

DosExit suele ser llamada cuando un thread termina.

'#define INCL_BASE
'#include <os2.h>

ULONG ulActionCode;
ULONG ulResultCode;

DosExit(ulActionCode, ulResultCode);

Parámetros

ulActionCode	Determina si se termina solo el thread actual, o todos los threads del proceso. Los valores posibles son: 0: (EXIT_THREAD) el thread actual termina. 1: (EXIT_PROCESS) todos los threads del proceso terminan.
ulResutlCode	Un valor que es pasado a cualquier thread que halla ejecutado un DosWaitChild para este proceso.

DosExitCritSec

DosExitCritSec restaura el funcionamiento normal de todos los threads de un proceso, después de la ejecución de un DosEnterCritSec.

'#define INCL_BASE

'#include <os2.h>

APIRET rc; /* Codigo de error */

rc = DosExitCritSec();

Codigos de error

0 Sin error
309 Identificador de Thread no válido
485 Underflow de CritSec (se ha intentado ejecutar más Exits que Enters).

DosKillProcess

DosKillProcess marca un proceso para ser finalizado, y devuelva el código de terminación a su padre (si lo tiene).

'#define INCL_BASE
'#include <os2.h>

ULONG ulActionCode;
PID idProcessID;
APIRET rc; /* Codigo de error */

rc = DosKillProcess(ulActionCode, idProcessID);

Parámetros

ulActionCode

Los procesos que deben ser marcados para ser finalizados. El valor puede ser uno de los siguientes: Valor Definición 0 (DKP_PROCESSTREE) El proceso y todos sus procesos descendientes. El proceso tiene que ser el actual, o bien haber sido creado directamente por el proceso actual usando DosExecPgm con un valor de 2 (EXEC_ASYNCRESULT) en ExecFlags. 1 (DKP_PROCESS) un solo proceso. Solo el proceso indicado es marcado para ser finalizado.

idProcessID

El PID del proceso a ser marcado.

Codigos de error

0 Sin error
13 Datos no válidos
217 Procesos Zombie
303 PID no válido
305 No hay descendientes

DosKillThread

DosKillThread mata un thread del proceso actual. Si se mata al thread 1, todo el proceso muere. Si el thread a matar tiene código de 16 bits o ha sido creado por una llamada de 16 bits, se devuelve el error Ocupado.

'#define INCL_BASE
'#include <os2.h>

TID idThreadID;
APIRET rc; /* Codigo de error */

rc = DosKillThread(idThreadID);

Parámetros

idThreadID Identificador del thread a matar.

Codigos de error

0 Sin error 170 Ocupado 309 Identificador de Thread no válido

DosResumeThread

DosResumeThread arranca un thread que fue parado previamente con DosSuspendThread.

'#define INCL_BASE
'#include <os2.h>

TID idThreadID;
APIRET rc; /* Codigo de error */

rc = DosResumeThread(idThreadID);

Parámetros

PID del thread

Codigos de error

0 Sin error 90 El thread no estaba parado 309 Identificador de Thread no válido

DosSetPriority

DosSetPriority cambia la prioridad del thread o de un proceso hijo.

'#define INCL_BASE
'#include <os2.h>

ULONG ulScope;
ULONG ulPriorityClass;
LONG lPriorityDelta;
ULONG ulID;
APIRET rc; /* Codigo de error */

rc = DosSetPriority(ulScope, ulPriorityClass, lPriorityDelta, ulID);

Parámetros

ulScope	A quien afecta el cambio de prioridad Valor Definición 0 (PRTYS_PROCESS) Todos los threads de un proceso. 1 (PRTYS_PROCESSTREE) Todos los threads de un proceso y todos sus descendientes. El proceso indicado tiene que ser el actual o uno creado por el actual mediante DosExecPgm. 2 ((PRTYS_THREAD) un thread del proceso actual
ulPriorityClass	Tipo de prioridad. El valor puede ser: Valor Definición 0 (PRTYC_NOCHANGE) No se cambia. 1 (PRTYC_IDLETIME) Desocupado (Idle-time) 2 (PRTYC_REGULAR) Medio o regular 3 (PRTYC_TIMECRITICAL) Crítico 4 (PRTYC_FOREGROUNDSERVER) Primer plano lPriorityDelta Cambia el subnivel dentro del nivel actual de prioridad del proceso. Este valor debe ser un valor desde -31 (PRTYD_MINIMUM) hasta +31 (PRTYD_MAXIMUM).
ulID	Un identificador de proceso (Scope = 0 o 1) o un identificador de thread (Scope = 2). Si este operando es igual a cero, se asume el proceso o thread actual.

Codigos de error

0 Sin error
303 PID no válido
304 PDELTA no válido
305 No hay descendientes
307 PCLASS no válido
308 SCOPE no válido
309 Identificador de Thread no válido

DosSuspendThread

DosSuspendThread suspende temporalmente la ejecución de otro thread del proceso actual, hasta que se ejecuta un DosResumeThread.

'#define INCL_BASE '#include <os2.h>

TID idThreadID;
APIRET rc; /* Codigo de error */

rc = DosSuspendThread(idThreadID);

Parámetros

idThreadID PID del thread que debe ser suspendido.

Codigos de error

0 Sin error
309 Identificador de Thread no válido

DosWaitThread

DosWaitThread suspende el thread actual hasta que otro thread termine. Devuelve el PID del thread que ha terminado.

"#define INCL_BASE
"#include <os2.h>

PTID ptidThreadID;
ULONG ulWaitOption;
APIRET rc; /* Codigo de error */

rc = DosWaitThread(ptidThreadID, ulWaitOption);

Parámetros

ptidThreadID	Antes de llamar la función, debe contener un puntero al ThreadID del thread que interese. Si es cero, el thread actual espera hasta que un thread cualquiera del proceso actual termine. Si no es cero, espera hasta que ese thread concreto acabe. Al volver, apunta al ThreadID (TID) del thread que ha terminado (util cuando se ha especificado cero en la entrada).
ulWaitOption	Indica cuando debe retornar: Valor Definición 0 DCWW_WAIT) El thread actual espera hasta que un thread acabe. Si un thread ya había acabado, retorna inmediatamente con el ThreadID.) 1 (DCWW_NOWAIT) El thread actual no espera si no ha terminado ningún thread. Mediante el mensaje de error se puede saber si ya ha terminado o no.

Codigos de error

0 Sin error
95 Interrupción
294 Thread no terminado
309 Identificador de Thread no válido