WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsicreateconfigurableservice

Utilice el mandato mqsicreateconfigurableservice para crear un nombre de objeto para un recurso externo de intermediario.

También puede utilizar WebSphere Message Broker Explorer para crear servicios configurables. Para obtener más información, consulte Uso de WebSphere Message Broker Explorer para trabajar con servicios configurables.

Plataformas soportadas

Finalidad

Para los servicios configurables que añade utilizando el mandato mqsicreateconfigurableservice:
  • Utilice el mandato mqsireportproperties para ver los servicios configurables.
  • Utilice el mandato mqsichangeproperties para modificar los servicios configurables.
  • Utilice el mandato mqsideleteconfigurableservice para suprimir servicios configurables.

No es necesario que utilice el mandato mqsicreateconfigurableservice para crear proveedores EIS ya que se proporcionan definiciones. Utilice el mandato mqsichangeproperties para modificar los proveedores EIS.

Notas de uso

  • Antes de ejecutar este mandato, asegúrese de que el intermediario está en ejecución.
  • Para algunos tipos de servicio configurable, debe detener e iniciar el grupo de ejecución para que el cambio entre en vigor. Consulte la documentación para el tipo de servicio configurable específico.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicreateconfigurableservice--NombreIntermediario----------->

>-- -c --ServicioConfigurable-- -o--NombreObjeto---------------->

>--+-------------------------------------------------------+---><
   |      .-,---------------.                              |   
   |      V                 |                              |   
   '- -n----NombrePropiedad-+--+-------------------------+-'   
                               |      .-,--------------. |     
                               |      V                | |     
                               '- -v----ValorPropiedad-+-'     

Parámetros

NombreIntermediario
(Necesario) El nombre del intermediario que se va a modificar. Éste debe ser el primer parámetro.
-c ServicioConfigurable
(Necesario) Tipo del recurso externo (servicio configurable). Utilice el mandato mqsireportproperties para ver la lista de valores válidos.

Los tipos de recursos válidos se listan en la sección Propiedades de servicios configurables.

-o NombreObjeto
(Necesario) El nombre del objeto cuyas propiedades desea cambiar.

Por ejemplo, si el parámetro -c se establece en JDBCProviders, el nombre de objeto esperado es un nombre de proveedor JDBC definido por IBM o un nombre de proveedor JDBC definido por el usuario. Se proporcionan servicios predeterminados para las bases de datos soportadas a las que se puede conectar mediante conexiones JDBC tipo 4. Utilice los servicios proporcionados como plantilla cuando cree un servicio utilizando este mandato. Utilice el mandato mqsireportproperties para ver la lista de nombres de proveedor predeterminados.

-n NombrePropiedad
(Opcional) El nombre de la propiedad que se cambia.

Los nombres de propiedades válidos se listan en Propiedades de servicios configurables.

-v ValorPropiedad
(Opcional, pero necesario si se especifica -n) Valor que se asigna a la propiedad especificada por el parámetro -n. Puede especificar más de un nombre de propiedad y el valor correspondiente utilizando comas como separadores; por ejemplo, -n Nombre1, Nombre2 -v Valor1, Valor2.

