How do I set up the interface between NetView and CS Linux or CS/AIX?

Answer

The interface between NetView and CS Linux is described in:

• Chapter 9 ("Managing Communications Server for Linux from NetView") of the IBM Communications Server for Linux Version 6.4 Administration Guide (SC31-6771-03)

• the "define_rcf_access" section of Chapter 2 ("Administration Commands") of the IBM Communications Server for Linux Version 6.4 Administration Command Reference (SC31-6770-03).

The same interface for CS/AIX is described in:

• Chapter 9 ("Managing CS/AIX from NetView") in the IBM Communications Server for AIX V6.4 Administration Guide (SC31-8586-04)

• the "define_rcf_access" section of Chapter 2 ("Administration Commands") of the IBM Communications Server for AIX V6.4 Administration Command Reference (SC31-8587-04).

The 'snaadmin define_rcf_access' command must be used. There is no xsnaadmin GUI interface for define_rcf_access. Start with the following commands:
# snaadmin -d -h

# snaadmin -d -h define_rcf_access


After you issue the define_rcf_access command, restart the CS Linux or CS/AIX node for the changes to take effect. Now you can run a command like this from NetView:

runcmd sp=spname,appl=component, commandtext

The fields are described in the books noted above.


Use the UCF option of the define_rcf_access command to allow a NetView user to run any Linux or AIX command, including ALL the snaadmin commands. For Linux, you must add that user to the 'sna' group:

# /usr/sbin/usermod -G sna username

The actual command shown above may be different for your Linux distribution.

Now you can define_rcf_access with that user:

# snaadmin define_rcf_access, ucf_username=username, ...

After running the define_rcf_access command you must restart the CS Linux or CS/AIX node and restart the link to the host. You can then run a NetView command similar to the following:

runcmd sp=CSLINUX1,appl=UNIX,/opt/ibm/sna/bin/snaadmin status_all

The Linux user must be a member of the 'sna' group in order to have the authority to run snaadmin commands. In the runcmd, use the fullpath of /opt/ibm/sna/bin because the rcf daemon will not have $PATH or other environment variables set.


For advanced users, there is also the CS Linux or CS/AIX Management Services (MS) API, which is a programming API. It is described in the IBM Communications Server for AIX or Linux V6.4 Management Services Programmer's Guide (SC23-8596-00).

The C language API allows you to create and send your own MS or Network Management Vector Transport (NMVT) and Multiple Domain Support (MDS) RUs from CS Linux or CS/AIX to VTAM.