home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pc3270sa.zip / srpsmp / srpsmp.doc < prev    next >
Text File  |  2002-02-28  |  8KB  |  195 lines
  1. ***************************************************************************
  2. *              IBM Personal Communications/3270 Version 4.1               *
  3. *                         for Windows 95 / Windows NT                     *
  4. *                                                                         *
  5. *                                                                         *
  6. *                               SRPSMP.EXE                                *
  7. *             SRPI sample program that supports server requester          *
  8. *             programming interface                                       *
  9. ***************************************************************************
  10.  
  11.  
  12.   SRPI SAMPLE PROGRAMS
  13.  
  14.   The SRPI sample programs are provided as an example of how the SRPI
  15.   Send_Request interface verb can be used by a PC requester application
  16.   to invoke a server on the host.  The function of the sample programs
  17.   is to request records from a customer records data set on the IBM host
  18.   computer.  The IBM host computer sends the customer records to the
  19.   requester program for processing.  If the customer's balance in the
  20.   record is positive, the record is sent back to the server.  The server
  21.   puts the positive balance into an accounts receivable data set on the
  22.   IBM host computer.  To support this function, a sample PC requester
  23.   program, a sample host server program and a sample host data file are
  24.   provided.
  25.  
  26.   The sample programs are designed to work in the Windows 95 and Windows NT.
  27.   Sample program source code and the supporting files are provided for the
  28.   MSVC 2.2 . Since the sample programs are in source
  29.   form, you will need to go through additional steps to run these
  30.   programs.
  31.  
  32.   RESTRICTIONS
  33.  
  34.   1.  The Personal Communications/3270 must be loaded with at least one
  35.       3270 terminal session configured for use with SRPI.
  36.  
  37.   2.  The sample server is based on the sample server source program
  38.       documented in the "Programmer's Guide to the Server-Requester
  39.       Programming Interface for VM/System Product".  The sample server
  40.       provided is used to run under VM/CMS environment only.  For a
  41.       sample server that will run under MVS environment, refer to the
  42.       "TSO Extensions Programmer's Guide to the Server-Requester
  43.       Programming Interface for MVS/Extended Architecture" for more
  44.       information.
  45.  
  46.   3.  The balance field in the customer record is in binary format and
  47.       it is non-displayable on VM in the sample customer data set.
  48.  
  49.   PREREQUISTES
  50.  
  51.   To run a sample program, you must be familiar with the following
  52.   things:
  53.  
  54.   1.  Windows 95 or Windows NT installation and command prompt
  55.  
  56.   2.  PC/3270 installation
  57.  
  58.   3.  Compiler for the desired language
  59.  
  60.   4.  VM/CMS operation and commands
  61.  
  62.  
  63.   INSTALLATION
  64.  
  65.  
  66.   Install Windows 95 or Windows NT and the PC/3270 according to instructions
  67.   in the documentation provided with the product.
  68.   The API setting need to be selected.
  69.  
  70.   The compiler associated with the desired language also needs to be
  71.   installed using the installation procedure of that language compiler.
  72.   Refer to the following language sections for additional information.
  73.  
  74.  
  75.   SAMPLE REQUESTER PROGRAMS
  76.  
  77.   C LANGUAGE
  78.  
  79.       The C sample requester program is called SRPSMP.C.
  80.  
  81.       ■  ENVIRONMENT:
  82.  
  83.          After setting up the environment for C compiling, add LIB
  84.          and INCLUDE paths.  UUCCPRB.H, UUCCPR32.H and
  85.          PCSCAL32.LIB.
  86.  
  87.       ■  COMPILING AND LINKING:
  88.  
  89.          To compile and link the sample requester program, make the SRPI
  90.          API directory and execute the following command at the
  91.          command prompt:
  92.  
  93.                 nmake /f "srpsmp.mak" CFG="Win32 (80x86) Release" [press Enter]
  94.  
  95.          The executable file SRPSMP.EXE will be created.
  96.  
  97.  
  98.   HARDWARE REQUIREMENTS:
  99.  
  100.   A 3270 terminal emulation connection to an IBM host computer via
  101.   a SNA controller from an IBM Personal Computer AT using the IBM 3278/79
  102.   Adapter (DCA) or from a PS/2 using The IBM 3270 Connection adapter.
  103.  
  104.  
  105.   INSTALL SAMPLE SRPI SERVER:
  106.  
  107.  
  108.   To set up the sample server environment, two files are needed on the
  109.   IBM host computer:
  110.  
  111.      IBMABASE MODULE (the sample server)
  112.      INPUT FILE (the sample customer data set)
  113.  
  114.   The following instructions will guide you to properly install the SRPI
  115.   sample server on the host.
  116.  
  117.   At the command prompt, enter the following commands to upload the
  118.   three host sample files from the diskette:
  119.  
  120.   For SBCS environment:
  121.  
  122.      SEND IBMABASE.ASM h: IBMABASE ASSEMBLE A (ASCII CRLF RECFM F
  123.      SEND ALGABASE.EXC h: ALGABASE EXEC A (ASCII CRLF
  124.      SEND INPUT.FIL    h: INPUT FILE A (LRECL 109
  125.  
  126.   For DBCS environment:
  127.  
  128.      SEND IBMABASE.ASM h: IBMABASE ASSEMBLE A [(JISCII CRLF RECFM F
  129.      SEND ALGABASE.EXC h: ALGABASE EXEC A [(JISCII CRLF
  130.      SEND INPUT.FIL    h: INPUT FILE A [(LRECL 109
  131.  
  132.   Note: specify the drive and path name to the above files if they are
  133.         not located on the current path.
  134.         h: 3270 terminal short session ID.
  135.  
  136.   After the file transfer completes, switch to the same 3270 session and
  137.   type ALGABASE at the VM/CMS command line to assemble and link.  This
  138.   will generate the executable sample server file with the name of
  139.   IBMABASE MODULE.
  140.  
  141.  
  142.   RUNNING SRPI REQUESTER AND SERVER SAMPLE PROGRAMS
  143.  
  144.   Create a new directory SAMPLE on the PC where your requester sample
  145.   program will reside.  For C language, copy the file SRPSMP.EXE.
  146.  
  147.   Enter CMSSERV from the CMS command line in the 3270 session you just
  148.   started.  The IBM Enhanced Connectivity Facilities screen appears.
  149.   Switch to an command prompt and change the current directory to
  150.   SAMPLE.  Execute the sample requester program.  When the program
  151.   completes, switch back to the 3270 session with CMSSERV screen.  Press
  152.   PF3 key to end the communication between CMSSERV and your PC.  Verify
  153.   that there are two files generated in your 3270 session as a result of
  154.   the SRPI requester execution.  The names of these two files are OUTPUT
  155.   FILE and LOG FILE.
  156.  
  157.   The approximate content of the OUTPUT FILE is listed below:
  158.  
  159.   Barttwell, Jim 300 Top Bend         Austin Texas   78759  1000-2000-3020 A"""""""
  160.   """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  161.   
  162.   The approximate content of the LOG FILE is listed below:
  163.  
  164.   CUSTOMER RECORDS READ ***
  165.   Ahab, John     1000 High Circle       Austin Texas   78759  1000-2000-3000 a""""
  166.    "ADMIN
  167.  
  168.   CUSTOMER RECORDS READ ***
  169.   Black, Edward  2000 Big Top Road   Austin Texas   78759  1000-2000-3010 """"
  170.    "ADMIN
  171.  
  172.   CUSTOMER RECORDS READ ***
  173.   Barttwell, Jim 3000 Top Bend       Austin Texas   78759  1000-2000-3020 A"""
  174.    "ADMIN
  175.  
  176.   CUSTOMER RECORDS UPDATED
  177.   Barttwell, Jim 3000 Top Bend       Austin Texas   78759  1000-2000-3020 A"""
  178.   Barttwell, Jim 3000 Top Bend       Austin Texas   78759  1000-2000-3020 A""" 
  179.    "ADMIN
  180.  
  181.   CUSTOMER RECORDS READ ***                                                       
  182.   """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  183.   """""""""""""""""""""""""""""                                                   
  184.   "ADMIN                                                                          
  185.                                                                                 
  186.   CUSTOMER RECORDS UPDATED                                                        
  187.   """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  188.   """""""""""""""""""""""""""""                                                   
  189.   """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  190.   """""""""""""""""""""""""""""                                                   
  191.   "ADMIN
  192.  
  193.   WSCOMM RECEIVED BY SERVER
  194.  
  195.