home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lantools / os2bbshl / os2bbs.doc < prev   
Encoding:
Text File  |  1992-08-13  |  6.7 KB  |  135 lines
  1.          OS2BBS.CMD -- Automated OS/2 BBS Access for Reading/Writing
  2.  
  3.  
  4.          IBM has implemented a forum on IBMLink called the OS2BBS that
  5.          allows IBM and customers to exchange information.  The OS2BBS
  6.          is a host-based system.  This REXX code will automatically
  7.          login to IBMLink, access the OS/2 bulletin board and download
  8.          either the new notes or all of the notes.  This was written
  9.          using the HLLAPI DLL that comes with OS/2 ES 1.0.  The three
  10.          primary benefits of this code is that you can store the
  11.          information from the BBS as long as you want, you can read the
  12.          information at PC speed instead of host networking speed, and
  13.          your time spent on the BBS will be kept to a minimum, reducing
  14.          the connect time charges for using the BBS.
  15.  
  16.  
  17.  
  18.          ---- Advertisement ----
  19.  
  20.          I use Chron, a Hilbert Computing product, to execute this
  21.          code on a daily basis at 7:00PM.  When I come into work in
  22.          the morning the new notes are available to be read.  Chron is
  23.          available from:
  24.  
  25.                          Hilbert Computing
  26.                          1022 N. Cooper
  27.                          Olathe, KS 66061
  28.                          Voice:   (913) 780-5051
  29.                          BBS:     (913) 829-2450
  30.  
  31.          The price is $69 for Chron v3.0 (subsequent versions may have a
  32.          price change).  Site licensing is available.
  33.  
  34.          ---- End of Advertisement ----
  35.  
  36.  
  37.  
  38.          This code is available free of charge and is officially unsupported.
  39.          However, I will try to answer any questions and resolve any code
  40.          defects.   I can be contact on the Hilbert Computing BBS by
  41.          leaving a message to Sysop or Gary Murphy.  My CompuServe ID is
  42.          [73457,365].  Prodigy is VWSD07A.  I would enjoy hearing from you
  43.          if you like this code or have suggestions for improvement.
  44.  
  45.  
  46.          The syntax of the command is:
  47.  
  48.                   OS2BBS [NEW | ALL] {password} ( {options}
  49.  
  50.          where NEW indicates that you want just the new notes since you
  51.          last accessed the forum and ALL indicates that you want all the
  52.          notes.  The optional "password" is your password to IBMLink.  If
  53.          this is not specified, you will be prompted to enter the password
  54.          as the code runs.  The password will not be echoed back to you as
  55.          you type it.  The optional "options" are currently LOGON
  56.          (the DEFAULT) and NOLOGON.  If you are already on IBMLink for
  57.          other work, you can access the OS2BBS by returning to the IBMLink
  58.          main menu and running this command with the NOLOGON option for
  59.          example:
  60.  
  61.                              OS2BBS NEW (NOLOG
  62.  
  63.  
  64.          The code should be ready to run after a likely modification to
  65.          the login code.  Our host, depending on default LOGAPPLs, can
  66.          be on one of a few different screens when not logged on.  This
  67.          code tries to determine where the screen currently is and get
  68.          to a menu displayed by a host VTAM product called CL/Menu.  Once
  69.          there it enters the login string "/L IBM0MON2 M(PC3270M2)".  In
  70.          most shops you will modify this to enter the typical logon string
  71.          from the USSTABLE screen as follows:
  72.  
  73.  
  74.                     LOGIN APPLID(appl) LOGMODE(logmode)
  75.  
  76.  
  77.          Probably the main problem in HLLAPI code is recognizing when
  78.          the host application does a keyboard unlock on the 3270.  If
  79.          there is a keyboard lock (i.e. the X-Clock at the bottom of
  80.          the screen) then you can use the HLLAPI 'Wait' verb to wait for
  81.          keyboard unlock.  If the application doesn't lock the keyboard,
  82.          (as in the case of the logon to VM systems including IBMLink),
  83.          then you have to code a call to my routine called HostWaitFor
  84.          keep looking at the screen for 'x' seconds until it finds a
  85.          character string on the screen.  You will see in the code where
  86.          the login has to use the HostWaitFor, but once logged on to the
  87.          OS2BBS, the code uses the
  88.  
  89.                          rcode = hllapi('Wait')
  90.  
  91.          to simply wait for keyboard unlock before proceeding.
  92.  
  93.          You will also have to change the stem variables at the beginning
  94.          of the program to reflect your site's information.   Change the
  95.          "Host." variables to contain your VTAM APPL for IBMLink, the
  96.          logmode, your four character account, userid and the 3270 Session
  97.          in Communications Manager that you want to use for the IBMLink
  98.          login.
  99.  
  100.          The 'Forum.' stem variable contains the list of forums on the
  101.          BBS that you are interested in.  The names must match exactly
  102.          the forum name listed to the right of the screen when logged on
  103.          to the OS2BBS. Make sure that the Forum.0 value accurately matches
  104.          the number of forums that you have enumerated in the stem variable.
  105.  
  106.          Once logged on, this code will visit the forums you have selected
  107.          and download the information, a screen at a time, to an OS/2 file
  108.          called "forum.BBS", where 'forum' is that same 1-8 character name
  109.          of the forum on the BBS.  It will append to the end of the file,
  110.          so if you automatically run this application on a daily basis but
  111.          don't get the time to read the information, none will be lost.
  112.  
  113.          When visting a forum, this code will look for the existence of
  114.          a file called "forum.RPL" if found, the notes in that file will
  115.          be entered as new notes on the BBS.  The ".RPL" file must be
  116.          formatted the same as the notes that are pulled created by this
  117.          code, including the double bar at the beginning and end of the
  118.          note and the line containing the CFORUM name and the Subject:.
  119.          I have developed some macros to work with my favorite editor,
  120.          Kedit from Mansfield software, that will help create those
  121.          notes.  Therefore, I didn't put a lot of error checking into
  122.          the code that reads the reply files.
  123.  
  124.          If you want to play with the reader/writer, there is a TESTER
  125.          forum on the OS2BBS that I used during the development of this
  126.          code.  You may want to use that forum to validate your replies
  127.          before going with a "live" forum.
  128.  
  129.          If you want to code your own REXX HLLAPI applications, the
  130.          documentation is found in \CMLIB\RXHLLAPI.DOC on your workstation.
  131.          Please only upload this code to other bulletin boards.  If you make
  132.          modifications and want to upload those, please clearly indicate
  133.          your modifications in the code and in this documentation.
  134.  
  135.