README FILE FOR APING

AUTHOR: Peter J. Schwaller
VNET: PJS at RALVM6 Tie Line: 444-4376
Internet: [email protected] (919) 254-4376

This sample APING and source files are also available on
CompuServe through the APPC Information Exchange. To get
to the APPC forum just type 'GO APPC' from any CompuServe
prompt. The samples are available in the Sample Programs
library section. Just search on the keyword CPICPGMS to
find all the samples in this series.

Updates for the sample programs and support for many more
CPI-C platforms will also be made available on CompuServe.


A guide to the files in this package:

APING.doc
Documentation file for APING. Includes:
- User's Guide
- Configuration Guide
- Programmer's Guide

aping.c
Main source for the client side of APING

apingd.c
Main source for the server side of APING

cpicerr.c
cpicerr.h
Used by aping.c and apingd.c for error handling.

cpicinit.c
cpicinit.h
Used by aping.c to help with the initialization of CPI-C
conversations.

cpicport.c
cpicport.h
cpicdefs.h
Contains most of the non-portable code used by aping.c and apingd.c.
Examples :
Data conversion routines
Buffer allocation
Display of usage information
Setting of constants used by other modules

getopt.c
getopt.h
Command line processing routine used by aping.c.

cpiccmc.h
Hides the differences in the CPI-C file for C that exist among
CPI-C platforms.

cpic.h
A CPIC file usable on all platforms.


Makefiles are provided for many platforms and compilers:

APING.os2
Environment: OS/2 with Extended Services or Networking Services/2.
Compiler: Makefile for Microsoft C 6.00 Compiler.
For IBM C/2, change the warning flag from /W4 to /W3.

APING.dos
Environment: DOS with Networking Services/DOS.
Compiler: Makefile for Microsoft C 6.00 Compiler.
For IBM C/2, change the warning flag from /W4 to /W3.

APING.fam
Environment: (OS/2 with Extended Services or Networking Services/2) and
(DOS with Networking Services/DOS).
Creates a family API executable that can be run
in either OS/2 or DOS.
Compiler: Makefile for Microsoft C 6.00 Compiler.
For IBM C/2, change the warning flag from /W4 to /W3.

APING.bor
Environment: DOS with Networking Services/DOS.
Compiler: Makefile for Borland C++ 2.0.

APING.icc
Environment: OS/2 2.0 with ES/2.
Compiler: Makefile for IBM C Set/2 compiler (32 bit).

APING.vm
Environment: VM SP/6 or VM ESA.
Compiler: REXX exec for C/370. Also has makefile imbedded in comments.

APING.400
Environment: AS/400
Compiler: REXX exec for compiling on the AS/400.

APING.aix
Environment: AIX SNA Services
Compiler: Makefile for the XCL compiler on AIX.