SNA Server CPIC Allocate Error 20 (CM_PRODUCT_SPECIFIC_ERROR)

ID: Q132720

The information in this article applies to:

Microsoft SNA Server, versions 2.0, 2.1, 2.11, 2.11 SP1, 3.0, 3.0 SP1, 3.0 SP2, 3.0 SP3, 4.0, 4.0 SP1, 4.0 SP2

SYMPTOMS

When you run a CPIC program on SNA Server, such as the CPIC sample programs included in the SNA Server SDK, or a custom CPIC program, the CPIC program's Allocate (CMALLC) call may fail with error 20 (CM_PRODUCT_SPECIFIC_ERROR).

CAUSE

The problem most commonly occurs when a Local APPC LU has not been configured for use by the CPIC program within the SNA Server configuration. If SNA Server APPC and CPIC API application tracing is enabled, the trace will indicate that the underlying APPC ALLOCATE call is failing with primary_rc = F004 (COMM_SUBSYSTEM_NOT_LOADED). When this occurs, the CPIC interface returns Error 20 (CM_PRODUCT_SPECIFIC_ERROR) to the CPIC application

NOTE: When the CPIC interface was defined by IBM, there was no way to programmatically define which Local APPC LU to use, nor could it be specified in the CPIC side information. Because SNA Server supports configuration of many Local APPC LUs, the specific Local APPC LU to be used by the CPIC application must be defined through SNA Server product-specific methods.

RESOLUTION

To solve the Error 20 failure, configure a Local APPC LU. SNA Server allows the administrator to configure the Local APPC LU alias using any of the following methods (you only need to use one):

Configure the Local APPC LU to be a member of the default pool.
SNA Server 2.x
--------------
1. In SNA Server Admin, go to the Servers and Connections window and choose the Local APPC LU that is partnered with the Remote APPC LU and Mode that the CPIC application is using.
2. In the Local APPC LU Properties dialog box, select "Member of Default Outgoing Local APPC LU Pool."
3. Choose OK and save the SNA Server configuration file.
4. Stop and start the SNA Server service so the change can take effect.
SNA Server 3.0
--------------
1. In SNA Server Manager, go to the Local APPC LUs folder under the SNA Server for which the Local APPC LU was created and double- click on the Local LU that the CPIC application is using.
2. Go to the Advanced tab in the Local APPC LU Properties dialog box and select "Member of Default Outgoing Local APPC LU Pool."
3. Choose OK and save the SNA Server configuration file.
4. Stop and start the SNA Server service so the change can take effect.

Configure a default Local APPC LU alias for the user or group.
SNA Server 2.x
--------------
Within SNA Server Admin, go to the "Users and Groups" window. If no users or groups are currently displayed, press the INSERT key and choose New User. Add a Windows NT user or group account that the CPIC application will run under. If you want a specific Local APPC LU to be associated with any user who connects to SNA Server, add the "Everyone" user.

After the appropriate Windows NT user, group, or Everyone entry has been added to SNA Server Admin, select the entry and press ENTER. Set the Default APPC LU Local LU Alias to an LU that is partnered with the Remote APPC LU and mode that the CPIC application is using. Then choose OK.

The SNA Server configuration file must be re-saved for the change to take effect; it is not necessary to stop and restart the SNA Server service.
SNA Server 3.0
--------------
Within SNA Server Manager, go to the Configured Users folder. If no users or groups are currently displayed, press the INSERT key and choose User. Add a Windows NT user or group account that the CPIC application will run under. If you want a specific Local APPC LU to be associated with any user who connects to SNA Server, add the "Everyone" user.

After the appropriate Windows NT user, group, or Everyone entry has been added to SNA Server Manager, double-click on the entry. Select the APPC Defaults tab and set the Default APPC LU Local APPC LU Alias to an LU that the CPIC application is using. Then choose OK.

The SNA Server configuration file must be resaved for the change to take effect; it is not necessary to stop and restart the SNA Server service.

Configure the Local LU Alias within the SNA client configuration.

The default Local APPC LU can be set in the SNA Server client configuration, as described in the SNA Server 2.1 "Reference Guide," Appendix C (page 202), in the "CPIC API: Location and Names of Variables."
Windows NT Clients
------------------
The Registry variable that affects the CPIC API for Windows NT-based SNA Server clients is:
```
HKEY_LOCAL_MACHINE

      \SYSTEM\CurrentControlSet\Services\SnaBase\Parameters\Client
        \<application>: REG_SZ: <LocalLUalias> 
```
where <application> is the CPIC application name and <localLUalias> is the default Local APPC LU alias.

This change will take effect as soon as the registry is updated; you do not have to stop and restart the SnaBase service.
Windows 95/98 Clients
---------------------
The Registry variable that affects the CPIC API for Windows 95/98-based SNA Server clients is:
```
   HKEY_LOCAL_MACHINE
     \SOFTWARE\Microsoft\SnaBase\Parameters\Client
        \<application>: REG_SZ: <LocalLUalias> 
```
where <application> is the CPIC application name and <localLUalias> is the default Local APPC LU alias.

On Windows 95/98, the SnaBase process must be restarted for this change to take effect.
Windows 3.x and OS/2 Clients
----------------------------
The variable that affects the CPIC APIC for Windows 3.x-based or OS/2- based SNA Server clients is found in the CPIC program's [ApplicationName] section of the WIN.INI file is stored as follows:
```
      [ApplicationName]
      APPCLLU=<localLUalias> 
```
where <localLUalias> is the default Local APPC LU alias.

If you change this entry the SNA Server Win 3.x client (WNAP.EXE) and SNA Server OS/2 client (COMNAP) must be stopped and started to enable this change.

Precedence Order
================

The following precedence order is used when defaulting the Local LU to the CPIC application:

The registry setting takes the greatest precedence.

If there is no registry assignment, then the default Local APPC LU is used. The default Local APPC LU must be assigned to the user context (or group context) under which the CPIC application is running.

If there is no default Local APPC LU assignment, any Local LU that has the Member of default outgoing Local APPC pool check box configured will be used.

Additional query words: prodsna cmallc 20 administrator cm_product_specific_error

Keywords : kbnetwork kbprg kbusage snaappc snacpic sna211 sna211sp1 sna211sp2 sna3 sna3sp1 sna3sp2 sna3sp3 sna4 sna4sp1 sna4sp2 sna2 sna21
Version : WINDOWS:2.0,2.1,2.11,2.11 SP1,3.0,3.0 SP1,3.0 SP2,3.0 SP3,4.0,4.0 SP1,4.0 SP2
Platform : WINDOWS
Issue type :