Step 9: 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 select a Local LU which is a member of the Default Outgoing Pool. However, if there are multiple Local LUs 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.
    1. If the user or group has already been configured in SNA Server then skip to step number 6, otherwise perform steps 2 to 5 first.
    2. In the Insert menu select User at which point the Add Users and Groups dialog box should appear.
    3. Select the domain from which to add the users or groups or select the local server name.
    4. 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.
    5. Click the OK button.
    6. In the Configured Users folder double-click on the user or group with which you want to associate a default Local APPC LU.
    7. In the users' properties dialog box select the APPC Defaults tag.
    8. Select the the required Local LU from the Local APPC LU popdown list.
    9. Click the OK button.


*

Now go to the File menu and select Save. It is not necessary to restart the SNA Server service to activate a new User configuration.