Les commandes de l'utilitaire de file d'attente se composent d'opérations et de modificateurs.
La syntaxe élémentaire d'une commande d'utilitaire de file d'attente est la suivante :
qutil -operation qname -modifier
qname est le nom de la file d'attente.
Opérations de commande
Les opérations définissent les diverses fonctions de l'utilitaire de file d'attente.
Vous
ne pouvez ajouter qu'une seule opération à une commande qutil.
- -C
- Crée une nouvelle file d'attente. Exige un nom unique comme nom de file d'attente. Lettre
'C' majuscule obligatoire.
- -f
- Copie stdin dans la file d'attente. Nécessite un nom de file
d'attente (qname).
- -i
- Copie stdin dans plusieurs files d'attente. Nécessite un nom de section
comme défini dans le fichier qutil.ini. Indique une section du fichier
qutil.ini à charger pour la distribution des messages dans plusieurs files
d'attente.
- -k
- Nombre de purges de chaque enregistrement. Nécessite un nom de file
d'attente (qname). Peut s'utiliser conjointement avec le modificateur -c afin de limiter le nombre
d'enregistrements traités.
- -p
- Nombre de consultations rapides de chaque enregistrement. Ne supprime pas les enregistrements de la file d'attente. Nécessite un nom de file
d'attente (qname). Ecrit dans stdout. Peut s'utiliser conjointement avec le modificateur -c afin de limiter le nombre
d'enregistrements traités.
- -r
- Nombre de lectures de chaque enregistrement. Supprime les enregistrements de la file d'attente. Nécessite un nom de file
d'attente (qname). Ecrit dans stdout. Peut s'utiliser conjointement avec le modificateur -c afin de limiter le nombre
d'enregistrements traités.
- -s
- Etat de la file d'attente. Nécessite un nom de file
d'attente (qname).
- -x
- Supprime un nom de file d'attente (qname). Nécessite un nom de file
d'attente (qname).
Par exemple,
Pour des sorties vers plusieurs files
d'attente à partir de données extraites directement d'un processus (tel que
AFP).
qutil -i sectionname < fichier_source
Modificateurs de commande
Les modificateurs configurent des paramètres complémentaires pour une opération d'utilitaire de filed'attente. Vous pouvez utiliser plusieurs modificateurs dans une commande qutil.
- -T
- Transactionnelle Indique si une file d'attente est transactionnelle.
Par défaut, toutes les nouvelles files d'attente sont non
transactionnelles, excepté si elles ont été définies comme transactionnelles
dès leur création avec un modificateur -T.
Les files d'attente transactionnelles ne doivent pas être
utilisées quand elles sont susceptibles de recevoir des informations
d'acheminement issues d'un moniteur d'application.
Dans Microsoft Message Queueing, elles ne permettent pas de classer
les messages par ordre de priorité ni de les traiter dans un ordre autre que celui de réception.
- -c
- Nombre Indique qu'il faut arrêter une fois qu'un certain nombre
d'enregistrements a été traité.
Nombre entier obligatoire. Lettre 'c' minuscule.
- -l
- Priorité Indique le niveau de priorité de chaque enregistrement. Nombre entier obligatoire.
- Les niveaux de priorité Microsoft Message Queueing vont de 0 à 7, sachant que 0 est le
plus bas, 7 le plus élevé et 3 le niveau par défaut.
- Les niveaux de priorité IBM Websphere MQ vont de 0 à 9, sachant que 0 est le
plus bas, 9 le plus élevé. La valeur par défaut dépend
d'une propriété de file d'attente. Vous pouvez modifier cette propriété dans
votre gestionnaire de file d'attente.
- -m (UNIX uniquement)
- Gestionnaire de files d'attente Désigne le gestionnaire de files d'attente.
- -o
- Expiration Indique le nombre de secondes avant l'expiration d'un message.
Nombre entier obligatoire.
- -t
- Pause Indique le délai d'attente en millisecondes entre chaque enregistrement. Nombre entier obligatoire.
Relations entre opérations et modificateurs de commande
Certains modificateurs ne sont recommandés que pour certaines opérations. La
table suivante décrit la relation de chaque opération avec ses modificateurs
potentiels :
Tableau 1. Relations entre opérations et modificateurs de commande de l'utilitaire de file d'attenteOpération |
Modificateurs valides |
-C
|
-T
EXEMPLE : qutil -C qname [-T] |
-f
|
-c, -t, -l, -o
EXEMPLE : qutil -f qname [-c count] [-t pause] [-l priority] [-o expire] |
-i
|
AUCUN EXEMPLE : qutil -i configsection |
-k
|
-c
EXEMPLE : qutil -k qname [-c count] |
-p
|
-c
EXEMPLE : qutil -p qname [-c count] |
-r
|
-c
EXEMPLE : qutil -r qname [-c count] |
-s
|
AUCUN EXEMPLE : qutil -s qname |
-x
|
AUCUN EXEMPLE : qutil -x qname |