Comando mqsicreateconfigurableservice

Use o comando mqsicreateconfigurableservice para criar um novo nome do objeto para um recurso externo do broker.

Você também pode usar o WebSphere Message Broker Explorer para criar os serviços configuráveis. Consulte o Usando o WebSphere Message Broker Explorer para Trabalhar com Serviços Configuráveis para obter informações adicionais.

Plataformas Suportadas

Propósito

Para serviços configuráveis que você inclui usando o comando mqsicreateconfigurableservice:
  • Utilize o comando mqsireportproperties para visualizar os serviços configuráveis.
  • Utilize o comando mqsichangeproperties para modificar os serviços configuráveis.
  • Utilize o comando mqsideleteconfigurableservice para excluir os serviços configuráveis.

Não é necessário usar o comando mqsicreateconfigurableservice para criar provedores EIS, porque você mesmo fornece as definições. Use o comando mqsichangeproperties para modificar provedores EIS.

Notas sobre a utilização

  • Antes de executar esse comando, certifique-se de que o broker esteja em execução.
  • Verifique a documentação do tipo de serviço configurável específico: Para alguns tipos de serviço configurável, para o qual é explicitamente declarado na documentação, você deve parar e iniciar o grupo de execução para que a mudança entre em vigor.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicreateconfigurableservice--BrokerName-------------------->

>-- -c --ConfigurableService-- -o--ObjectName------------------->

>--+---------------------------------------------------+-------><
   |      .-,------------.                             |   
   |      V              |                             |   
   '- -n----PropertyName-+--+------------------------+-'   
                            |      .-,-------------. |     
                            |      V               | |     
                            '- -v----PropertyValue-+-'     

Parâmetros

BrokerName
(Obrigatório) O nome do broker a ser modificado. Esse parâmetro deve ser o primeiro parâmetro.
-c ConfigurableService
(Necessário) O tipo de recurso externo (serviço configurável). Utilize o comando mqsireportproperties para visualizar a lista de valores válidos.

Os tipos de recursos válidos estão listados em Propriedades de Serviços Configuráveis.

-o ObjectName
(Requerido) O nome do objeto cujas propriedades você deseja alterar.

Por exemplo, se o parâmetro -c for configurado como JDBCProviders, o nome do objeto esperado será um nome de provedor JDBC definido pela IBM® ou um nome de provedor JDBC definido pelo usuário. Serviços padrão são fornecidos aos bancos de dados suportados aos quais é possível conectar através de conexões JDBC tipo 4. Use os serviços fornecidos como um modelo quando criar um serviço usando este comando. Utilize o comando mqsireportproperties para visualizar a lista de nomes de provedores padrão.

-n PropertyName
(Opcional) O nome da propriedade que está sendo alterada.

Os nomes de propriedades válidas estão listados em Propriedades de Serviços Configuráveis.

-v PropertyValue
(Opcional mas necessário se o parâmetro -n estiver especificado) O valor designado à propriedade especificada pelo parâmetro -n. É possível especificar mais de um nome de propriedade e valor correspondente usando vírgulas como separadores, por exemplo, -n Name1,Name2 -v Value1,Value2.

