Los mandatos del programa de utilidad de colas se
componen de operaciones y modificadores.
La sintaxis básica de un mandato de programa de
utilidad de colas es:
qutil -operation qname -modifier
qname
es el nombre de la cola.
Operaciones de mandato
Las operaciones definen las diferentes funciones del programa de utilidad de colas.
Sólo se
puede añadir una operación al mandato qutil.
- -C
- Crea una nueva cola. Necesita un nombre exclusivo para qname. Debe ser una C en mayúsculas.
- -f
- Copia la entrada estándar en la cola. Requiere un qname.
- -i
- Copia la entrada estándar en muchas colas. Requiere que el nombre de sección esté definido en el archivo qutil.ini. Especifica una sección de qutil.ini para cargar y entregar mensajes a muchas colas.
- -k
- Depura el recuento para cada registro. Requiere un qname. Se puede utilizar junto con el modificador -c para limitar el número de registros procesados.
- -p
- Recuento máximo para cada registro. No elimina registros de la cola. Requiere un qname. Graba en la salida estándar. Se puede utilizar junto con el modificador -c para limitar el número de registros procesados.
- -r
- Recuento de lecturas para cada registro. Elimina registros de la cola. Requiere un qname. Graba en la salida estándar. Se puede utilizar junto con el modificador -c para limitar el número de registros procesados.
- -s
- Estado de la cola. Requiere un qname.
- -x
- Suprime qname. Requiere un qname.
Por ejemplo,
Para escribir los datos de salida en varias colas de datos
adquiridos directamente desde un proceso (tal como
AFP).
qutil -i sectionname < sourcefile
Modificadores de mandato
Los modificadores configuran parámetros adicionales para una operación de
programa de utilidad de colas. Puede utilizar más de un modificador en un mandato qutil.
- -T
- Transactional Especifica si una cola es transaccional.
Por omisión, todas las colas nuevas son no transaccionales, a menos que se haya especificado durante la creación como transaccionales con un modificador -T.
Las
colas transaccionales no se deben utilizar cuando una cola puede recibir información de direccionamiento desde un supervisor
de aplicaciones.
Las colas transaccionales de Microsoft Message Queueing no permiten establecer un orden de prioridad
ni procesar los mensajes en otro orden que no sea en el que se han recibido.
- -c
- Count Especifica que se debe detener después de se hayan procesado los registros de recuento.
Necesita un entero. Debe ser una c en minúsculas.
- -l
- Priority Especifica el nivel de prioridad para cada registro. Necesita un entero.
- Los niveles de prioridad de Microsoft Message Queueing son de 0 a 7, donde 0 es el más bajo, 7 es el más alto y 3 es el valor por omisión.
- Los niveles de prioridad de IBM WebSphere MQ son de 0 a 9, donde 0 es el más bajo y 9 el más alto. El valor por omisión depende una propiedad de cola. Puede cambiar esta prioridad en el gestor de colas.
- -m (para
UNIX
solamente)
- Queue Manager Especifica el gestor de colas.
- -o
- Expire Especifica el número de segundos antes de que caduque un mensaje.
Necesita un entero.
- -t
- Pause Especifica el número de milisegundos que se debe esperar entre cada registro. Necesita un entero.
Relaciones entre operaciones y modificadores de mandatos
Sólo se recomienda el uso de determinados modificadores en determinadas operaciones. En la siguiente tabla se describe la relación de cada operación con los modificadores potenciales:
Tabla 1. Relaciones entre operaciones y modificadores de mandatos del programa de utilidad de colaOperación |
Modificadores
válidos |
-C
|
-T
EJEMPLO: qutil -C qname [-T] |
-f
|
-c, -t, -l, -o
EJEMPLO: qutil -f qname [-c count] [-t pause] [-l priority] [-o expire] |
-i
|
NONE EJEMPLO: qutil -i configsection |
-k
|
-c
EJEMPLO: qutil -k qname [-c count] |
-p
|
-c
EJEMPLO qutil -p qname [-c count] |
-r
|
-c
EJEMPLO qutil -r qname [-c count] |
-s
|
NONE EJEMPLO: qutil -s qname |
-x
|
NONE EJEMPLO: qutil -x qname |