Jonathan de Boyne Pollard wrote in a message to Joey Mukherjee:

 JdBP>   Also, you are labouring under a misapprehension. 
 JdBP> findfirst() is *NOT*   standard.  

Yeah, I found this out when I tried doing on Solaris... :-(  Ok, lesson learned!

 JdBP>   What compiler are you using ?  If it is one of the
 JdBP> commercial ones,   then it will have on-line help for the
 JdBP> OS/2 API included in the   package (they all ship with the
 JdBP> OS/2 Developers' Toolkit, in one form   or another).

I am using Watcom v10.0a.  Here's where I'm looking and I'm assume I'm
doing it in the wrong place.  I open up the Control Program Reference which
seems to have much of the IBM calls (not VIO though?).  I do a search for
KbdCharIn and it finds something in CharData which I go to.  It mentions
KbdCharIn but has nothing else to reference it with.  The file name /
parameter is "VIEW PROGREF20"  If I do a search of all libraries,
I get the same result.

I also got PRCP off of the net somewhere and it has NO examples for anything.

Here's my uncompilable code:

{
   int done = 0;
   USHORT cursor_pos;
   KBDKEYINFO ki;

  /* init this to 0 so that KbdCharIn() does not report any false
   * character readings the first time through */

    ki.chScan = 0;

   while (!done)
   {
      DrawCur (cursor_pos);
      PosCursor (1, 1);
      printf ("Key = %d (%c)\n", ki.chChar, ki.chScan);
      KbdCharIn (&ki, 1, 0);
      switch (ki.chChar) {
         case 0    : switch (ki.chScan)
                 {
                  // function keys and arrow keys
                  
                  case 72 : if (cursor_pos > 0) cursor_pos--;
                           else ; // scroll up
                            break;
                  case 80 : if (cursor_pos < 20) cursor_pos++;
                           else ; // scroll down
                            break;
                 }
         case 'q' : done = 1;
      }
   }       
}

JM 

P.S.  TO all:  Thanks to all for helping with the compiler program.  As
someone figured out, I was using 4OS2 and it was preventing the compiler
from doing a make.  Thanks Ed!

--- timEd/2 1.01