The xcomd Command

Contents
xdtful
Use xcomd from the command line to start and stop the 
XCOM Data Transport
 daemon process, to kill the daemon process, to set trace levels, and to report the release level of xcomd.
The xcomd command controls the daemon. The daemon itself runs as a background process to control file transfers and manage 
XCOM Data Transport
 resources. The daemon does the following tasks:
  • Schedules and synchronizes transfer requests.
  • Controls shared memory for transfers.
  • Establishes the default parameter values by reading the parameter file, xcom.glb and then running in the background.
  • Controls the automatic restart of locally initiated transfers.
  • Writes queue information out to disk periodically.
  • Deletes aged entries from the queue.
  • Notifies a local user by executing the xcomntfy script when LOCAL_NOTIFY is required.
  • Communicates with active or pending transfers to terminate a transfer.
Control the Daemon
When 
XCOM Data Transport
 is installed, the superuser (root) has permission to control the daemon. Without authorized permission, other users cannot control the daemon. Users are typically given permission to perform transfers and check the status of the queue.
The daemon must be running before you can do any transfers. For performing transfers using SNA protocols, 
XCOM Data Transport
 also requires an active LU 6.2 session to transfer files. Once an LU 6.2 session is established, local users can begin using 
XCOM Data Transport
 to initiate transfers. For performing transfers using TCP/IP, your system must be configured for using 
XCOM Data Transport
 with TCP/IP.
Syntax
The syntax for using the xcomd command is as follows:
xcomd
option
Options
The following table explains the options for xcomd:
  • -c[y]
    Kill the daemon process and free shared memory. This option stops the daemon while transfers are running.
    Note: 
    Use this option as a last resort because it brings the scheduler down immediately, whether there are running or scheduled transfers. If you use the 
    -c 
    option without the 
    y
    , the system prompts you to confirm this action by typing 
    for yes.
This option can cause corruption of the
XCOM Data Transport
queue. It can shut down 
XCOM Data Transport
while it is updating the queue. To prevent problems, delete the queue by deleting all files in $XCOM_HOME/Q after issuing this command.
  • -d
    tracelevel
     
    Set the trace level of the daemon process to
     tracelevel
    . Higher numbers (up to 10) give more trace information. The trace goes to stderr. For more information, see How to Trace Problems.
  • -r
    Report the release level of xcomd and exit.
  • -s
    Stop the 
    XCOM Data Transport
     daemon by sending a request to the scheduler.
    Note: 
    This option does not stop the daemon immediately if there is an active transfer going on.
Start xcomd
To start xcomd, enter the following command at the system prompt:
$XCOM_HOME/sbin/xcomd
Ensure the XCOM_HOME environment variable is set to the 
XCOM Data Transport
 install directory that is selected during installation.
The options for xcomd are described in the previous Options topic.