dcmqrti: programme client Telnet de l'initiateur du terminal
SYNOPSIS
dcmqrti [options] peer...
DESCRIPTION
Le programme dcmqrti (initiateur telnet) est un programme interactif en mode caractère destiné à examiner les bases de données d'images de dcmqrscp et à envoyer aux nœuds fournisseurs les images qu'elles contiennent. Lors d'une démonstration DICOM, un fournisseur peut activer le programme dcmqrti en se connectant à l'ordinateur exécutant le programme dcmqrscp. Chaque fournisseur dispose de son propre compte de connexion, et le programme dcmqrti est lancé à sa connexion à la place d'un shell normal.
Le programme dcmqrti prend un argument principal : le nom d'hôte ou le nom symbolique du fournisseur (tiré de la VendorTable du fichier de configuration). Il recherche ensuite dans le fichier de configuration tous les AE Title associés à ce nom d'hôte ou à ce nom de fournisseur, ainsi que toutes les zones de stockage accessibles à partir de ces AE Title. Ainsi, seules les bases de données accessibles et les applications homologues recensées dans le fichier de configuration sont proposées comme choix dans l'interface utilisateur de dcmqrti.
PARAMÈTRES
peer peer host name or symbolic name from cfg file
OPTIONS
options générales
-h --help- affiche cette aide et quitte
--version- affiche les informations de version et quitte
--arguments- affiche les arguments de ligne de commande développés
-q --quiet- mode silencieux, n'affiche ni avertissements ni erreurs
-v --verbose- mode détaillé, affiche les détails du traitement
-d --debug- mode débogage, affiche les informations de débogage
-ll --log-level [l]evel: string constant- (fatal, error, warn, info, debug, trace) utilise le niveau l pour la journalisation
-lc --log-config [f]ilename: string- utilise le fichier de configuration f pour la journalisation
-c --config [f]ilename: string- utilise le fichier de configuration spécifié (par défaut : /usr/local/etc/dcmtk-
/dcmqrscp.cfg)
options réseau
-to --timeout [s]econds: integer (default: unlimited)- délai d'attente pour les demandes de connexion
-ta --acse-timeout [s]econds: integer (default: 30)- délai d'attente pour les messages ACSE
-td --dimse-timeout [s]econds: integer (default: unlimited)- délai d'attente pour les messages DIMSE
-xi --propose-implicit- ne propose que l'implicit VR little endian TS
-aet --aetitle [a]etitle: string- définit mon AE Title (par défaut : TELNET_INITIATOR)
-pdu --max-pdu [n]umber of bytes: integer (4096..131072)- définit la taille PDU maximale de réception à n octets (par défaut : utilise la valeur du fichier de configuration)
autres options
-u --disable-new-vr- désactive la prise en charge des nouvelles VR, convertit en OB
-rmt --remote [t]itle: string- se connecte à la base de données distante définie dans le fichier de configuration
dcmqrti_NOTES
Commandes
Toutes les commandes peuvent être abrégées. Une abréviation est autorisée si elle n'entre pas en conflit avec une autre commande.
Commande "help"
La commande "help" affiche un résumé de toutes les commandes disponibles. Sa sortie est présentée ci-dessous. Afin de les distinguer du texte environnant, tous les exemples sont encadrés par des lignes de tirets. Ces lignes n'apparaissent pas lors de l'exécution du programme.
------------------------------------------------------------
Command Summary:
help list this summary
? short help
title [#] list [set] current peer AE title
database [#] list [set] current database
study [#] list [set] current study
series [#] list [set] current series
image [#] list [set] current image
display [#] display current [specific] image
send study [#] send current [specific] study
send series [#] send current [specific] series
send image [#] send current [specific] image
echo [#] verify connectivity [# times]
quit quit program
exit synonym for quit
------------------------------------------------------------
Commande "title"
La commande "title" sans argument permet à l'utilisateur de lister les AE distantes connues. Un exemple de sortie peut ressembler à ceci :
------------------------------------------------------------
Peer AE Titles:
Peer AE HostName:PortNumber
* 0) ACME1 (swallow:2001)
1) ACME2 (swallow:2002)
2) UNITED1 (kolibri:2001)
3) UNITED2 (kolibri:2002)
------------------------------------------------------------
L'AE homologue actuelle est marquée d'un astérisque (*). Chaque AE homologue possède un index (deuxième colonne) qui peut être utilisé comme argument de la commande "title" pour définir l'AE homologue actuelle. La troisième colonne indique l'AE Title de l'AE homologue. La quatrième colonne indique le nom d'hôte et le numéro de port TCP/IP de l'AE homologue.
Lorsqu'elle est invoquée avec un index en argument, la commande "title" définit l'AE homologue actuelle. Le programme dcmqrti tente d'établir une association avec l'AE homologue actuelle lorsqu'on lui demande d'envoyer un study/series/image ou un echo.
Commande "database"
La commande "database" sans argument permet à l'utilisateur de lister les bases de données locales connues (elles correspondent aux AE Title de dcmqrscp). Un exemple de sortie peut ressembler à ceci :
------------------------------------------------------------
Database Titles:
Database
* 0) COMMON
1) ACME_QUERY
2) ACME_STORE
3) UNITED_QUERY
------------------------------------------------------------
La base de données actuelle est marquée d'un astérisque (*). Chaque base de données possède un index (deuxième colonne) qui peut être utilisé comme argument de la commande "database" pour définir la base de données actuelle. La troisième colonne indique le nom de la base de données (c'est-à-dire l'AE Title de dcmqrscp pour la zone de stockage concernée).
Lorsqu'elle est invoquée avec un index en argument, la commande "database" définit la base de données actuelle. La base de données actuelle sert de base aux actions ultérieures propres à la base de données.
Commande "study"
La commande "study" sans argument liste les studies de la base de données actuelle. Un exemple de sortie peut ressembler à ceci :
------------------------------------------------------------
Patient PatientID StudyID
* 0) JACKSON^ANDREW^^^ M4997106 20001
1) GRANT^MARY^^^ F4997108 20002
2) ARTHUR^CHESTER^^^ M4997107 20003
3) JEFFERSON^THOMAS^^^ M4997096 9465
4) MADISON^DOLLY^^^ F4997097 9443
4 Studies in Database: COMMON
------------------------------------------------------------
Le study actuel est marqué d'un astérisque (*). Chaque study possède un index (deuxième colonne) qui peut être utilisé comme argument de la commande "study" pour définir le study actuel. La troisième colonne indique le nom du patient, la quatrième colonne l'ID patient et la cinquième colonne le study ID.
Lorsqu'elle est invoquée avec un index en argument, la commande "study" définit le study actuel. Le study actuel sert de base aux actions ultérieures propres au study.
Commande "series"
La commande "series" sans argument liste les series du study actuel. Un exemple de sortie peut ressembler à ceci :
------------------------------------------------------------
Series Modality SeriesInstanceUID
* 0) 1 MR 1.2.840.113654.2.3.1993.201
1) 2 MR 1.2.840.113654.2.3.1993.202
2) 3 MR 1.2.840.113654.2.3.1993.203
3) 4 MR 1.2.840.113654.2.3.1993.204
4) 5 MR 1.2.840.113654.2.3.1993.205
5 Series in StudyID 05381,
Patient: MONROE^JAMES^^^ (Database: COMMON)
------------------------------------------------------------
La series actuelle est marquée d'un astérisque (*). Chaque series possède un index (deuxième colonne) qui peut être utilisé comme argument de la commande "series" pour définir la series actuelle. La troisième colonne indique le numéro de series, la quatrième colonne la modalité de la series, et la cinquième colonne le series instance UID.
Lorsqu'elle est invoquée avec un index en argument, la commande "series" définit la series actuelle. La series actuelle sert de base aux actions ultérieures propres à la series.
Commande "image"
La commande "image" sans argument liste les images de la series actuelle. Un exemple de sortie peut ressembler à ceci :
------------------------------------------------------------
Image ImageInstanceUID
* 0) 1 1.2.840.113654.2.3.1993.9.123.6.2674
1) 2 1.2.840.113654.2.3.1993.9.123.6.2675
2) 3 1.2.840.113654.2.3.1993.9.123.6.2676
3) 4 1.2.840.113654.2.3.1993.9.123.6.2677
4) 5 1.2.840.113654.2.3.1993.9.123.6.2678
5) 6 1.2.840.113654.2.3.1993.9.123.6.2679
6) 7 1.2.840.113654.2.3.1993.9.123.6.2680
7) 8 1.2.840.113654.2.3.1993.9.123.6.2681
8) 9 1.2.840.113654.2.3.1993.9.123.6.2682
9) 10 1.2.840.113654.2.3.1993.9.123.6.2683
10) 11 1.2.840.113654.2.3.1993.9.123.6.2684
11) 12 1.2.840.113654.2.3.1993.9.123.6.2685
12) 13 1.2.840.113654.2.3.1993.9.123.6.2686
13 Images in MR Series, StudyID 05381,
Patient: MONROE^JAMES^^^ (Database: COMMON)
------------------------------------------------------------
L'image actuelle est marquée d'un astérisque (*). Chaque image possède un index (deuxième colonne) qui peut être utilisé comme argument de la commande "image" pour définir l'image actuelle. La troisième colonne indique le numéro de l'image, et la quatrième colonne l'image instance UID (SOP Instance UID).
Lorsqu'elle est invoquée avec un index en argument, la commande "image" définit l'image actuelle. L'image actuelle sert de base aux actions ultérieures propres à l'image.
Commande "display"
La commande display n'a aucune utilité dans la version actuelle de DCMTK. Elle était utilisée dans les versions antérieures pour demander au CTN Display Program d'afficher une image.
Commande "send"
La commande "send" permet d'enregistrer sur une AE distante un study/series complet ou une image individuelle. Lorsque cette commande est invoquée, le programme dcmqrti fonctionne comme SCU de la DICOM Storage Service Class et tente d'établir une association avec l'AE homologue actuelle (définie via la commande "title"). Les contextes de présentation pour toutes les Storage SOP Class concernées sont proposés. Une tentative d'enregistrement de toutes les images spécifiées est effectuée. Si aucune association n'a pu être négociée, un message d'erreur est affiché. Si une opération de stockage échoue ou si aucun contexte de présentation approprié n'est disponible, un message d'erreur est affiché.
The "send" command exists in three forms:
send study [#]
send series [#]
send image [#]
Le mot-clé "study" signifie l'envoi de toutes les images du study actuel. Lorsqu'elle est invoquée avec un index en argument, le study spécifié dans la base de données actuelle est enregistré. Le mot-clé "series" signifie l'envoi de toutes les images de la series actuelle. Lorsqu'elle est invoquée avec un index en argument, la series spécifiée dans le study actuel est enregistrée. Le mot-clé "image" signifie l'envoi de l'image actuelle. Lorsqu'elle est invoquée avec un index en argument, l'image spécifiée dans la series actuelle est enregistrée.
Lorsqu'une image est enregistrée, un message de la forme suivante est affiché :
------------------------------------------------------------
New Association Started (swallow:2001,ACME1)
[MsgID 1] Store,
PatientName: JACKSON^ANDREW^^^, StudyID: 20001,
Series: 2, Modality: CR, Image: 1,
Image UID: 1.2.840.113654.2.3.1993.9.123.6.1834
0%________25%_________50%__________75%________100%
--------------------------------------------------
[MsgID 1] Complete [Status: Success]
Released Association (swallow:2001,ACME1)
------------------------------------------------------------
Commande "echo"
La commande "echo" permet à l'utilisateur de vérifier la connectivité avec l'AE homologue actuelle (définie via la commande "title"). Une fois invoqué, le programme dcmqrti agit comme SCU de la Verification Service Class.
Sans argument, un seul message C-ECHO est généré. Avec un argument, le nombre indiqué de messages C-ECHO est envoyé. Un message de la forme suivante est affiché :
------------------------------------------------------------
New Association Started (localhost:2001,CMOVE)
[MsgID 1] Echo, Complete [Status: Success]
Released Association (localhost:2001,CMOVE)
------------------------------------------------------------
Commandes "quit", "exit"
Les commandes "quit" et "exit" ont le même effet. Elles mettent fin au programme dcmqrti.
Conformité DICOM
L'application dcmqrti prend en charge, en tant que SCU, le même ensemble de SOP Class que l'application dcmqrscp. Consultez la documentation de dcmqrscp.
L'application dcmqrti propose des contextes de présentation pour toutes les SOP Class prises en charge mentionnées ci-dessus, en utilisant les syntaxes de transfert suivantes :
LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
L'application dcmqrti ne prend pas en charge la négociation étendue.
Configuration
Le programme dcmqrti utilise le même fichier de configuration que le programme dcmqrscp. Consultez la documentation relative à la configuration pour plus d'informations (dcmqrcnf.txt et l'exemple de fichier de configuration dcmqrscp.cfg).
JOURNALISATION
Le niveau de détail de la journalisation des différents outils en ligne de commande et des bibliothèques sous-jacentes peut être spécifié par l'utilisateur. Par défaut, seules les erreurs et les avertissements sont écrits dans le flux d'erreur standard. L'option –verbose permet également de signaler des messages d'information tels que les détails du traitement. L'option –debug permet d'obtenir plus de détails sur l'activité interne, par exemple à des fins de débogage. L'option –log-level permet de sélectionner d'autres niveaux de journalisation. En mode –quiet, seules les erreurs fatales sont signalées. Dans de tels cas d'erreur très graves, l'application se termine généralement. Pour plus de détails sur les différents niveaux de journalisation, consultez la documentation du module "oflog".
Si la sortie de la journalisation doit être écrite dans un fichier (éventuellement avec rotation des fichiers journaux), vers syslog (Unix) ou le journal des événements (Windows), l'option –log-config peut être utilisée. Ce fichier de configuration permet également de diriger uniquement certains messages vers un flux de sortie particulier et de filtrer certains messages en fonction du module ou de l'application qui les génère. Un exemple de fichier de configuration est fourni dans < etcdir>/logger.cfg.
LIGNE DE COMMANDE
Tous les outils en ligne de commande utilisent la notation suivante pour les paramètres : les crochets entourent les valeurs facultatives (0-1), trois points de suspension à la fin indiquent que plusieurs valeurs sont autorisées (1-n), et la combinaison des deux signifie de 0 à n valeurs.
Les options de la ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête. En général, l'ordre et la position des options de la ligne de commande sont arbitraires (c'est-à-dire qu'elles peuvent apparaître n'importe où). Toutefois, si des options s'excluent mutuellement, c'est la dernière occurrence, la plus à droite, qui est utilisée. Ce comportement est conforme aux règles d'évaluation standard des shells Unix courants.
De plus, un ou plusieurs fichiers de commandes peuvent être spécifiés en utilisant un signe '@' comme préfixe du nom de fichier (par exemple @command.txt). Un tel argument de commande est remplacé par le contenu du fichier texte correspondant (les espaces multiples sont traités comme un séparateur unique, sauf s'ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Notez qu'un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace permet de regrouper des combinaisons courantes d'options/paramètres et évite des lignes de commande longues et peu lisibles (un exemple est fourni dans le fichier < datadir>/dumppat.txt).
ENVIRONNEMENT
L'utilitaire dcmqrti tente de charger les dictionnaires de données DICOM spécifiés dans la variable d'environnement DCMDICTPATH. Par défaut, c'est-à-dire si la variable d'environnement DCMDICTPATH n'est pas définie, le fichier < datadir>/dicom.dic est chargé, sauf si le dictionnaire est intégré à l'application (par défaut sous Windows).
Il est préférable de conserver le comportement par défaut et de n'utiliser la variable d'environnement DCMDICTPATH que lorsque des dictionnaires de données alternatifs sont nécessaires. La variable d'environnement DCMDICTPATH a le même format que la variable PATH des shells Unix, en ce sens que les deux-points (":") séparent les entrées. Sur les systèmes Windows, le point-virgule (";") est utilisé comme séparateur. Le code du dictionnaire de données tente de charger chaque fichier spécifié dans la variable d'environnement DCMDICTPATH. C'est une erreur si aucun dictionnaire de données ne peut être chargé.
FICHIERS
< docdir>/dcmqrcnf.txt - informations de configuration
< docdir>/dcmqrset.txt - informations d'installation
< etcdir>/dcmqrscp.cfg - exemple de fichier de configuration
VOIR AUSSI
dcmqrscp(1)
COPYRIGHT
Copyright (C) 1993-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.