PLTR(1ICD)

NAME
pltr - plot queue entry processor

SYNOPSIS
pltr [options]

OPTIONS

-h hostname
    Perform action with queue on host hostname, else use default specified in "hosts_pltr". For example "qplot -h hostx ..." sending plot to queue on hostx.

-xd username [host]
    Equal to "pltrm -a" for specified user. If the queue entries are from another host, host must be specified.

-xd id [host]
    Equal to "pltrm id". If the queue entry is from another host, host must be specified.

-xh Put queue in the hold-state (at end of cluster being plotted).

-xh username [host]
    Hold all entries of specified user. If the queue entries are from another host, host must be specified.

-xh id [host]
    Hold entry with specified id. If the queue entry is from another host, host must be specified.

-xhk
    Kill currently active plot process in a descent way. It also removes the lock file and puts the queue in the hold state.

-xhl
    Removes the lock file after some crash. It puts the queue in the hold state.

-xr Release queue, start plotting.

-xr0
    Release queue, start plotting, fill up full A0.

-xr1
    Release queue, start plotting, restrict to A1.

-xr username [host]
    Release all held entries of specified user. If the queue entries are from another host, host must be specified.

-xr id [host]
    Release held entry with specified id. If the queue entry is from another host, host must be specified.

-xp username [host]
    Give priority to all entries of specified user. If the queue entries are from another host, host must be specified.

-xp id [host]
    Give priority to entry with specified id. If the queue entry is from another host, host must be specified.

DESCRIPTION
The pltr program is normally invoked through the qplot program to make plots, and should not be invoked directly to make plots (unless you know what you are doing).

Pltr can be used by a number of privileged users (and root) to perform some other actions, such as setting the queue in the hold-state or releasing the queue, giving a plot highest priority, or deleting entries. Note that all '-x' options (except '-xd') are privileged. See the options for detailed information.

Use pltq to find the id, the host, and username of entries in the plot-queue.

EXAMPLES
$ pltr -xd 00352 -h dutentb Deletes the entry with id 00352 on remote host dutentb. $ pltr -xr robert dutentc -h dutentb Releases the hold entries of user robert that came from dutentc on remote host dutentb.

AUTHOR
P.E. Platzbecker

FILES
ICDPATH/lib/hosts_pltr	(on which host the queue is)
ICDPATH/lib/priv_users	(list of privileged users)
/usr/spool/plt	(spool directory)
/usr/spool/plt/c*	(plot-files)
/usr/spool/plt/df*	(control-files)
/usr/spool/uucp/LCK..*	(plot-devices lock-files)

SEE ALSO
hpq(1ICD), pltq(1ICD), pltrm(1ICD), qplot(1ICD)