Comando mqsisetdbparms

Utilize o comando mqsisetdbparms para associar um ID do usuário e senha específicos com um ou mais recursos no seu domínio do intermediário.

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS. Execute esse comando customizando e enviando o BIPSDBP.

Propósito

O par ID do usuário e senha é criado na pasta DSN sob a pasta de registro do intermediário.

Esse comando não será executado se o intermediário estiver em execução. É necessário parar o intermediário antes de executar esse comando.

O comando mqsisetdbparms não aplica-se aos bancos de dados do intermediário. Portanto, não é possível utilizar esse comando para substituir o nome da origem de dados do intermediário.

Sintaxe

Criar

Alterar

Excluir

Parâmetros

BrokerName
(Obrigatório) O nome do intermediário cujas definições devem ser criadas, alteradas ou excluídas.
Início da mudança-n ResourceNameFim da mudança
(Necessário) Esse parâmetro identifica um dos seguintes recursos:
  • A origem de dados para a qual o par de ID do usuário e senha deve ser criado ou modificado.
    Os nomes da origem de dados são utilizados pelos seguintes nós:
    • Compute
    • Banco de Dados
    • DataDelete
    • DataInsert
    • DataUpdate
    • Filter
    • Mapeamento
    • Warehouse
    Se você utilizar o mesmo DSN em diversos nós para referir-se à mesma instância de banco de dados, a mesma combinação de ID de usuário e senha é utilizada.
  • O nome da identidade de segurança utilizado para autenticar uma conexão com um JMS ou um recurso JNDI. O ResourceName tem o formato jms::secId ou jndi::secId, em que secId é especificado como o valor
  • Início da mudançaO nome da identidade de segurança utilizada para autenticar um servidor SMTP. Fim da mudança
  • Início da mudançaO nome da identidade de segurança utilizada para autenticar um armazenamento de chave do intermediário. Fim da mudança
  • Início da mudançaO nome da identidade de segurança utilizada para autenticar um diretório LDAP. Fim da mudança
  • Início da mudançaO nome da identidade de segurança utilizada para autenticar um serviço configurável WSRR. Fim da mudança
Início da mudança-u UserIdFim da mudança
Início da mudança(Necessário para uma conexão Criação; Opcional para Alteração) O ID do usuário que deve ser associado a este recurso.Fim da mudança
Início da mudança-p SenhaFim da mudança
Início da mudança(Necessário para Criação e Alteração) A senha a ser associada a este recurso.

Para compatibilidade com os sistemas existentes, você ainda pode especificar <password>. Entretanto, se não especificar uma senha com esse parâmetro ao executar o comando, será solicitado que você digite uma senha durante sua chamada e digite a senha uma segunda vez para verificar se ela foi digitada corretamente.

Fim da mudança
-d
(Necessário para Exclusão) Esse parâmetro exclui o par de ID do usuário e senha para esse recurso do registro.

Autorização

Nos sistemas Windows, o ID do usuário utilizado para executar este comando deve ter autoridade do Administrador no sistema local.

No Linux e no UNIX, o ID do usuário utilizado para executar este comando deve ser membro do grupo mqbrkrs.

No z/OS, o ID do usuário utilizado para executar este comando deve ser membro de um grupo que tenha acesso a LEITURA e GRAVAÇÃO no diretório de componentes.

Assegure-se de que o registro esteja protegido apropriadamente para evitar acesso não autorizado. O mqsisetdbparms não é requerido para operação correta do intermediário. No entanto, se o administrador do intermediário não designar IDs de usuários e senhas específicos para recursos específicos, o ID do usuário do intermediário (e senha no Windows e no UNIX) será utilizado. A senha não é armazenada em texto sem formatação no sistema de arquivo.

Exemplos

Nome da origem de dados

Os seguintes exemplos mostram o uso do comando sem a URI (Universal Record Identifier) adicional:
mqsisetdbparms WBRK_BROKER -n MQBroker1 -u MQUserId -p password
mqsisetdbparms WBRK_BROKER -n MQBroker1 -d

Nomes de recursos JMS e JNDI

Os exemplos a seguir mostram a utilização do comando quando a URI de um nome de recurso JMS ou JNDI é substituída para o ResourceName associado ao parâmetro -n.

Para um recurso JMS, o prefixo é "jms::"; para JNDI, o prefixo é "jndi::".

No Linux e UNIX, se a cadeia do parâmetro incluir um caractere de barra invertida (\), você deve fazer escape desse caractere utilizando um segundo caractere de barra invertida (\\) ao inserir o comando mqsisetdbparms.

Por exemplo, para especificar um ID do usuário de myuserid e uma senha secret para a connection factory de tópico JMS tcf1 no intermediário MyBroker1, utilize a seguinte sintaxe:
mqsisetdbparms MyBroker1 -n jms::tcf1 -u myuserid -p secret
De modo semelhante, para especificar a mesma segurança para um contexto inicial JNDI com.sun.jndi.fscontext.RefFSContextFactory, digite o seguinte comando:
mqsisetdbparms MyBroker1 -n jndi::com.sun.jndi.fscontext.RefFSContextFactory 
     -u myuserid -p secret

Nomes das Contas do nó JMS

Os exemplos anteriores descrevem como configurar a segurança para recursos JMS e JNDI para todos os nós JMS que utilizam esses recursos em um intermediário.

Para aumentar o grau de controle que você possui na segurança de nós JMS, um recurso pode ser associado a um account name. O próprio account name é constituído do nome do fluxo de mensagens concatenado com o rótulo do nó por meio do caractere de sublinhado "_", ou seja:
            Message Flow Name_Node label
Por exemplo, quando o nome do fluxo de mensagens é MyJMSFlow1 e você requer um ID de usuário e senha específicos para o nó JMSInput MyJMSInput1, o account name resultante é:
             MyJMSFlow1_MyJMSInput1
Você pode então usar a cadeia nome da conta na opção ResourceName do comando mqsisetdbparms prefixando o nome da conta com o tipo de recurso, e concatenando o nome da conta com um caractere de arroba (@) seguido pelo próprio nome do recurso:
            <resource type><account name>@<resource name>
Portanto, supondo um nome de recurso JMS tcf1, utilizado pelo nó JMSInput MyJMSInput1 no fluxo de mensagens MyJMSFlow1, o seguinte ResourceName é utilizado:
            jms::MyJMSFlow1_MyJMSInput1@tcf1
Especificando um ID do usuário myuserid, uma senha secreta, um nome de intermediário MyBroker1 e o nome de ResourceName criados a partir do nome da conta, conforme descrito acima, utilize a seguinte sintaxe:
mqsisetdbparms MyBroker1 -n jms::MyJMSFlow1_MyJMSInput1@tcf1
                 -u myuserid -p secret
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:52

an09155_