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.

AUTHOR

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