Início da mudançaSe o valor da propriedade contiver uma vírgula, coloque o valor entre aspas duplas de escape (\" e \"); por exemplo, -n Name1,Name2 -v Value1,\"Value21,Value22\".Fim da mudança

UNIX platform Nos sistemas UNIX, se o parâmetro -v contiver um ponto e vírgula (;), coloque a cadeia inteira entre aspas, conforme mostrado no exemplo a seguir:
mqsicreateconfigurableservice MB8BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"

Os valores da propriedade são descritos em Propriedades de Serviços Configuráveis.

Autorização

Em todos os sistemas operacionais, o ID do usuário deve ser membro do grupo mqbrkrs.

Respostas

Esse comando retorna as seguintes respostas:
  • BIP8011 Impossível criar dados de configuração
  • BIP8012 Não foi possível conectar a componentes do sistema
  • BIP8014 O componente não pode ser criado
  • BIP8073 Nome de broker inválido
  • BIP8983 O serviço configurável já existe
  • BIP8984 O serviço configurável não foi localizado

Exemplos

Crie um serviço configurável de Agregação que usa um conjunto de filas prefixadas com SYSTEM.BROKER.AGGR.SET1 e com um tempo limite de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Aggregation -o myAggregationService 
-n queuePrefix,timeoutSeconds -v SET1,60 
Crie um serviço configurável CICSConnection para a instância do CICS que está em execução na porta 12345 de tcp://test.cics.ibm.com. O broker é identificado pelo APPLID BRKApp e pelo qualificador BRKQual. O tempo limite de conexão é 10 segundos e o tempo limite de pedido é 5 segundos neste exemplo:
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
Crie um serviço configurável Collector que use filas prefixadas com SYSTEM.BROKER.EDA.SET1 e com uma expiração de coleta de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService 
-n queuePrefix,collectionExpirySeconds -v SET1,60 
Início da mudançaCrie um serviço configurável Servidor Connect:Direct no objeto test usando um nome de host de 9.122.17.58 e uma porta 1369:
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369 
Fim da mudança
Início da mudançaPara instalar um novo provedor de conectores, chame MyProvider que usa o ConnectionFactory MyFactory e possui seus arquivos JAR no diretório c:\temp\jars:
mqsicreateconfigurableservice MB8BROKER -c ConnectorProviders -o MyProvider
-n connectorClassName,jarsURL
–v com.ibm.broker.MyFactory,c:\temp\jars 
Fim da mudança
Crie um serviço configurável CORBA que especifica o local da referência do objeto:
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
Crie um serviço configurável EmailServer para o nó EmailInput ou fluxo de mensagens utilizarem como referência no tempo de execução para se conectarem a um servidor de e-mail que esteja em execução na porta 12345 pop3://test.email.server.ibm.com. A identidade de segurança é identificada por mySecurityIdentityObjectName neste exemplo:
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o myEmailConfigurableServiceName
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,mySecurityIdentityObjectName
Crie um serviço configurável FtpServer:
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
Crie um serviço configurável FtpServer para usar SFTP sem verificação de chave do host restrita:
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o TEST1 
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v  SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
Crie um serviço configurável IMSConnect para a instância do IMS IMSA que está em execução na porta do test.ims.ibm.com 9999:
mqsicreateconfigurableservice MB8BROKER -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
Crie um serviço JavaClassLoader:
mqsicreateconfigurableservice MB8BROKER -c JavaClassLoader 
-o myJavaClassLoader 
-n includedDeployedJars,sharedJarPath 
-v "jcnapp1.jar","/var/app1/jars"
Inclua um provedor JMS chamado MyProviderXYZ para o broker MB8BROKER:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
Inclua um provedor JMS chamado ProviderABC para o broker MB8BROKER com valores-padrão para as propriedades do recurso:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
Inclua um provedor JMS chamado BEAV91 para o broker MB8BROKER, especificando o nome de uma classe Java fornecida pela IBM chamada com.ibm.broker.apihandler.BEAWebLogicAPIHandler para tratar chamadas de API específicas do fornecedor:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o BEAV91 
-n proprietaryAPIHandler,proprietaryAPIAttr1,proprietaryAPIAttr2,proprietaryAPIAttr3
–v com.ibm.broker.apihandler.BEAWebLogicAPIHandler,weblogic.jndi.WLInitialContextFactory,
t3://19.21.194.126:7001,BEAServerName 
Crie um perfil de monitoramento com o nome 'mp1' para o broker MB8BROKER:
mqsicreateconfigurableservice MB8BROKER -c MonitoringProfiles -o mp1
Crie um serviço configurável PeopleSoftConnection para a instância PeopleSoft que está em execução no my.peoplesoft.qa.com:
mqsicreateconfigurableservice MB8BROKER -c PeopleSoftConnection 
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
Crie um serviço configurável de ressequência que usa um conjunto de filas prefixadas com SYSTEM.BROKER.EDA.SET1 e com um tempo limite de mensagem ausente de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Resequence -o myResequenceService 
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60 
Crie um serviço configurável SAPConnection para o adaptador do SAP mySAPAdapter.outadapter que se conecta ao host do SAP test.sap.ibm.com e usa o cliente 001 para as conexões nesse servidor:
mqsicreateconfigurableservice MB8BROKER -c SAPConnection -o mySAPAdapter.outadapter 
-n applicationServerHost,client -v test.sap.ibm.com,001

Você pode configurar o nome do usuário e a senha para um adaptador do SAP usando o Comando mqsisetdbparms.

Crie um perfil de segurança para um provedor WS-Trust V1.3 STS utilizando Tivoli Federated Identity Manager (TFIM) V6.2:
mqsicreateconfigurableservice MB8BROKER -c SecurityProfiles -o myWSTrustTFIMv62Profile 
-n authentication,mapping,authorization,propagation,mappingConfig 
-v "WS-Trust v1.3 STS","WS-Trust v1.3 STS","WS-Trust v1.3 STS",TRUE,
http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
O perfil de Propagação Padrão é um perfil predefinido que solicita apenas a propagação de identidade. Para obter informações adicionais sobre como criar um perfil de segurança para um provedor WS-Trust V1.3 STS, LDAP ou TFIM V6.1, consulte Criando um Perfil de Segurança.
Crie um serviço configurável SiebelConnection para o adaptador Siebel mySiebelAdapter.outadapter que se conecta ao servidor Siebel "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu".
mqsicreateconfigurableservice MB8BROKER -c SiebelConnection -o mySiebelAdapter.outadapter 
-n connectString -v "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu"

Você pode configurar o nome do usuário e a senha para um adaptador do Siebel usando o Comando mqsisetdbparms.

Crie um serviço configurável TCPIPServer:
mqsicreateconfigurableservice MB8BROKER -c TCPIPServer -o ServerPort1452 
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15  
Crie um serviço configurável TCPIPClient:
mqsicreateconfigurableservice MB8BROKER -c TCPIPClient 
-o ClientPort1452HostnameJsmith 
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections 
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10  
Crie um serviço configurável de cronômetro que use uma fila prefixada com SYSTEM.BROKER.TIMEOUT.SET1 e com um tempo limite de 5 segundos:
mqsicreateconfigurableservice MB8BROKER -c Timer -o myTimerService 
-n queuePrefix,timeoutIntervalSeconds -v SET1,5 
Crie um serviço UserDefined:
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:36


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | an37200_