rxque(1)

NAME
rxque - data queue server

SYNOPSIS
rxque [ -csh | filename ]

DESCRIPTION
rxque is a daemon which serves a data queue, normally used by rexx(1) which starts it automatically, although it can be started manually. It runs in the background and accepts requests from rxstack(1) or from Rexx programs until terminated with signal 15.

USAGE
The server communicates with clients via a Unix-domain socket. If a filename parameter is given, rxque uses this as the name of the socket and prints the process id of the server to its standard output. This should be saved and used to terminate the server with signal 15 when it is no longer required. If no filename parameter is supplied, rxque generates a filename of its own and outputs both the filename and the process id to its standard output in the form of settings for the environment variables RXSTACK and RXSTACKPROC, respectively. The default format is two `NAME=value' pairs, suitable for interpretation by a Bourne shell. If the -csh flag is supplied then the format will be two `setenv' commands suitable for interpretation by a C-shell. Writing a command such as:

eval `rxque -csh`

will thus set the environment variables.

The variable RXSTACK containing the socket file name must be exported to the environment in order for clients to be able to use the stack.

OPTIONS

-csh
    Use the `setenv' format of output.

filename
    Use the filename as the name of the socket and just output the process id of the server.

ENVIRONMENT

RXSTACK
    The name of the socket used for communication with the server.

RXSTACKPROC
    The process id of the server.

SEE ALSO
rxstack(1), rexx(1), The REXX/imc documentation.

AUTHOR
Ian Collier <imc@comlab.ox.ac.uk>