home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / iakprmpt.zip / readme < prev   
Text File  |  1995-04-10  |  2KB  |  72 lines
  1. README for IAKPRMPT
  2.  
  3. This VisPro/REXX program will allow you to prompt for information
  4. from within a REXX dialing script executing under SLIPPM.EXE.
  5.  
  6. It is intended for use with the Dial Other Providers application
  7. (SLIPPM.EXE) provided in the Internet Access Kit with OS/2 WARP.
  8.  
  9. INSTALLATION
  10.  
  11. Place the IAKPRMPT.EXE file into a directory in your PATH.
  12.  
  13. USAGE
  14.  
  15. The program uses a named REXX queue to communicate between the
  16. dialing script and the VisPro/REXX program. Your dialing script
  17. should create and activate the queue, put the text containing
  18. a prompt into the queue, then invoke the program.
  19.  
  20. A dialog box will be displayed with the contents of your prompt,
  21. and an input field. The user then types his response and clicks
  22. on the OK icon and the response is put back into the REXX queue
  23. for retrieval from within your dialing script.
  24.  
  25. Here's how to set this up:
  26.  
  27. Somewhere near the beginning of your dialing script add the
  28. following lines:
  29.  
  30.     /* setup the REXX queue for any prompting required */
  31.  
  32.     call RXQUEUE 'Delete', 'IAKQUE'
  33.     newq = RXQUEUE('Create','IAKQUE')
  34.     oldq = RXQUEUE('Set', newq)
  35.  
  36. Now, when your script determines that it needs to prompt for
  37. information, you can do something like this:
  38.  
  39.     queue 'Please specify phone number to dial'
  40.     address CMD 'IAKPRMPT'
  41.     parse pull phoneNumber
  42.  
  43. In this case a dialog will be displayed with the prompt text
  44. specified in the queue command above. You can queue multiple
  45. lines of prompt text, as the dialog displays them in a scrollable
  46. listbox. I've found approximately 40 characters will fit in the
  47. width of the box without needing to scroll horizontally.
  48.  
  49. The user then types his/her response in the input field of the
  50. dialog and clicks OK. The program pushes the unedited text of the
  51. response onto the stack and exits. You REXX script pulls a single
  52. line from the stack to pick up the response. Responses are always
  53. a single line.
  54.  
  55. You can now use the information returned in whatever way
  56. necessary.
  57.  
  58. Somewhere near the end of your dialing script, add the following
  59. line to delete the named queue:
  60.  
  61.     call RXQUEUE 'Delete', 'IAKQUE'
  62.  
  63.  
  64. CONTACTING THE AUTHOR
  65.  
  66. I hereby release this program into the public domain. It's free,
  67. no charge, gratis. Have fun with it - I hope it helps you.
  68.  
  69. If you have any comments/suggestions or other feedback, please
  70. send a note to sasmith@mailhost.wlc.com
  71.  
  72.