Si el valor de propiedad contiene una coma, escriba el valor entre comillas y caracteres de escape (\" and \"); por ejemplo -n Name1,Name2 -v Value1,\"Value21,Value22\".

UNIX platformEn sistemas UNIX, si el parámetro -v contiene un punto y coma (;), encierre la serie entera entre comillas, tal como se muestra en el ejemplo siguiente:
mqsicreateconfigurableservice MB8BROKER -c JDBCProviders -o
DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[nombreServidor]:[númeroPuerto]/[nombreBaseDatos]:user=[usuario];password=[contraseña];"

Los valores de propiedad se describen en Propiedades de servicios configurables.

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP8011 No se han podido crear los datos de configuración
  • BIP8012 No se ha podido conectar con los componentes del sistema
  • BIP8014 No se puede crear el componente
  • BIP8073 Nombre de intermediario no válido
  • BIP8983 El servicio configurable ya existe
  • BIP8984 No se ha encontrado el servicio configurable

Ejemplos

Cree un servicio configurable Aggregation que utilice un conjunto de colas con el prefijo SYSTEM.BROKER.AGGR.SET1 y con un tiempo de espera de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Aggregation -o myAggregationService 
-n queuePrefix,timeoutSeconds -v SET1,60 
Cree un servicio configurable CICSConnection para la instancia de CICS que se ejecuta en tcp://test.cics.ibm.com, puerto 12345. El intermediario se identifica mediante el valor APPLID BRKApp y el calificador BRKQual. El tiempo de espera de conexión es de 10 segundos y el tiempo de espera de solicitud es de 5 segundos en este ejemplo:
mqsicreateconfigurableservice
MB8BROKER -c CICSConnection -o
myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
Cree un servicio configurable Collector que utilice colas con el prefijo SYSTEM.BROKER.EDA.SET1 y con una caducidad de la colección de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService 
-n queuePrefix,collectionExpirySeconds -v SET1,60 
Cree un servicio configurable Servidor de Connect:Direct en el objeto test, con un nombre de host de 9.122.17.58 y un número de puerto 1369:
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n nombre de hot,puerto -v 9.122.17.58,1369 
Para instalar una nueva llamada de proveedor de Connector MyProvider que utiliza la FábricaConexión MyFactory y tiene los archivos JAR en el directorio C:\temp\jars:
mqsicreateconfigurableservice MB8BROKER -c ConnectorProviders -o MyProvider
-n connectorClassName,jarsURL
–v com.ibm.broker.MyFactory,C:\temp\jars 

Para ver el Javadoc para la API del conector, consulte API del conector.

Cree un servicio configurable CORBA que especifique la ubicación de la referencia de objeto:
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
Cree un servicio configurable EmailServer al que el nodo o el flujo de mensajes EmailInput puede hacer referencia en tiempo de ejecución para conectarse a un servidor de correo electrónico. El servidor se ejecuta en pop3://test.email.server.ibm.com en el puerto 12345. En este ejemplo, la identidad de seguridad se identifica mediante mySecurityIdentityObjectName.
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o miNombreServicioConfigurableCorreoelectrónico
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,miNombreObjetoIdentidadSeguridad
Cree un servicio FtpServer configurable:
mqsicreateconfigurableservice
MB8BROKER -c FtpServer -o
Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
Cree un servicio configurable FtpServer para utilizar SFTP sin una comprobación de claves de host estricta:
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o TEST1 
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v  SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
Cree un servicio configurable IMSConnect para la instancia IMSA de IMS que se ejecuta en test.ims.ibm.com puerto 9999:
mqsicreateconfigurableservice
MB8BROKER -c IMSConnect -o
myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
Cree un servicio JavaClassLoader:
mqsicreateconfigurableservice
MB8BROKER -c JavaClassLoader 
-o myJavaClassLoader 
-n includedDeployedJars,sharedJarPath 
-v "jcnapp1.jar","/var/app1/jars"
Añada un proveedor JMS que se denomina "MyProviderXYZ":
mqsicreateconfigurableservice
MB8BROKER -c JMSProviders -o
JMS_MyProviderXYZ
Añada un proveedor JMS denominado "ProviderABC", con valores predeterminados para las propiedades de recursos:
mqsicreateconfigurableservice
MB8BROKER -c JMSProviders -o
JMS_ProviderABC
Añada un proveedor JMS que se denomina "BEAV91", especificando el nombre de una clase que suministra IBM® Java™ que se denomina com.ibm.broker.apihandler.BEAWebLogicAPIHandlerpara manejar llamadas de API específicas del proveedor:
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 
Cree un perfil de supervisión con el nombre 'mp1' para el intermediario MB8BROKER:
mqsicreateconfigurableservice MB8BROKER -c MonitoringProfiles -o mp1
Cree un servicio configurable PeopleSoftConnection para la instancia de PeopleSoft que se está ejecutando en my.peoplesoft.qa.com:
mqsicreateconfigurableservice
MB8BROKER -c
PeopleSoftConnection 
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
Cree un servicio configurable Resequence que utilice un conjunto de colas con el prefijo SYSTEM.BROKER.EDA.SET1 y con un tiempo de espera de mensajes que faltan de 60 segundos:
mqsicreateconfigurableservice MB8BROKER -c Resequence -o miServicioResequence 
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60 
Cree un servicio configurable SAPConnection para el adaptador SAP mySAPAdapter.outadapter que se conecte al host de SAP test.sap.ibm.com y utilice el cliente 001 para las conexiones en dicho servidor:
mqsicreateconfigurableservice
MB8BROKER -c SAPConnection -o
mySAPAdapter.outadapter 
-n applicationServerHost,client -v test.sap.ibm.com,001

Puede establecer el nombre de usuario y la contraseña para un adaptador SAP utilizando el mandato mqsisetdbparms.

Cree un perfil de seguridad para un proveedor 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
El perfil de Propagación predeterminada es un perfil predefinido que sólo solicita la propagación de identidad. Para obtener más información acerca de la creación de un perfil de seguridad para un proveedor de STS WS-Trust V1.3, LDAP o TFIM V6.1, consulte Creación de un perfil de seguridad.
Cree un servicio configurable SiebelConnection para el adaptador Siebel mySiebelAdapter.outadapter que se conecte al 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"

Puede establecer el nombre de usuario y la contraseña para un adaptador Siebel utilizando el mandato mqsisetdbparms.

Cree un servicio TCPIPServer configurable:
mqsicreateconfigurableservice MB8BROKER -c TCPIPServer -o ServerPort1452 
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15  
Crea un servicio TCPIPClient configurable:
mqsicreateconfigurableservice MB8BROKER -c TCPIPClient 
-o ClientPort1452HostnameJsmith 
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections 
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10  
Cree un servicio configurable Timer que utilice una cola con el prefijo SYSTEM.BROKER.TIMEOUT.SET1, y con un tiempo de espera de 5 segundos:
mqsicreateconfigurableservice MB8BROKER -c Timer -o myTimerService 
-n queuePrefix,timeoutIntervalSeconds -v SET1,5 
Cree un servicio de tipo UserDefined:
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
Cree un servicio configurable WXSServer para definir cómo se establece una conexión a una cuadrícula de WebSphere eXtreme Scale externa. La cuadrícula es una cuadrícula seguro denominada "myGrid". En el ejemplo siguiente, el servidor de catálogo para la cuadrícula tiene un nombre de host de server.ibm.com y se encuentra en el puerto 2809. Se utiliza el archivo de alteración temporal xc10Client.xm. El nombre de la identidad de seguridad que ha creado el mandato mqsisetdbparms es "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 | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:14


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an37200_