Step 8: Enabling CCIAPPC to Find the Local LU

It is very important that the CCIAPPC module be able to determine the Local LU to use for communication with the Host application. You may have configured everything else correctly and all of your other APPC applications may work, but if you miss this final step you will fail to establish a CCI session with the host application. If the CCI-INITCLIENT call returns CCI error 9 and CCI_GETERROR returns the message "CCIAPPC failed to allocate an APPC session, ensure that Local LU is defined" it is likely that you have failed to complete this final step. When CCIAPPC attempts to allocate an LU 6.2 session with the remote system it must specify the Remote LU name which it requires a session with. This is the Remote LU name specified in the CCI Servername parameter (e.g. the /S parameter in FHREDIR.CFG). However, APPC needs to know the Local LU name as well as the Remote LU name when attempting to establish a session between the LUs.

The manner in which it determines the Local LU name in SNA Server is by one of two mechanisms as described below:

  1. Configure the Local LU to be a member of the Default Outgoing Pool.

    When we configured the Local LU above, we selected the check box marked Member of Default Outgoing Local APPC LU Pool in the APPC LU Properties dialog box. This means that when CCIAPPC attempts to allocate a session with the Remote LU it will examine the Local LU partners configured with the Remote LU and select one which is a member of the Default Outgoing Pool. However, if there are multiple Local LU partners configured with the Remote LU which are members of the Default Outgoing Pool then any of these Local LUs could be selected. If this side-effect is undesirable then implement the following method.

  2. Configure a default Local APPC LU Alias on per user or group basis.
    • In the Users and Groups window from the View menu select Configured Users. From the Users menu select New User.
    • Select the domain from which to add the users or groups or select the local server name.
    • Select the user or group from the list in the Names list box (select the Members... button to list the users in a group) and then select Add.
    • Click the OK button.
    • In the Users and Groups window select the user or group with which you want to associate a default Local APPC LU.
    • In the Users menu select the Properties menu item.
    • In the User Properties dialog box select the required Local LU from the Default Local APPC LU popdown list.
    • Click the OK button.

Now go to the File menu and select Save Configuration. It is not necessary to restart the SNA Server service to activate the new configuration. For further information concerning assigning default LUs to users and groups see the section entitled Assigning Default APPC LUs to Users or Groups in chapter 6, Configuring LUs for APPC, in the Microsoft SNA Server Administration Guide.