Use o comando mqsideploy no z/OS para fazer uma solicitação de implementação para um broker local.
Use esta opção se múltiplos usuários desejarem se conectar ao mesmo broker ou se você estiver usando parâmetros de conexão avançada, como SSL.
Para criar este arquivo, clique com o botão direito do mouse no broker no WebSphere Message Broker Explorer e selecione Exportar Arquivo *.broker. Quando solicitado, navegue para o local no qual você deseja salvar o arquivo e insira o nome do arquivo; a extensão .broker é anexada automaticamente ao clicar em Salvar. Inclua o local (caminho) e o nome do arquivo quando especificar este parâmetro. Você deverá assegurar que o local seja acessível quando executar este comando.
Se você escolher esta opção, deverá especificar pelo menos um destes três parâmetros: a ordem na qual eles são especificados é irrelevante. Não é possível especificar cada parâmetro mais de uma vez.
Os parâmetros que forem omitidos assumirão valores-padrão:
O arquivo BAR pode estar em um sistema de arquivos local ou remoto, se o ID do usuário ou o broker que está executando o comando puder acessar o arquivo e lê-lo.
Objetos de todos os tipos podem ser especificados, mas se um nome de objeto ambíguo for especificado (por exemplo, "top", quando "top.dictionary" e "top.cmf" estão implementados no mesmo grupo de execução), todo o comando falhará com a mensagem BIP1089. Nessas circunstâncias, você deve especificar o nome completo dos objetos a serem removidos; por exemplo, "top.dictionary:top.cmf".
Se o arquivo BAR contiver recursos para outros aplicativos ou para o grupo de execução, esses recursos serão ignorados. Se existirem fluxos de mensagens, dependências de fluxos de mensagens ou bibliotecas, eles serão substituídos; se eles não existirem, serão criados. Se existirem fluxos de mensagens, dependências de fluxos de mensagens ou bibliotecas no componente do broker, mas não estiverem presentes no arquivo BAR, eles permanecerão no componente do broker.
Você pode configurar este parâmetro com um valor no intervalo de 1 - 2 145 336 164. Se você não fornecer um valor timeoutValue ou se configurar um valor menor que 1 ou maior que 2 145 336 164, um erro será retornado.
Configure este parâmetro para um valor maior que a soma dos parâmetros de tempo limite de configuração ConfigurationChangeTimeout e InternalConfigurationTimeout que você especificou para o broker, se desejar assegurar que uma resposta seja recebida dentro do período de timeoutValue. Se você configurar um valor menor, a resposta retornada poderá indicar que o estado do pedido de implementação é desconhecido.
Se o arquivo BAR contiver recursos para outros aplicativos ou bibliotecas, ou para o grupo de execução, esses recursos serão ignorados. Se existirem fluxos de mensagens ou dependências de fluxos de mensagens, eles serão substituídos; se eles não existirem, serão criados. Se existirem fluxos de mensagens ou dependências de fluxos de mensagens no componente do broker, mas eles não estiverem presentes no arquivo BAR, permanecerão no componente do broker.
Se você não usar os parâmetros -k e -y, a implementação atingirá o grupo de execução. Se o arquivo BAR contiver aplicativos ou bibliotecas existente no componente do broker, esses aplicativos ou bibliotecas serão reimplementados. Como parte dessa reimplementação, os fluxos de mensagens e os recursos do componente broker existentes contidos nos aplicativos e bibliotecas são excluídos e as novas versões são implementadas.
Se você tentar se conectar a um broker remoto especificando os parâmetros i, p e q ou usando um arquivo de parâmetro de conexão (.broker), o comando tentará usar o código do cliente WebSphere MQ Java. Esta opção não é suportada no z/OS e retorna o seguinte erro:
BIP1046E: Não é possível se conectar ao broker (name)
O código de razão relatado é MQRC_ENVIRONMENT_ERROR. É necessário especificar um gerenciador de filas locais.
Os exemplos a seguir mostram o uso do parâmetro -n para definir os parâmetros de conexão para o broker. Se o broker estiver no computador local, é possível especificá-lo pelo nome.
mqsideploy -n broker1.broker -e default -a mybar.bar -m -w 600
mqsideploy –n b1.broker –e default –d top.cmf:bar.dictionary
F MQ01BRK,dp e=default,a=flows.bar
Os exemplos a seguir mostram como especificar a implementação em aplicativos e bibliotecas.
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication -y myAppLibrary