/* x.h */
/* %Src=x.h  %Dir=\rltraynh/c/stuff/  %Date=92/10/15-2:28pm  */

/* Support for:   */

#ifndef OSY_H
#define OSY_H 1


  /***********************************************************
   |  osy - a DOS/Unix user I/F (inter/face) 
   |
   |  It presents a set of common routines that work *similarly*
   |  on either system. It is designed to run stand-alone and
   |  other that the system()  - via the  command  SYSTEM <arg-string> 
   |  it doesn't have any
   |  real hooks into the system. For some small DOS knock-offs 
   |  running on micro-controllers, some functions won't work.
   |  
   |  In general, you can issue (eg) a DIR or an ls command
   |  and it will run the same.
   |  
   |  It also provides a file LOAD and SAVE feature, as well
   |  as a small notepad function - which can also be saved.
   |
   |  For MANY of the c-list routines, you will need  osy.h
   |  esp the low-impact DBMS system  db.c
   |
   +--------------------------------------------------------*/
   



  /***********************************************************
   |  SDATE and STIME - sort sequence, compute friendly
   |
   |  Note both SDATE and STIME are declarable types
   |  in MANY (eg,  db.c  and tutor.c) c-list systems.
   |
   |  The format (quite arbitrary) of these two STRING
   |  variable types is as follows:
   |
   |  SDATE :    YYYYMMDD+XX   where +XX is + or - GMT
   |  
   |         Note: This is ALWAYS stored as a char[12]
   |               null-terminated string - makes for
   |               for nice printing, AND more importantly
   |               many micro-controllers ONLY allow whole
   |               WORD storage loc's (even # of bytes). 
   |
   |               In general, it should NOT be allocated 
   |               as a (char *) pointer to string - unless
   |               it's for YOUR own app; have fun / share and enjoy ;)
   |
   |
   |  STIME :    HHMMDDNNN   where NNN is miliseconds
   |                         (if avail, or should be set "000")
   |  
   |         Note: This is ALWAYS stored as a char[10]
   |               null-terminated string - makes for
   |               for nice printing, AND more importantly
   |               many micro-controllers ONLY allow whole
   |               WORD storage loc's (even # of bytes). 
   |
   |               In general, it should NOT be allocated 
   |               as a (char *) pointer to string - unless
   |               it's for YOUR own app; have fun / share and enjoy ;)
   |
   +--------------------------------------------------------*/
   

/*@PAGE*/



  /***********************************************************
   | FileDesc - Internal file descriptor (should accomodate
   |                                      both dos & unix systems)
   |
   |
   +--------------------------------------------------------*/



/*@PAGE*/

/*------------------------------------------------  Function prototypes -----*/

   void  Init_osy                                                   (void);



#endif  /* ifndef OSY_H */