dcmqrti: cliente Telnet do iniciador de terminal
SINOPSE
dcmqrti [options] peer...
DESCRIÇÃO
O aplicativo dcmqrti (iniciador telnet) é um programa interativo baseado em caracteres destinado a examinar os bancos de dados de imagens do dcmqrscp e a enviar as imagens neles contidas para os nós dos fornecedores. Durante uma demonstração DICOM, o programa dcmqrti pode ser ativado por um fornecedor ao se conectar ao computador que executa o programa dcmqrscp. Cada fornecedor tem sua própria conta de login, e o programa dcmqrti é iniciado no lugar de um shell normal quando ele faz login.
O programa dcmqrti recebe um argumento principal: o nome de host ou o nome simbólico do fornecedor (da VendorTable no arquivo de configuração). Em seguida, ele pesquisa no arquivo de configuração todos os AE Title associados a esse nome de host ou nome de fornecedor, bem como todas as áreas de armazenamento acessíveis a esses AE Title. Assim, apenas os bancos de dados acessíveis e as aplicações pares encontrados no arquivo de configuração ficam disponíveis como opções na interface de usuário do dcmqrti.
PARÂMETROS
peer peer host name or symbolic name from cfg file
OPÇÕES
opções gerais
-h --help- exibe este texto de ajuda e sai
--version- exibe as informações de versão e sai
--arguments- exibe os argumentos de linha de comando expandidos
-q --quiet- modo silencioso, não exibe avisos nem erros
-v --verbose- modo detalhado, exibe os detalhes do processamento
-d --debug- modo de depuração, exibe informações de depuração
-ll --log-level [l]evel: string constant- (fatal, error, warn, info, debug, trace) usa o nível l para o logger
-lc --log-config [f]ilename: string- usa o arquivo de configuração f para o logger
-c --config [f]ilename: string- usa um arquivo de configuração específico (padrão: /usr/local/etc/dcmtk-
/dcmqrscp.cfg)
opções de rede
-to --timeout [s]econds: integer (default: unlimited)- tempo limite para solicitações de conexão
-ta --acse-timeout [s]econds: integer (default: 30)- tempo limite para mensagens ACSE
-td --dimse-timeout [s]econds: integer (default: unlimited)- tempo limite para mensagens DIMSE
-xi --propose-implicit- propõe apenas a TS implicit VR little endian
-aet --aetitle [a]etitle: string- define meu AE Title (padrão: TELNET_INITIATOR)
-pdu --max-pdu [n]umber of bytes: integer (4096..131072)- define o PDU máximo de recepção como n bytes (padrão: usa o valor do arquivo de configuração)
outras opções
-u --disable-new-vr- desabilita o suporte a novas VRs, converte para OB
-rmt --remote [t]itle: string- conecta ao banco de dados remoto definido no arquivo de configuração
dcmqrti_NOTES
Comandos
Todos os comandos podem ser abreviados. Uma abreviação é permitida se não entrar em conflito com outro comando.
Comando "help"
O comando "help" apresenta um resumo de todos os comandos disponíveis. Sua saída é mostrada a seguir. Para separar os exemplos do texto ao redor, todos os exemplos são delimitados por linhas tracejadas. Essas linhas não aparecem ao executar o programa.
------------------------------------------------------------
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
------------------------------------------------------------
Comando "title"
O comando "title" sem argumento permite ao usuário listar as Application Entities (AE) remotas conhecidas. Um exemplo de saída pode ser assim:
------------------------------------------------------------
Peer AE Titles:
Peer AE HostName:PortNumber
* 0) ACME1 (swallow:2001)
1) ACME2 (swallow:2002)
2) UNITED1 (kolibri:2001)
3) UNITED2 (kolibri:2002)
------------------------------------------------------------
A AE par atual é marcada com um asterisco (*). Cada AE par tem um índice (segunda coluna) que pode ser usado como argumento do comando "title" para definir a AE par atual. A terceira coluna informa o AE Title da AE par. A quarta coluna mostra o nome de host e o número da porta TCP/IP da AE par.
Quando invocado com um índice como argumento, o comando "title" define a AE par atual. O programa dcmqrti tentará iniciar uma associação com a AE par atual quando solicitado a enviar um study/series/image ou um echo.
Comando "database"
O comando "database" sem argumento permite ao usuário listar os bancos de dados locais conhecidos (que correspondem aos AE Title do dcmqrscp). Um exemplo de saída pode ser assim:
------------------------------------------------------------
Database Titles:
Database
* 0) COMMON
1) ACME_QUERY
2) ACME_STORE
3) UNITED_QUERY
------------------------------------------------------------
O banco de dados atual é marcado com um asterisco (*). Cada banco de dados tem um índice (segunda coluna) que pode ser usado como argumento do comando "database" para definir o banco de dados atual. A terceira coluna mostra o nome do banco de dados (ou seja, o AE Title do dcmqrscp para a área de armazenamento em questão).
Quando invocado com um índice como argumento, o comando "database" define o banco de dados atual. O banco de dados atual serve de base para as ações subsequentes específicas do banco de dados.
Comando "study"
O comando "study" sem argumento lista os studies do banco de dados atual. Um exemplo de saída pode ser assim:
------------------------------------------------------------
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
------------------------------------------------------------
O study atual é marcado com um asterisco (*). Cada study tem um índice (segunda coluna) que pode ser usado como argumento do comando "study" para definir o study atual. A terceira coluna mostra o nome do paciente, a quarta coluna o ID do paciente e a quinta coluna o study ID.
Quando invocado com um índice como argumento, o comando "study" define o study atual. O study atual serve de base para as ações subsequentes específicas do study.
Comando "series"
O comando "series" sem argumento lista as series do study atual. Um exemplo de saída pode ser assim:
------------------------------------------------------------
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)
------------------------------------------------------------
A series atual é marcada com um asterisco (*). Cada series tem um índice (segunda coluna) que pode ser usado como argumento do comando "series" para definir a series atual. A terceira coluna mostra o número da series, a quarta coluna a modalidade da series, e a quinta coluna o series instance UID.
Quando invocado com um índice como argumento, o comando "series" define a series atual. A series atual serve de base para as ações subsequentes específicas da series.
Comando "image"
O comando "image" sem argumento lista as imagens da series atual. Um exemplo de saída pode ser assim:
------------------------------------------------------------
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)
------------------------------------------------------------
A imagem atual é marcada com um asterisco (*). Cada imagem tem um índice (segunda coluna) que pode ser usado como argumento do comando "image" para definir a imagem atual. A terceira coluna mostra o número da imagem, e a quarta coluna o image instance UID (SOP Instance UID).
Quando invocado com um índice como argumento, o comando "image" define a imagem atual. A imagem atual serve de base para as ações subsequentes específicas da imagem.
Comando "display"
O comando display não tem finalidade na versão atual do DCMTK. Ele era usado em versões anteriores para solicitar ao CTN Display Program a exibição de uma imagem.
Comando "send"
O comando "send" permite armazenar em uma AE remota um study/series completo ou uma imagem individual. Quando esse comando é invocado, o programa dcmqrti opera como SCU da DICOM Storage Service Class e tenta iniciar uma associação com a AE par atual (definida por meio do comando "title"). Contextos de apresentação para todas as Storage SOP Class relevantes serão propostos. Será feita uma tentativa de armazenar todas as imagens especificadas. Se nenhuma associação puder ser negociada, uma mensagem de erro será exibida. Se uma operação de armazenamento falhar ou se nenhum contexto de apresentação apropriado estiver disponível, uma mensagem de erro será exibida.
The "send" command exists in three forms:
send study [#]
send series [#]
send image [#]
A palavra-chave "study" significa enviar todas as imagens do study atual. Quando invocado com um índice como argumento, o study especificado no banco de dados atual será armazenado. A palavra-chave "series" significa enviar todas as imagens da series atual. Quando invocado com um índice como argumento, a series especificada no study atual será armazenada. A palavra-chave "image" significa enviar a imagem atual. Quando invocado com um índice como argumento, a imagem especificada na series atual será armazenada.
Quando uma imagem é armazenada, uma mensagem no seguinte formato é exibida:
------------------------------------------------------------
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)
------------------------------------------------------------
Comando "echo"
O comando "echo" permite ao usuário verificar a conectividade com a AE par atual (definida por meio do comando "title"). Ao ser invocado, o programa dcmqrti age como SCU da Verification Service Class.
Quando invocado sem argumento, apenas uma mensagem C-ECHO é gerada. Quando invocado com argumento, o número especificado de mensagens C-ECHO é enviado. Uma mensagem no seguinte formato é exibida:
------------------------------------------------------------
New Association Started (localhost:2001,CMOVE)
[MsgID 1] Echo, Complete [Status: Success]
Released Association (localhost:2001,CMOVE)
------------------------------------------------------------
Comandos "quit", "exit"
Os comandos "quit" e "exit" têm o mesmo efeito. Ambos encerram o programa dcmqrti.
Conformidade DICOM
O aplicativo dcmqrti oferece suporte, como SCU, ao mesmo conjunto de SOP Class que o aplicativo dcmqrscp - consulte a documentação do dcmqrscp.
O aplicativo dcmqrti propõe contextos de apresentação para todas as SOP Class mencionadas acima usando as sintaxes de transferência:
LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
O aplicativo dcmqrti não oferece suporte à negociação estendida.
Configuração
O programa dcmqrti usa o mesmo arquivo de configuração que o programa dcmqrscp. Consulte a documentação sobre configuração para mais informações (dcmqrcnf.txt e o arquivo de configuração de exemplo dcmqrscp.cfg).
REGISTRO DE LOG
O nível de detalhamento do log das diversas ferramentas de linha de comando e das bibliotecas subjacentes pode ser especificado pelo usuário. Por padrão, apenas erros e avisos são gravados no fluxo de erro padrão. Ao usar a opção –verbose, mensagens informativas, como detalhes do processamento, também são relatadas. A opção –debug pode ser usada para obter mais detalhes sobre a atividade interna, por exemplo, para fins de depuração. Outros níveis de log podem ser selecionados com a opção –log-level. No modo –quiet, apenas erros fatais são relatados. Nesses casos de erro muito graves, o aplicativo normalmente é encerrado. Para mais detalhes sobre os diferentes níveis de log, consulte a documentação do módulo "oflog".
Caso a saída do log deva ser gravada em arquivo (opcionalmente com rotação de arquivo de log), no syslog (Unix) ou no log de eventos (Windows), pode-se usar a opção –log-config. Esse arquivo de configuração também permite direcionar apenas determinadas mensagens para um fluxo de saída específico e filtrar certas mensagens com base no módulo ou aplicativo em que são geradas. Um arquivo de configuração de exemplo é fornecido em < etcdir>/logger.cfg.
LINHA DE COMANDO
Todas as ferramentas de linha de comando usam a seguinte notação para os parâmetros: colchetes delimitam valores opcionais (0-1), reticências no final indicam que múltiplos valores são permitidos (1-n), e a combinação dos dois significa de 0 a n valores.
As opções de linha de comando se distinguem dos parâmetros por um sinal '+' ou '-' à frente. Normalmente, a ordem e a posição das opções de linha de comando são arbitrárias (ou seja, podem aparecer em qualquer lugar). No entanto, se as opções forem mutuamente exclusivas, é usada a ocorrência mais à direita. Esse comportamento está em conformidade com as regras de avaliação padrão dos shells Unix comuns.
Além disso, um ou mais arquivos de comando podem ser especificados usando um sinal '@' como prefixo do nome do arquivo (por exemplo, @command.txt). Esse argumento de comando é substituído pelo conteúdo do arquivo de texto correspondente (múltiplos espaços em branco são tratados como um único separador, a menos que apareçam entre duas aspas) antes de qualquer avaliação posterior. Observe que um arquivo de comando não pode conter outro arquivo de comando. Essa abordagem simples, mas eficaz, permite agrupar combinações comuns de opções/parâmetros e evita linhas de comando longas e confusas (um exemplo é fornecido no arquivo < datadir>/dumppat.txt).
AMBIENTE
O utilitário dcmqrti tentará carregar os dicionários de dados DICOM especificados na variável de ambiente DCMDICTPATH. Por padrão, ou seja, se a variável de ambiente DCMDICTPATH não estiver definida, o arquivo < datadir>/dicom.dic será carregado, a menos que o dicionário esteja embutido no aplicativo (padrão para Windows).
É preferível manter o comportamento padrão e usar a variável de ambiente DCMDICTPATH apenas quando dicionários de dados alternativos forem necessários. A variável de ambiente DCMDICTPATH tem o mesmo formato da variável PATH dos shells Unix, em que dois-pontos (":") separam as entradas. Em sistemas Windows, um ponto e vírgula (";") é usado como separador. O código do dicionário de dados tenta carregar cada arquivo especificado na variável de ambiente DCMDICTPATH. Ocorre um erro se nenhum dicionário de dados puder ser carregado.
ARQUIVOS
< docdir>/dcmqrcnf.txt - informações de configuração
< docdir>/dcmqrset.txt - informações de instalação
< etcdir>/dcmqrscp.cfg - exemplo de arquivo de configuração
VEJA TAMBÉM
dcmqrscp(1)
COPYRIGHT
Copyright (C) 1993-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.