home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / startapp.zip / readme.1st < prev    next >
Text File  |  2002-07-16  |  3KB  |  92 lines
  1. StartApp - Start Application Sample Code.
  2.  
  3. DESCRIPTION:
  4.  This sample provides source code and executables that demonstrate
  5.  the capability to start WINOS2 sessions and an application to
  6.  run in that session from a PM application.  It also demonstrates
  7.  that this session (and any application running in that session)
  8.  can be terminated by the PM application that started it.
  9.  
  10.  The implementation is by the usage of the WinStartApp API.  The
  11.  heart of this implementation can be found in the source file
  12.  SAPP.C.  Note, the sample also features in USER.C, the ability
  13.  to identify when the started session was ended by some other
  14.  process.  This is done by intercepting the WM_APPTERMINATENOTIFY
  15.  message.
  16.  
  17.  Assumptions:
  18.    Sample assumes that the WINOS2 component of Warp is installed.
  19.  
  20.    Sample assumes that the operating system is installed on the C
  21.    drive for specifying the startup directory path in the program
  22.    details structure.  See User_pszStartupDir in SAPP.C
  23.  
  24. TASK:
  25.  
  26.  Start a VDM session/application from a PM application.
  27.  
  28. HOW TO RUN THE SAMPLE:
  29.  
  30. -From an OS/2 command prompt: START STARTAPP.EXE
  31.  
  32. SOFTWARE/HARDWARE PREREQUISITES:
  33.  
  34. - IBM VisualAge C++ (for compiling)
  35. - OS/2 Warp
  36. - IBM or compatible 386 and up.
  37.  
  38. BUILDING:
  39.   This sample was created in VisualAge C++ and may be used in
  40.   a project template.  A makefile, startapp.mak, has been provided
  41.   to use with the NMAKE utility.
  42.  
  43. REQUIRED FILES      DESCRIPTIONS
  44.  
  45.   dlg.c             Sample dialog procedure
  46.   dlg.h
  47.   help.c            Routines to interface with the Help Manager
  48.   help.h
  49.   help.ipf
  50.   help.rc
  51.   init.c            Initialization routines
  52.   main.c            main() entry point
  53.   main.h
  54.   main.ico
  55.   main.rc           resource compiler input
  56.   main.res
  57.   sapp.c            Heart of the StartApp program
  58.   pnt.c             Window painting routines
  59.   prodinfo.bmp
  60.   readme            this file
  61.   user.c            User message response routines
  62.   xtrn.h
  63.   startapp.def      module definition file
  64.   startapp.dlg      product information dialog
  65.   startapp.exe      executable
  66.   startapp.hlp      help file
  67.   startapp.ipf      help source
  68.   startapp.mak      makefile
  69.   startapp.inc      compile and link information
  70.  
  71.  
  72.  (c) Copyright IBM Corp. 1998  All rights reserved.
  73.  
  74.  These sample programs are owned by International Business Machines
  75.  Corporation or one of its subsidiaries ("IBM") and are copyrighted and
  76.  licensed, not sold.
  77.  
  78.  You may copy, modify, and distribute these sample programs in any
  79.  form without payment to IBM, for any purpose including developing,
  80.  using, marketing or distributing programs that include or are
  81.  derivative works of the sample programs.
  82.  
  83.  The sample programs are provided to you on an "AS IS" basis, without
  84.  warranty of any kind.  IBM HEREBY EXPRESSLY DISCLAIMS ALL WARRANTIES,
  85.  EITHER EXPRESS OR IMPLIED, INCLUDING , BUT NOT LIMITED TO, THE IMPLIED
  86.  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  87.  Some jurisdictions do not allow for the exclusion or limitation of
  88.  implied warranties, so the above limitations or exclusions may not
  89.  apply to you.  IBM shall not be liable for any damages you suffer
  90.  as a result of using, modifying or distributing the sample programs
  91.  or their derivatives.
  92.