KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q118381: Making and Running APING/APINGD Samples

Article: Q118381
Product(s): Microsoft SNA Server
Version(s): WINDOWS:2.0,2.11,3.0,4.0
Operating System(s): 
Keyword(s): sna4
Last Modified: 12-JUN-2001

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft SNA Server, versions 2.0, 2.11, 3.0, 4.0 
-------------------------------------------------------------------------------

This article includes instructions for making and running APING/APINGD
samples on SNA Server.

The following are the steps for making and running APING/APINGD samples on
SNA Server.

Building APING/APINGD
---------------------

Follow step A.1. (Building the TPs) in the SNA Server SDK README.TXT file.
The ISVLIBS, ISVINCS and SAMPLEROOT environment paths must properly point
to the SNA Server libraries, include files and sample programs. To build
the APING samples, run:

  

  "NMAKE -F MAKEPING.MAK" (without the quotation marks)

Install the APINGD Service on SNA Server
----------------------------------------

You can use the TPSETUP applet (shipped with the SNA SDK), or the INSTSRV
Windows NT service installer sample (shipped with the Win32 SDK). If you
use INSTSRV, configure extra settings through REGEDT32 for the APINGD
service.

WARNING: Using Registry Editor incorrectly can cause serious, system-wide
  problems that may require you to reinstall Windows NT to correct them.
  Microsoft cannot guarantee that any problems resulting from the use of
  Registry Editor can be solved. Use this tool at your own risk.

Sample Registry entries:

 HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/APINGD
   DisplayName: REG_SZ: APINGD
   ErrorControl: REG_DWORD: 0x1
   ImagePath: REG_EXPAND_SZ: C:\SNA\SDK\APINGD.EXE
   ObjectName: REG_SZ: LocalSystem
   Start: REG_DWORD: 0x3
   Type: REG_DWORD: 0x10
   Linkage:
     OtherDependencies: REG_MULTI_SZ: SnaBase
   Parameters:
     AlreadyVerified: REG_SZ: no
     ConversationSecurity: REG_SZ: no
     LocalLU: REG_SZ: LUPINGD
     SNAServiceType: REG_DWORD: 0x5
   Security:
     Security: REG_BINARY: <this is setup for you during install>

Configure Entries in the SNA Server Configuration File
------------------------------------------------------

In this configuration, APING is running on a client against APINGD which is
installed on the server (that is, they're running locally to one server).
Sample LU settings:

Local APPC LUs (configured off the server):

 LU Alias: LUPING
         - Independent LU6.2
         - Network name = APPN
         - LU Name = LUPING
         - Member of default outgoing local APPC pool
         - Timeout for starting TP: 60 seconds

 LU Alias: LUPINGD
         - Independent LU6.2
         - Network Name: APPN
         - LU Name = LUPINGD
         - Timeout for starting TP: 60 seconds
         - Partners:
         - Partner LU = LUPING, Mode = #INTER, Connection = [Local]

CPI-C Symbolic Destination Name (configured via Options/CPIC dialog):

 Name = APINGD
         - Partner TP name: Application TP = APINGD
         - Partner LU name: Alias = LUPINGD
         - Conversation security = None
         - Mode Name = #INTER

Users/Groups window:

 Add an SNA Server user account (or "Everyone" access) for the
 Windows NT client user that will be running the APING program.

Save the SNA Server configuration file.

Running the APING Sample Program
--------------------------------

1. Start the SNA Server service on the server, using SNA Admin, or by the
  command line ("net start snaserver").

2. Start the APINGD service on the server, using the Control Panel Services
  applet.

3. On the Windows NT client machine, run APING:

  "APING APINGD" (without the quotation marks)

Enable the "APING" Local LU as a "Member of default outgoing local APPC
pool"; this is the Local LU name that will be used. If this is not enabled,
APING will display error 20 (product specific error).


Additional query words: prodsna 2.00

======================================================================
Keywords          : sna4 
Technology        : kbAudDeveloper kbSNAServSearch kbSNAServ300 kbSNAServ200 kbSNAServ211 kbSNAServ400
Version           : WINDOWS:2.0,2.11,3.0,4.0

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.