Making and Running APING/APINGD Samples

Last reviewed: February 4, 1998
Article ID: Q118381
2.00 WINDOWS kbtool

The information in this article applies to:

  • Microsoft SNA Server for Windows NT, version 2.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

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
    

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 reference words: prodsna 2.00
KBCategory: kbtool
KBSubCategory: ntutil
Keywords : kbfaq


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.

Last reviewed: February 4, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.