Format
uucico [–f]
[–g grade] [–r0|–r1]
[–s system] [–x type]
Description
The uucico daemon
processes file transfer requests that were queued by uucp and uux.
It establishes the connection with remote sites and manages the transfer
of data between the local and remote sites as specified by the queued uucp or uux job.
uucico is
automatically invoked after the uucp or uux command
completes (unless the –r option was specified
on the uucp or uux command).
To process requests that cannot be successfully completed at the time
the uucp or uux command
was executed and to initiate transfers from remote sites, the traditional
approach is to use cron to start uucico at
regular intervals. (See z/OS UNIX System Services Planning for
more information about using cron to
start uucico. It contains information about
creating crontab entries.)
uucico has
two modes: slave mode and master mode.
- In slave mode, uucico receives
requests from the remote site. The –r0 option
(the default option) starts uucico in slave
mode. uucico is typically started in slave
mode by either the uucpd daemon (for remote connections via
TCP/IP) or as the login shell for special UUCP user IDs that can be
logged onto via serial connections. See uucpd and uucp for
more information.
- In master mode, uucico processes
requests from the local site; the –r1 and –s options
start uucico in master mode. uucico is
typically started in master mode via cron. uucp and uux also
invoke uucico in master mode by default.
If uucico cannot contact a
remote system, it does not allow itself to run again until a specified
amount of time has passed. You can specify how long the daemon should
wait before trying to call each system again by setting a parameter
in the Permissions file. For information about the permissions file,
see z/OS UNIX System Services Planning.
If uucico receives
a SIGQUIT, SIGTERM or SIGPIPE signal, it ends any current conversation
with a remote site and exits.
Options
- –f
- Ignores the required wait period for all remote systems and makes
calls as requested.
- –g grade
- Processes outgoing work only if it is designated priority grade or
better. grade is a number (0–9)
or letter (A–Z, a–z), where 0 is
the highest priority and z is the lowest.
- r0 | –r1
- Specifies the mode for uucico to use. r0 (the
default) specifies slave mode; r1 specifies
master mode. If you want uucico to call
a remote system (master mode), specify –r1.
- –s system
- Calls the remote system. By default, uucico calls
all defined systems.
- –x type
- Turns on debugging. type is a number
indicating the level of detail. 0 is the least detail
and 9 is the most detail. The debugging output is
written to stderr if uucico is run
in the foreground, or to /usr/spool/uucp/LOGFILE if uucico is
run in the background by uucpd or by a remote uucico logging
into a UUCP user ID.
The LOGFILE must be monitored so that it
does not fill up your file system.
Examples
To call the remote site
west,
with debugging output sent to
stdout:
uucico –r1 –x 9 –s west
Files
uucico uses
the following files:
- /usr/lib/uucp/config
- UUCP
configuration file. See uucc.
- /usr/spool/uucp/LOGFILE
- UUCP debug file
- /usr/spool/locks
- The directory containing the lock
files created by uucico.
- /usr/spool/uucp/.Status
- UUCP status file
Exit values
- 0
- Successful completion
- 1
- Failure due to any of the following:
- Unknown command-line option
- Not running setuid uucp
- Argument list too long
- Unable to open log file
- CTRL-C interrupt
Portability
X/Open Portability Guide.
Related information
uucc, uucp, uulog, uux, uuxqt