WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsicreateconfigurableservice

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

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

Plataformas Suportadas

  • Windows.
  • Sistemas Linux e UNIX.
  • z/OS. Execute este comando customizando e enviando BIPCRCS. Para obter mais informações, consulte Conteúdo do PDSE do Broker.

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.
  • Para alguns tipos de serviço configurável, você deve parar e iniciar o grupo de execução para que a mudança entre em vigor. Verifique a documentação para o tipo de serviço configurável específico.

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 estiver 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 você 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.

Se 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\".

UNIX platformNos 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

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

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 Aggregation 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 usa filas prefixadas com SYSTEM.BROKER.EDA.SET1 e com uma validação de coleta de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService 
-n queuePrefix,collectionExpirySeconds -v SET1,60 
Crie um serviço configurável Servidor Connect:Direct® no objeto test, com um nome do host de 9.122.17.58 e número de porta 1369:
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369 
Para instalar um novo provedor de conector, chame MyProvider, que usa ConnectionFactory MyFactory e tem 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 

Para visualizar o Javadoc para a API do conector, consulte API do Connector.

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 ao qual o nó EmailInput ou o fluxo de mensagens pode fazer referência no tempo de execução para conectar a um servidor de email. O servidor está em execução em pop3://test.email.server.ibm.com na porta 12345. Neste exemplo, a identidade de segurança é identificada por mySecurityIdentityObjectName.
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":
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
Inclua um provedor JMS chamado "ProviderABC", com valores padrão para as propriedades de recursos:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
Inclua um provedor JMS chamado "BEAV91", especificando o nome de uma classe Java™ fornecida pela IBM® chamada com.ibm.broker.apihandler.BEAWebLogicAPIHandler para manipular 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 Resequence 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

É possível configurar o nome de usuário e a senha para um adaptador SAP usando o comando mqsisetdbparms.

Crie um perfil de segurança para um provedor WS-Trust V1.3 STS usando o 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"

É possível configurar o nome de usuário e a senha para um adaptador 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 Timer que usa uma fila prefixada com SYSTEM.BROKER.TIMEOUT.SET1 e que tem 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
Crie um serviço configurável WXSServer para definir como uma conexão com uma grade externa do WebSphere eXtreme Scale é estabelecida. A grade é uma grade segura denominada "myGrid". No exemplo a seguir, o servidor de catálogos para a grade tem um nome do host de server.ibm.com e está na porta 2809. O arquivo de substituição xc10Client.xml está sendo usado. O nome da identidade de segurança que foi criada pelo comando mqsisetdbparms é "xc10".
mqsicreateconfigurableservice MB8BROKER -c WXSServer -o xc10 
-n catalogServiceEndPoints,gridName,overrideObjectGridFile,securityIdentity 
-v "server.ibm.com:2809","myGrid","C:\Brokers\WebSphere_eXtreme_Scale\xc10\xc10Client.xml","xc10"
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:13


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