IM Centro de Informações do Relationship Resolution, Versão 4.2

Sintaxe de Comando de Pipeline

O comando de pipeline permite iniciar, parar e depurar pipelines utilizando uma ou mais opções ou parâmetros de comandos. As opções de linha de comandos especificadas como parte do comando de pipeline substituem os parâmetros correspondentes que foram especificados no arquivo de configuração do pipeline.

A sintaxe do comando de pipeline é:

pipeline -option parameter

Opções e Parâmetros de Pipeline

Você pode utilizar estas opções juntas ou separadas.

-a transport URI syntax for the Application monitor
Especifica o transporte a ser aberto para o Monitor de aplicativos.
-c pipeline configuration filename
Especifica o arquivo de configuração de pipeline que você deseja utilizar com o pipeline que está sendo iniciado. Se o arquivo de configuração de pipeline não estiver localizado no mesmo diretório a partir do qual você está iniciando o pipeline, será possível especificar o caminho digitando o caminho completo e nome do arquivo.
-d
Especifica que você deseja executar este pipeline no modo de depuração no primeiro plano.
É necessário iniciar um pipeline utilizando a opção -s (modo de serviço/daemon) ou a opção -d (modo de depuração).
Nota: O modo de depuração não é recomendado para utilização em cenários de produção, porque ele registra cada ação para este pipeline nos arquivos de log e pode causar uma redução no desempenho. No entanto, o modo de depuração pode ser útil em cenários de teste ou durante a resolução de problemas de um pipeline.
-e
Pára o pipeline especificado em execução como um daemon do UNIX ou um serviço do Windows (em execução no segundo plano). Se houver vários pipelines em execução no nó de pipeline, será necessário utilizar a opção -n para especificar o nome do pipeline que você deseja parar.
Nota: Se o pipeline que você deseja parar estiver em execução no modo de depuração, também será possível parar o pipeline pressionando Ctrl + C na janela de comandos.
-f data file name
Carrega dados do arquivo especificado para o pipeline.
Se houver vários pipelines em execução no nó de pipeline, será necessário utilizar a opção -n para especificar o nome do pipeline para o qual você deseja carregar estes dados.
Se estiver utilizando a opção de transporte (-t) para carregar um arquivo, não será necessário utilizar também a opção -f, porque essa opção especifica o nome do arquivo.
-i
(Apenas plataformas Windows) Instala um pipeline como um serviço do Windows. Quando o pipeline tiver sido instalado como o serviço do Windows, será possível utilizar a opção -s para executar o pipeline como um serviço do Windows.
Será necessário utilizar a opção de instalação apenas se o pipeline nunca tiver sido instalado como um serviço do Windows ou se você tiver utilizado a opção de desinstalação.
-l
Lista o status de todos os pipelines no nó de pipeline ou do status de pipeline especificado por nome utilizando a opção -n.
Os possíveis status do pipeline são Parado e Em Execução.
-n pipeline name
Especifica o nome do pipeline. Esta opção não será necessária se você utilizar o executável do pipeline padrão (pipeline). No entanto, se estiver executando mais de um pipeline no mesmo nó de pipeline, será necessário especificar um nome exclusivo para cada pipeline.
Se desejar monitorar este pipeline ou rotear resultados a partir deste pipeline, será necessário registrar o pipeline por nome no Console de Configuração na guia Nós. O nome especificado para o pipeline na linha de comandos corresponde exatamente ao nome do pipeline registrado no Console de Configuração.
É comum utilizar esta opção com qualquer uma das outras opções de pipeline para especificar o pipeline por nome.
-s
Executa o pipeline como um daemon do UNIX ou um serviço do Windows (se o pipeline tiver sido instalado como um serviço do Windows utilizando a opção -i) no modo de segundo plano. É necessário iniciar um pipeline utilizando a opção -s (modo de serviço/daemon) ou a opção -d (modo de depuração).
Se você estiver executando vários pipelines, é comum utilizar este comando juntamente com a opção de comando -n para especificar o nome do pipeline a ser executado como um daemon ou um serviço.
-t transport URI syntax
Especifica o URI (Identificador Uniforme de Recursos) do transporte no qual o pipeline recebe dados de entrada. É possível especificar mais de um transporte, digitando várias URIs de transporte -t na mesma linha de comandos.
Se o método de transporte ainda não existir, o pipeline não será iniciado.
A maioria dos transportes suportados contêm opções de sintaxe de comando que permitem iniciar vários encadeamentos de pipeline para processar mais dados simultaneamente.
-u
(Apenas plataformas Windows) Desinstala o pipeline como um serviço do Windows.
Se estiver executando vários pipelines, é comum utilizar este comando com a opção -n para especificar o nome do pipeline a ser desinstalado como um serviço.

Comandos de Pipeline de Exemplo

O seguinte comando de pipeline cria um novo pipeline em execução em uma plataforma Windows, instala o pipeline como um serviço do Windows, inicia o serviço do Windows, nomeia o novo pipeline como pipeline08 e inicia o pipeline:
pipeline -n pipeline08 -s

O seguinte comando de pipeline permite que o pipeline denominado pipe12 receba dados de um servidor HTTP, de uma fila denominada queue22 e de um arquivo denominado "data.umf":

pipeline -n pipe12 -t http://server50:8888 -t mq:/queue22 -t file:/data.umf

O comando de pipeline a seguir inicia pipeline1 e utiliza o arquivo de configuração de pipeline denominado "unixpipeline.ini":

pipeline -c unixpipelinel.ini -n pipeline1
Tarefas relacionadas
Iniciando Pipelines
Parando Pipelines
Referências relacionadas
Lista de Verificação de Resolução de Problemas do Console de Configuração


Feedback

Última atualização: 2007