home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rxgwa1.zip / read.me < prev    next >
Text File  |  1993-03-13  |  2KB  |  52 lines
  1.  
  2.       ASCII to EBCDIC / EBCDIC to ASCII conversion in OS/2 REXX
  3.       ---------------------------------------------------------
  4.  
  5.                    RXGWA10.ZIP - Version 1.0
  6.  
  7. The included Dynamic Link Library (RXGWA.DLL) contains functions to
  8. convert ASCII to EBCDIC - a2e() and EBCDIC to ASCII - e2a().
  9.  
  10. They are particularly useful in writing APPC & CPI-C REXX applications
  11. on OS/2 computer for communications with mainframes.
  12.  
  13. a2e (ASCII to EBCDIC)
  14.   returns an ASCII string when passed an EBCDIC string.
  15.  
  16. e2a (EBCDIC to ASCII)
  17.   returns an EBCDIC string when passed an ASCII string.
  18.  
  19. RXGWA.DLL must be copied to a subdirectory that is included in your
  20. LIBPATH.
  21.  
  22. The functions must be registered in your REXX program using the
  23. RXFUNCADD function. For example...
  24.  
  25.              call RxFuncAdd 'a2e','rxgwa','a2e'
  26.  
  27. Use FUNCTEST.CMD program as an example of how to call these functions
  28.  
  29. Some Cautions:
  30. 1) Strings passed to each of these functions must be less than 64K.
  31. 2) There are several ways of converting ASCII to EBCDIC.  If you don't
  32.    like the conversion method used here, edit the convert[] array and
  33.    recompile & re-link RXGWA.DLL.
  34.  
  35. DISCLAIMERS:
  36. I freely admit I'm not an expert in writing REXX functions, I just
  37. followed the examples that came with the CSET/2 toolkit (thanx IBM).
  38. So, be careful about using these functions in anything you consider
  39. critical. RXGWA.DLL is freeware.  Feel free to use or modify these
  40. programs however you see fit.  HOWEVER, please do not hold me
  41. responsible for any damage they might cause you or your data.
  42.  
  43. If you have any suggestions, please drop me an E-mail. I'm considering
  44. writing some functions to return the CPIC return code string given the
  45. return code number (e.g. rc2str('1') -> 'CM_ALLOCATE_FAILURE_NO_RETRY')
  46. ... or others such as status_received number to string.  Let me know if
  47. anyone wants these functions.
  48.  
  49.                                       Gerald W. (Jerry) am Ende
  50.                                       Compuserve 73237,131
  51.                                       March 13, 1993
  52.