uuq Command

Purpose

Displays the BNU job queue and deletes specified jobs from the queue.

Syntax

uuq-l -h ] [  -sSystemName ] [  -uUser ] [  -dJobNumber ] [  -rSpoolDir ] [  -bBaudRate ]

Note: Only a user with root authority can use the -d flag.

Description

The uuq command is used to list or delete job entries in the Basic Networking Utilities (BNU) job queue.

When listing jobs, the uuq command uses a format similar to that used by the ls command. In the default format, the uuq command lists only the job numbers of the jobs waiting in the queue, followed by a summary line for each system.

In summary format (uuq -h) only the summary lines are listed. Summary lines give:

  • System name
  • Number of jobs for the system
  • Total number of bytes to send

In the long format (uuq -l), which can be quite slow, the information listed for each job is:

  • Job number
  • Number of files to transfer
  • User who sent the job
  • Number of bytes to be sent
  • Type of job requested:
    Item Description
    S Sending a file
    R Receiving a file
    X Executing a command on the remote system
  • File to be sent or received or the command to be executed

A user with root authority can use the -dJobNumber flag to delete jobs from the queue after running a uuq listing to discover the job numbers.

Flags

Item Description
-bBaudRate Uses the baud rate given, instead of the default (1200 baud), to compute the transfer time.
-d JobNumber Deletes the job designated by the JobNumber variable from the BNU queue. Only someone with root authority can delete jobs from the queue.
-h Shows only the summary lines for each system.
-l Lists the output in the long format.
-sSystemName Lists only jobs for systems whose system names begin with the string specified in the SystemName variable.
-r SpoolDir Searches for files in the spooling directory designated by the SpoolDir variable, instead of in the default spooling directory.
-uUser Lists only jobs queued by users whose login names begin with the string specified in the User variable.

Examples

  1. To get a long listing of all jobs spooled for system hera, type:
    uuq  -l  -shera
  2. To get a summary listing for all systems, type:
    uuq  -h
  3. To delete a job for user nita from the queue, first use the uuq command to find the number of the job you want to delete, as follows:
    uuq  -l  -unita
    This produces a list of jobs spooled for user nita. Find the job you wish to remove. If its job number is 13451, for example, the following command will delete the job:
    uuq  -d13451
    Note: You must have root authority or be logged in as uucp to delete jobs from the queue.

Files

Item Description
/usr/bin/uuq Contains the uuq command.
/var/spool/uucp/SystemName Contains spool files for the remote system designated by SystemName.
/var/spool/uucp/SystemName/C.* Contain instructions for file transfers.
/var/spool/uucp/SystemName/D.* Contain information about data files to be transferred.
/var/spool/uucp/SystemName/X.* Contain instructions for executing remote commands.