lsreplica

Lista as réplicas do banco de dados
Referências relacionadas
restorereplica
syncreplica
mkreplica

Aplicabilidade

Produto Tipo de Comando
MultiSite Subcomando de multiutil
Plataforma
UNIX
Windows

Sinopse

  • Liste as réplicas do banco de dados:
    lsrep/lica

    [ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
    –u/ser username [–p/assword] password [–l/ong | –s/hort |
    –fmu_ format ]
    [–sib/lings | [ –sib/lings]
    –infa/mily family-name | replica ... ]

  • Liste o repositório de esquemas de trabalho para uma família:
    lsrep/lica

    [ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
    –u/ser username [–p/assword] password –working/master

Descrição

Esse comando lista informações sobre todas as réplicas ativas conhecidas para a réplica atual. Você pode listar todas as réplicas em um clã ou em uma família de um clã. Outras réplicas podem existir, mas os pacotes que contêm suas informações de criação ainda não foram importados na réplica atual.

Restrições

Você deve ter privilégios de Superusuário.

Opções e Argumentos

Especificando o Clã, o Site e a Família

Padrão
Clã: primeiro clã replicado nesse site. Se houver mais de uma conexão dbset registrada nesse host, –clan será obrigatório.

Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.

Família: nenhum padrão; você deve especificar uma família.

–cl/an clan-name
Nome do clã da réplica.
–site site-name
Nome do site da réplica.
–fam/ily family-name
Família do banco de dados do usuário: nome fornecido ao banco de dados do usuário quando ele foi criado.

Família do repositório de esquemas: o nome da família é MASTR.

Você pode utilizar a opção –siblings ou as opções –siblings –infamily para listar as réplicas em uma família específica no clã, conforme conhecido no repositório de esquemas.

Especificando um Nome de Usuário e uma Senha

Padrão
Você deve especificar um nome de usuário e uma senha.
–u/ser user
Nome de um usuário com privilégios de superusuário.
–p/assword password
Senha associada ao usuário especificado.

Formato de Listagem

Padrão
Inclui informações de evento de criação para cada réplica.
–l/ong
Lista informações de criação de cada réplica e o servidor de sincronização. Se a réplica atual estiver no processo de restauração, essa opção anotará as listagens de outras réplicas a partir das quais as atualizações de restauração são necessárias.
–s/hort
Lista apenas os nomes das réplicas.
–fmu_ format-string
Lista informações utilizando a cadeia de formato especificada, que utiliza as especificações de conversão que identificam itens para exibição e especificam seus formatos de exibição. O formato de especificação de conversão é parecido com o da função de linguagem C printf(), um sinal de porcentagem (%) e uma letra chave (minúscula), que indica o tipo de dado para exibição.

Diferente de especificadores printf(), as especificações de conversão não são substituídas por argumentos fornecidos em outra parte na linha de comandos; elas são substituídas automaticamente por multiutil pelos valores de campos extraídos da réplica.

format-string é uma cadeia de caracteres, composta de caracteres alfanuméricos, especificações de conversão e seqüências de escape. Ela deve ser colocada entre aspas duplas ( " ).

Especificações de conversão:

%h
Nome do host
%n
Nome da réplica
%c
Nome do clã
%f
Nome da família
%d
Descrição da réplica, se houver
%s
Status da réplica
%%
Caractere %
%z
Tamanho de bloco de IDs
%t
Limite do bloco de IDs

Seqüências de escape:

\n
<NL>
\t
<TAB>
\'
Aspas simples
\\
Barra invertida literal (não interpretada)
\nnn
Caractere especificado por código octal

Especificando a Réplica

Padrão
Lista todas as réplicas conhecidas na família da réplica atual, inclusive a réplica atual.
–working/master
Lista o repositório de esquemas de trabalho para o especificado.
–sib/lings
Para um banco de dados do usuário, lista os membros da família da réplica atual, mas não lista a própria réplica atual. Para um repositório de esquemas, lista os membros da família de todas as réplicas no site, mas não as réplicas no site atual. Essa opção é útil quando você grava scripts que processam apenas réplicas irmãs.
–infa/mily family
Lista as réplicas na família da réplica especificada. Utilize o nome do site para especificar a réplica. Essa opção poderá ser utilizada apenas se você tiver especificado MASTR com a opção –family.
replica ...
A opção –site especifica a réplica que você está consultando para obter informações; esse argumento especifica o site da réplica para a qual você deseja listar informações. É possível listar apenas réplicas que são membros da mesma família.

Exemplos

Nestes exemplos, as linhas são quebradas por questões de legibilidade. Cada comando deve ser digitado em uma única linha física. Ignore o status NOT CONNECTED na listagem; esse valor é para uso interno da IBM.

  • Liste as réplicas na família DEV do clã telecomm.

    multiutil lsreplica -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd -long

    Name: BOSTON_HUB; Clan: TELECOMM; Family: DEV; Host: minuteman;
    Status: NORMAL, NOT CONNECTED;
    Description: ; Block Size: 4096; Block Threshold: 1024
    Name: SANFRAN_HUB; Clan: TELECOMM; Family: DEV; Host: goldengate;
    Status: NORMAL, NOT CONNECTED;
    Description: ; Block Size: 4096; Block Threshold: 1024
    Name: BANGALORE; Clan: TELECOMM; Family: DEV; Host: ramohalli;
    Status: NORMAL, NOT CONNECTED;
    Description: ; Block Size: 4096; Block Threshold: 1024

  • Liste os irmãos na família DEV no clã telecomm, mas não a réplica do banco de dados do usuário no site boston_hub.

    multiutil lsreplica -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd -long –siblings

    Name: SANFRAN_HUB; Clan: TELECOMM; Family: DEV; Host: goldengate;
    Status: NORMAL, NOT CONNECTED;
    Description: ; Block Size: 4096; Block Threshold: 1024
    Name: BANGALORE; Clan: TELECOMM; Family: DEV; Host: ramohalli;
    Status: NORMAL, NOT CONNECTED;
    Description: ; Block Size: 4096; Block Threshold: 1024

  • Liste os membros no clã telecomm, mas não as réplicas no site boston_hub.

    multiutil lsreplica -clan telecomm -site boston_hub -family MASTR
    -user susan -p passwd -long -siblings

    Name: SANFRAN_HUB; Clan: TELECOMM; Family: MASTR; Host: goldengate;
    Status: NORMAL, NOT CONNECTED;
    Description: ;Block Size: 4096; Block Threshold: 1024
    Name: SANFRAN_HUB; Clan: TELECOMM; Family: DEV; Host: goldengate;
    Status: NORMAL, NOT CONNECTED;
    Description: ;Block Size: 4096; Block Threshold: 1024
    Name: BANGALORE; Clan: TELECOMM; Family: MASTR; Host: ramohalli;
    Status: NORMAL, NOT CONNECTED;
    Description:; Block Size: 4096; Block Threshold: 1024
    Name: BANGALORE; Clan: TELECOMM; Family: DOC; Host: ramohalli;
    Status: NORMAL, NOT CONNECTED;
    Description: ;Block Size: 4096; Block Threshold: 1024

  • Liste todos os bancos de dados do usuário na família TEST do clã testclan, conforme conhecido no repositório de esquemas de trabalho.

    multiutil lsreplica -clan testclan -site sydney -family MASTR
    -user bfife -p passwd -long -infamily TEST

    Name: TOKYO; Clan: TESTING; Family: TEST; Host: shinjuku;
    Status: NORMAL, NOT CONNECTED; Description:
    ; Block Size: 4096; Block Threshold: 1024
    Name: SYDNEY; Clan: TESTING; Family: TEST; Host: taronga;
    Status: NORMAL, NOT CONNECTED; Description:
    ; Block Size: 4096; Block Threshold: 1024

  • Liste o repositório de esquemas de trabalho para a família DEV no clã testclan.

    multiutil lsreplica -clan testclan -site sydney -family DEV
    -user bfife -workingmaster

  • Reproduza a saída de lsreplica –long.

    multiutil lsreplica -clan testing -site tokyo -family TEST
    -user masako -password passwd -fmu_ "Name:%n; Clan:%c; Family:%f; Host:%h;
    Status:%s;"

    Name:TOKYO; Clan:TESTING; Family:TEST; Host:shinjuku; Status:
    NORMAL, NOT CONNECTED; Name:SYDNEY; Clan:TESTING; Family:TEST;
    Host:taronga; Status:NORMAL, NOT CONNECTED;


Feedback