The xcomd Command
Use xcomd from the command line to start and stop the
XCOM Data Transportdaemon 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 Transportresources. 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
XCOM Data Transportis 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 Transportalso 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 Transportto initiate transfers. For performing transfers using TCP/IP, your system must be configured for using
XCOM Data Transportwith TCP/IP.
The syntax for using the xcomd command is as follows:
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-coption without they, the system prompts you to confirm this action by typingyfor yes.
This option can cause corruption of the
XCOM Data Transportqueue. It can shut down
XCOM Data Transportwhile it is updating the queue. To prevent problems, delete the queue by deleting all files in $XCOM_HOME/Q after issuing this command.
- -dtracelevelSet the trace level of the daemon process totracelevel. Higher numbers (up to 10) give more trace information. The trace goes to stderr. For more information, see How to Trace Problems.
- -rReport the release level of xcomd and exit.
- -sStop theXCOM Data Transportdaemon by sending a request to the scheduler.Note:This option does not stop the daemon immediately if there is an active transfer going on.
To start xcomd, enter the following command at the system prompt:
Ensure the XCOM_HOME environment variable is set to the
XCOM Data Transportinstall directory that is selected during installation.
The options for xcomd are described in the previous Options topic.