Commmethod
The commmethod option specifies the communication method you use to provide connectivity for client-server communication.
Supported Clients
This option is valid for all clients.
Options File
Place this option in the dsm.sys file within a server stanza. You can set this option on the Communication tab of the Preferences editor.
Place this option in the client options file (dsm.opt). You can set this option on the Communication tab of the Preferences editor.
Syntax
.-TCPip-----. >>-COMMMethod-+-----------+------------------------------------>< +-SHAREdmem-+ '-V6TCPIP---'
Syntax
.-TCPip------. >>-COMMMethod-+------------+----------------------------------->< +-SHAREdmem--+ +-V6TCPIP----+ '-NAMedpipes-'
Parameters
- TCPip
- The Transmission Control Protocol/Internet Protocol (TCP/IP) communication method. This is the default.
- V6Tcpip
- Indicates that either TCP/IP V4 or V6 should be used, depending on the system configuration and the results of a domain name service lookup. A valid DNS environment must be available.
- NAMedpipes
- The interprocess communication method that permits message data streams to pass between a client and a server. Use this communication method with a Tivoli® Storage Manager server running on the same workstation as the client.
- SHAREdmem
- Use the shared memory communication method when the client and
server are running on the same system. This provides better performance
than the TCP/IP protocol. This communication method is valid only
for AIX®, HP-UX, Linux, and Solaris clients.
When specifying this communication method on AIX, the client can be logged in as root or non-root, as long as the server is running as root. If the server is not running as root, the user ID running the client must match the user ID running the server.
Important: When using commmethod sharedmem on Linux, you might receive error message: ANR8294W Shared Memory Session unable to initialize on the server or storage agent console. By default, Linux is not set up with sufficient system resources to create the message queues. You must increase the kernel parameter, MSGMNI, to 128 (the default is 16). You can modify this parameter by performing the following command:echo 128 > /proc/sys/kernel/msgmni
To enable this parameter to remain persistent after rebooting the system, you can instead add the following line to the file /etc/sysctl.conf, then reboot the system:kernel.msgmni=128
To view the current ipc settings, run this command:ipcs -l
Now look at the max queues system wide value. The default is 16.
- SHAREdmem
- Use the shared memory communication method when the client and
server are running on the same system. This provides better performance
than the TCP/IP protocol. Note: Use of this communication method requires that both client and server run under the same Windows account.
Examples
- Options file:
- commmethod tcpip
Use only TCP/IP V4
commmethod V6Tcpip
Use both TCP/IP V4 and V6, depending on how the system is configured, and the results of a domain name service lookup.
Note: The dsmc schedule command cannot be used when both SCHEDMODe prompt and commmethod V6Tcpip are specified. - Command line:
- -commm=tcpip
-commm=V6Tcpip
This option is valid only on the initial command line. It is not valid in interactive mode.