DosSMStart

Legacy Function Warning
It is recommended to use a newer replacement for this function.
Replacement:
Remarks:	This page list the older version of the function for reference.

This allows the shell to start a new session. This can only be called by the shell that owns the session manager. I am not sure about the parameter 'type': this seems to be missing in some cases.

Syntax

APIRET16 Pascal far DOSSMSTART(short flag,short mode,short type, char far* null1,
                               char far* null2, char far* args, short* sessid, long unknown)

Parameters

flag

save parent session

   =0, yes
   =1, no 

mode

   =0, start in foreground
   =1, start in background 

type

   =0, normal session
   =1, vio session
   =2, windowed session
   =3, VDM session 

null1

must be null

null2

must be null

args

program arguments

sessid

the newly generated session id is returned

unknown

?