CPI-C Support 
------------- 
Starting in this version, Reflection fully supports IBM's 
Common Programming Interface for Communications (CPI-C). 
Programs written to this specification communicate with  
remote nodes over the Reflection SNA Engine. CPI-C is 
both platform and language independent. Sample CPI-C source 
code is included in this release that demonstrates how 
CPI-C can be used to implement the most common APPC 
transactions. 
 
 
 
 
Working with the CPI-C Samples 
------------------------------ 
To help you create programs that use the CPI-C API, a set of sample  
source files ("The Classic 5 CPI-C transactions") are included on  
the Reflection product CD and are installed into the \Samples  
subfolder by default. These source files are from the book: 
      
     "CPI-C Programming in C:  An Application Developer's Guide to APPC"  
     by John Q. Walker II and Peter J. Schwaller, ISBN 0-07-911733-3,  
     1994. 
      
These files are copyrighted material and are redistributed here  
by permission of the authors, who retain all rights.  
      
This book is recommended as a tutorial on CPI-C programming. Additional  
information about CPI-C is available at the following web sites: 
      
The Official CPI-C Home Page: 
      
        http://www.networking.ibm.com/app/aiwconf/cpic.htm 
      
The CPI-C Implementers Workshop: 
      
        http://www.networking.ibm.com/app/aiwconf/aiwciw.htm 
    
The complete set of source files accompanying the book referenced above 
can be downloaded from John Q. Walker's homepage at Ganymede Software: 
      
        http://web.ganymedesoftware.com/employees/johnq/jqwdown.htm 
      
      
The classic5.mak make file has been revised to simplify compiling the  
programs on 32-bit Windows platforms using Microsoft Visual C++.  To build  
the programs, you must first edit classic5.mak and modify the following  
lines to match the directory names in your installation: 
      
#-----------------------------------------------------------------------  
#  set CPICLIB to the full path and file name of the CPIC library file 
#  set INCLUDE to the directory containing wincpic.h  
#-----------------------------------------------------------------------  
CPICLIB = e:\v110\exe\d32\ibm\support\wcpic32.lib 
INCLUDE = .;e:\v110\exe\d32\ibm\support;$(INCLUDE) 
      
After editing and saving the make file, build the executables using the  
following command: 
	 
	nmake -f classic5.mak 
 
The Classic 5 transactions require CPI-C side information in order  
to run. To configure CPI-C side information, double-click the  
"APPC - LU 6.2 Configuration" icon in the Reflection Utilities subfolder. 
and select the CPI-C tab. For each symbolic destination name, 
select a mode name, partner LU netid, and partner LU name that is appropriate  
for your installation.  The modes can be one of the standard predefined modes,  
such as #INTER or #BATCH.  The remote LU netid and LU name must be one defined 
on the LU 6.2 tab of the SNA Engine.   
 
The following symbolic destination names should be defined: 
 
Symbolic destination name: PIPES 
Partner TP name: PIPED 
 
Symbolic destination name: CREDITS 
Partner TP name: CREDITD 
 
Symbolic destination name: INQUIRYS 
Partner TP name: INQUIRYD 
 
Symbolic destination name: FILEXS 
Partner TP name: FILEXD 
 
Symbolic destination name: UPDATES 
Partner TP name: UPDATED 
 
Symbolic destination name: FLUSHS 
Partner TP name: FLUSHD 
 
Symbolic destination name: SERRORS 
Partner TP name: SERRORD 
 
Symbolic destination name: SERVER2S 
Partner TP name: SERVER2D 
 
Symbolic destination name: SERVER1S 
Partner TP name: SERVER1D 
 
For more information about working with these sample programs, see 
the readme.txt file that is installed in the Samples subfolder. 
 
 
 
 
 
      
      
      
      
      
