IBM Sterling Connect:Direct : Principais Comandos e Arquivos

From Wiki

Principais arquivos

A instalação padrão fica no diretório:

/opt/cdunix/
|- ndm/
|  |  |- cfg                -> Configurações
|  |  |- msgfile.cfg
|  |  |- <NODE_NAME>
|  |  |  |- initparm.cfg    -> variáveis de inicialização
|  |  |  |- netmap.cfg      -> 
|  |  |  |- userfile.cfg    -> autenticação
|  |  |  |- sysacl.cfg      -> controle de acesso
|  |  |- cliapi
|  |  |  |- ndmapi.cfg      -> Configuração do Cliente
|  |- bin                   -> executáveis e shell
|  |- security             
|  |  |- keys.client        -> chaves do cliente
|  |  |- keys.server        -> chaves do server
|  |- src                   -> processos de exemplo
|  |  |- sample.cd
|- etc
|  |- cdcust                -> configurações exemplos para customização


Principais Comandos

Importante:

  • Um Processo é uma coleção de instruções que definem atividades entre 2 nodes, como por exemplo: copiar arquivos entre nós, executar jobs, manipulação de erros, submeter outros processos ...
  • Transmission Control Queue (TCQ) é a quem gerencia todos os Processos que são submetidos pelo C:D. Possui 4 filas: EXECUTION, WAIT, TIMER e HOLD.
Comando Abreviação Descrição
submit file=<sample.cd>; sub submete o processo para execução na Transmission Control Queue (TCQ). E habilita a execução do código no arquivo especificado.
change process; cha pro altera o status e modifica características específicas de um processo não executando no TCQ
delete process; del pro remove um processo não executando do TCQ
flush process; flu pro remove um processo executando do TCQ
stop; stop para o direct e retorna pra o S.O.
quit; quit para o direct e o Connect:Direct, depois retorna pra o S.O.
select process pnumber=<N> detail=yes; sel pro Monitora processos em execução ou em waiting. Permite definir critérios de busca e apresentação.
select statistics pnumber=<N>; sel stat Retorna informações estatísticas. Permite definir critérios de busca e apresentação.
view process view pro Exibe um processo na TCQ onde o local node é o PNODE. Mostra apenas processos em execução.


Exemplo arquivo sample.cd

/*
* This sample process ...
* 
*/

sample PROCESS SNODE=NODE1

step01 COPY
  FROM (
    FILE=/tmp/file1.txt
    PNODE
  )

  CKPT=2M
  COMPRESS extended

  TO (
    FILE=/tmp/file1.delete
    SNODE
    DISP=rpl
  )

PEND;

Onde:

  • CKPT: Checkpoint a cada NN e a medida K/M

Select Process

select process <OPCOES> detail=yes;

onde

Opção Descrição Detalhes
pnumber= número do processo, lista pnumber=(13,14)
pname= nome do processo.

Pode ser usado com pname=name | (list) | generic

  • name=sysXpto
  • name=sysY*
  • name=(sysX,sysY)
queue= fila do processo. hold|timer|wait|exec
snode= nó secundário generic|(list)
status= Status HC | HE | HI | HO | HR | HS | PE | WC | WR | WS | (list)EX (Execution)
submitter= quem enviou o processo generic | (list)
detail=yes tipo de relatório detalhado.

Select Statistics

Mostra estatísticas e detalhes sobre o Processo.

select statistics <OPCOES>;

onde

Opção Descrição Detalhes
pnumber= número do processo, lista pnumber=(13,14)
pname= nome do processo.

Pode ser usado com pname=name | (list) | generic

  • name=sysXpto
  • name=sysY*
  • name=(sysX,sysY)
ccode=(operator,nn) completion code código final do processo.

Exemplo: todos os processos que finalizaram com código 8. ccode=(=,8) ou ccode=(eq,8). Completion code:

  • 0 - Processo finalizou corretamente
  • 4 - A transferência ocorreu mas um problema menor ocorreu
  • 8 - A transferência não ocorreu devido a um problema maior
  • 16 - A transferência não ocorreu. O C:D não ser recuperou do erro ocorrido.

Operadores:

  • eq ou = ou ==
  • ge ou >= ou =>
  • gt ou >
  • le ou <= ou =<
  • lt ou <
  • ne ou !=
snode= nó secundário generic|(list)
status= Status HC | HE | HI | HO | HR | HS | PE | WC | WR | WS | (list)EX (Execution)
submitter= quem enviou o processo generic | (list)
detail=yes tipo de relatório detalhado.


As estatísticas são armazenadas no diretório <NDM_DIR>/work/node.

Ver também