Amqdsc 03

MQSeries para Sun Solaris
Gua rpida de iniciacin

V ersin 5.2
GC10-3076-03
Gua rpida de iniciacin

V ersin 5.2
GC10-3076-03
Aviso Antes de utilizar esta informacin y el producto al que se refiere, lea la informacin general del Apndice C. Avisos en la pgina 85.
Cuarta edicin (diciembre de 2000) Este manual es la traduccin del original ingls MQSeries for Sun Solaris Quick Beginnings Version 5.2, (GC33-1870-03). Esta edicin se aplica a Versin 5.2 de MQSeries para Sun Solaris, V5.2 y a todos los releases y modificaciones posteriores hasta que se indique lo contrario en nuevas ediciones. Copyright International Business Machines Corporation 1995, 2000. Reservados todos los derechos.
Contenido
Figuras . Tablas. . . . . . . . . . . . . . . . . . . . . . . . . . v . vii Instalacin remota . . . . . . . . Instalacin del servidor y del cliente en la misma mquina . . . . . . . . . . Soporte para Java en MQSeries. . . . . Mensajes traducidos . . . . . . . . Manuales traducidos . . . . . . . . Verificacin de la instalacin de MQSeries para Sun Solaris. . . . . . . . . . Procedimiento de verificacin . . . . Salidas de usuario . . . . . . . . . Definicin del CCSID del gestor de colas en MQSeries para Sun Solaris . . . . . . . 14 . . . . 14 15 15 15
|
Bienvenido a MQSeries para Sun Solaris . ix Diagrama . . . . . . . . . . . . . ix Convenciones . . . . . . . . . . . . x
| Novedades de MQSeries para Sun Solaris, | Versin 5 Release 2 . . . . . . . . . xi
. 16 . 16 . 22 . 22
Parte 1. Instalacin de MQSeries para Sun Solaris . . . . . . . . . 1 | Captulo 3. Instalacin del cliente
Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris . . Requisitos de hardware . . . . . . . . Almacenamiento en disco . . . . . . . Requisitos de software . . . . . . . . . Conectividad . . . . . . . . . . . . Compiladores soportados para las aplicaciones Solaris . . . . . . . . . . . . . . Opciones . . . . . . . . . . . . . Supervisores de transacciones . . . . . Bases de datos . . . . . . . . . . DCE . . . . . . . . . . . . . . Entrega . . . . . . . . . . . . . . Instalacin . . . . . . . . . . . . . Componentes de MQSeries para Sun Solaris . Archivo README . . . . . . . . . . 3 4 4 4 5 6 6 6 6 6 7 7 7 8
| | | | |
Captulo 2. Instalacin del servidor MQSeries para Sun Solaris . . . . . . . 9 Preparacin para la instalacin . . . . . . 9 Creacin de objetos por omisin del sistema 9 Antes de la instalacin . . . . . . . . 9 Configuracin del kernel . . . . . . . . 11 Migracin desde una versin anterior de MQSeries para Sun Solaris . . . . . . . 13 Cambios en el manejo de seales . . . . 13 Cambios realizados en qm.ini para los canales LU62 que utilizan Sunlink 9.1 . . 13 Instalacin del servidor MQSeries para Sun Solaris . . . . . . . . . . . . . . 14
Copyright IBM Corp. 1995, 2000
| | | | | | | | | | | | | | | | | | | | | | | | |
MQSeries para Sun Solaris . . . . . . 25 Planificacin de la instalacin del cliente MQSeries para Sun Solaris . . . . . . . 25 Requisitos de hardware . . . . . . . 25 Requisitos de software . . . . . . . 25 Conectividad. . . . . . . . . . . 26 Compiladores soportados para las aplicaciones Solaris. . . . . . . . . 26 El directorio de instalacin . . . . . . 26 Antes de la instalacin . . . . . . . 27 Configuracin del kernel . . . . . . . 27 Migracin desde una versin anterior de MQSeries para Sun Solaris . . . . . . . 27 Cambios en el manejo de seales . . . . 28 Instalacin del cliente MQSeries para Sun Solaris . . . . . . . . . . . . . . 28 Mensajes traducidos . . . . . . . . 29 Verificacin de la instalacin . . . . . . 29 Cmo se lleva a cabo . . . . . . . . 29 La instalacin utilizada para el ejemplo . . 30 Configuracin del servidor . . . . . . 30 Configuracin del cliente. . . . . . . 31 Cmo poner un mensaje en la cola . . . 32 Cmo obtener el mensaje de la cola . . . 33 Finalizacin de la verificacin . . . . . 33 Captulo 4. Aplicacin de mantenimiento a MQSeries para Sun Solaris . . . . . . 35 Requisitos de espacio . . . . . . . . . 35 Aplicacin de la informacin de mantenimiento . . . . . . . . . . 36
iii
Restauracin del nivel anterior de servicio
36
| |
Captulo 5. Desinstalacin de MQSeries para Sun Solaris . . . . . . . . .
. 37
Supresin de los mensajes de local . . . . . . . . Supresin de una cola local . Examen de las colas . . .
una cola . . . . . . . . . . . .
. 61 . 61 . 62
Parte 2. Iniciacin a MQSeries . . 39

Captulo 6. Acerca de MQSeries . . . . 41 Introduccin . . . . . . . . . . . . 41 Mensajes, colas y gestores de colas . . . . 42 Mensajes . . . . . . . . . . . . 42 Colas . . . . . . . . . . . . . 42 Gestores de colas . . . . . . . . . 43 Configuraciones de MQSeries . . . . . . 44 Canales . . . . . . . . . . . . 45 Clientes y servidores . . . . . . . . 45 Clusters . . . . . . . . . . . . 46 Posibilidades de MQSeries . . . . . . . 47 Soporte de transacciones . . . . . . . 47 Sucesos de instrumentacin . . . . . . 48 Proceso dirigido por mensajes . . . . . 49 Programacin de MQSeries . . . . . . . 50 Captulo 7. Utilizacin de los conjuntos de mandatos de MQSeries. . . . . . . . Introduccin de los conjuntos de mandatos Mandatos de control . . . . . . . . Mandatos MQSeries (MQSC) . . . . . Mandatos PCF . . . . . . . . . . Trabajo con gestores de colas . . . . . . Creacin de un gestor de colas por omisin . . . . . . . . . . . . Inicio de un gestor de colas . . . . . . Detencin de un gestor de colas . . . . Supresin de un gestor de colas . . . . Trabajo con objetos MQSeries . . . . . . Utilizacin del recurso MQSC de forma interactiva . . . . . . . . . . . Finalizacin de la entrada interactiva de MQSC . . . . . . . . . . . . . Definicin de una cola local . . . . . . Visualizacin de los atributos de objetos por omisin . . . . . . . . . . . Copia de una definicin de cola local . . Modificacin de los atributos de una cola local . . . . . . . . . . . . .
Captulo 8. Utilizacin de MQSeries Internet Gateway . . . . . . . . . . 63 Visin general de MQSeries Internet Gateway 63 Documentacin de MQSeries Internet Gateway . . . . . . . . . . . . . 64
| | | | | | | | | |
Captulo 9. Obtencin de informacin adicional . . . . . . . . . . . . . Manuales en copia impresa . . . . . . . Informacin en lnea . . . . . . . . . Publicaciones que se suministran con el producto . . . . . . . . . . . . Manuales en HTML y PDF en la World Wide Web. . . . . . . . . . . . . . . CD-ROM en formato BookManager . . . . Ayuda en lnea . . . . . . . . . . .
65 66 66 66 68 69 69
Parte 3. Apndices . . . . . . . 71
Apndice A. Programas MQI y archivos MQSC de ejemplo . . . . . . . . . Ejemplos de archivos de mandatos MQSC . . Programas de ejemplo C y COBOL . . . . Soporte para CICS y Encina en el proceso de transacciones. . . . . . . . . . . . Soporte para Tuxedo en el proceso de transacciones. . . . . . . . . . . . Soporte para bases de datos. . . . . . . Herramientas varias . . . . . . . . . 73 73 73 75 75 76 76
51 51 51 54 54 55 55 55 56 57 57 57 58 58 59 60 61
Apndice B. Pginas de cdigos soportadas en MQSeries para Sun Solaris . 77 Migracin al soporte para el euro . . . . . 83 Apndice C. Avisos . . . . . . . . . 85 Marcas registradas . . . . . . . . . . 87 ndice . . . . . . . . . . . . . . . . . . 89 . 93
Envo de comentarios a IBM .
iv
MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin
Figuras
| 1. |
Valores de parmetros del kernel valores de ejemplo en un sistema Solaris 12
vi
Tablas
| | | | |
1. 2. 3. 4. 5. 6. Diagrama de iniciacin. . . . . . . ix Componentes . . . . . . . . . . 7 Manuales de MQSeries para Sun Solaris 65 Publicaciones MQSeries nombres de archivos . . . . . . . . . . . 67 Archivos de mandatos MQSC . . . . 73 Programas de ejemplo - archivos fuente 73 7. 8. Ejemplos de proceso de transacciones con CICS y Encina . . . . . . . Ejemplos para el proceso de transacciones con Tuxedo . . . . . Programas de ejemplo - bases de datos Archivos varios . . . . . . . . Entornos nacionales y CCSID . . . . 75 . 75 76 . 76 . 77
| |
9. 10. 11.
vii
viii
Bienvenido a MQSeries para Sun Solaris

| | Este manual describe MQSeries para Sun Solaris (SPARC Platform Edition), V5.2 y explica cmo planificar, instalar y utilizar el producto.
Diagrama
En la Tabla 1 encontrar toda la informacin necesaria para empezar a utilizar MQSeries para Sun Solaris.
Tabla 1. Diagrama de iniciacin
Si desea... Informacin sobre los requisitos del sistema para MQSeries para Sun Solaris Instalar MQSeries para Sun Solaris Instalar un cliente MQSeries para Sun Solaris Aplicar mantenimiento a MQSeries para Sun Solaris Desinstalar un servidor o cliente MQSeries Informarse sobre MQSeries para Sun Solaris. Consulte... Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris en la pgina 3 Captulo 2. Instalacin del servidor MQSeries para Sun Solaris en la pgina 9 Captulo 3. Instalacin del cliente MQSeries para Sun Solaris en la pgina 25 Captulo 4. Aplicacin de mantenimiento a MQSeries para Sun Solaris en la pgina 35 Captulo 5. Desinstalacin de MQSeries para Sun Solaris en la pgina 37 Captulo 6. Acerca de MQSeries en la pgina 41
Empezar a utilizar conjuntos de mandatos Captulo 7. Utilizacin de los conjuntos de mandatos de MQSeries en la pgina 51 Empezar a utilizar la interfaz de la Web Ver o imprimir documentacin en lnea Ponerse en contacto con IBM Captulo 8. Utilizacin de MQSeries Internet Gateway en la pgina 63 Captulo 9. Obtencin de informacin adicional en la pgina 65 Enve sus comentarios a IBM
ix
Convenciones Convenciones
El conocimiento de las convenciones tipogrficas de este manual le ayudar a utilizarlo ms eficazmente. v El texto en negrita indica el nombre de un elemento que debe seleccionar o el nombre de un mandato. v El texto en cursiva indica que se trata de trminos nuevos, ttulos de manuales o informacin variable que debe sustituirse por un valor real. v El texto en monoespaciado indica que se trata de un ejemplo (como una va de acceso o un nombre de archivo ficticios) o texto que se visualiza en la pantalla.
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Novedades de MQSeries para Sun Solaris, Versin 5 Release 2

MQSeries para Sun Solaris, Versin 5 Release 2 proporciona las siguientes funciones nuevas y modificadas: v Se ha mejorado el rendimiento de la funcin MQI, de los canales, de las anotaciones de mensajes y del proceso de inicializacin y finalizacin de las aplicaciones. v Ahora puede solicitar una actualizacin inmediata de los datos del Gestor de autorizaciones sobre objetos (OAM), en lugar de tener que detener y reiniciar el gestor de colas para que los cambios de autorizacin surtan efecto. v Se ha modificado el modo en que se conservan los datos OAM, para mejorar el rendimiento. v El soporte para Java en MQSeries se instala por separado desde el CD-ROM que se incluye en el paquete del producto MQSeries Versin 5.2. Alternativamente, puede bajar la versin ms reciente de soporte para Java en MQSeries, desde el sitio web de MQSeries en:
http://www.ibm.com/software/mqseries/
v Se ha incluido soporte de interconexin, que es la posibilidad del Agente de canal de mensajes (MCA) de transferir mensajes utilizando varias hebras. v Los programas de rutina de salida de envo de canal pueden reservar espacio en el almacenamiento intermedio de transmisin para uso propio. Normalmente, lo utilizar una rutina de salida que desee cifrar los datos y aadir una clave de seguridad. v Ahora se puede utilizar el protocolo DHCP (Dynamic Host Configuration Protocol) en los clsters del gestor de colas. v Se ha mejorado la gestin de los archivos de anotaciones para la recuperacin y el reinicio. v El rea del almacenamiento principal para almacenar informacin relacionada con un clster de gestores de colas se puede aumentar de forma dinmica. Se proporciona una nueva llamada de rutina de carga de trabajo del clster (MQXCLWLN) para dar soporte a la navegacin por los registros MQWDR, MQWQR y MQWCR que se guardan en el almacenamiento que puede aumentarse dinmicamente.
xi
Novedades
| | | | | | | | | | | | | | | v Se han efectuado ligeros cambios en las funciones de programacin de aplicaciones de MQSeries como, por ejemplo: ahora existe soporte para MQRFH2 (las normas de la versin 2 y la cabecera de formato); se ha mejorado el proceso del campo CodedCharSetId en las cabeceras MQSeries; se ha aadido el valor de nivel de mandato MQCMD_LEVEL_520 y se da soporte a C++ en MQCNO Versin 2 y Versin 3. v Se da soporte a IBM WebSphere como coordinador XA. v Para minimizar el impacto en las aplicaciones de usuario, se ha alterado el modo en que MQSeries maneja las seales UNIX. v Se puede utilizar Data Connection SNAP-IX, V6.2 o posterior, para la configuracin SNA. v Se da soporte a la versin 5.0 del compilador Sun Workshop C++ y a la versin 6.0 del compilador Forte C++. Para obtener una descripcin completa de las funciones nuevas y modificadas de este producto, consulte el manual MQSeries Versin 5.2 Gua del release.
xii
Parte 1. Instalacin de MQSeries para Sun Solaris

Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris . . Requisitos de hardware . . . . . . . . Almacenamiento en disco . . . . . . . Requisitos de software . . . . . . . . . Conectividad . . . . . . . . . . . . Compiladores soportados para las aplicaciones Solaris . . . . . . . . . . . . . . Opciones . . . . . . . . . . . . . Supervisores de transacciones . . . . . Bases de datos . . . . . . . . . . DCE . . . . . . . . . . . . . . Entrega . . . . . . . . . . . . . . Instalacin . . . . . . . . . . . . . Componentes de MQSeries para Sun Solaris . Archivo README . . . . . . . . . . 3 4 4 4 5 6 6 6 6 6 7 7 7 8 Salidas de usuario . . . . . . . . . . 22 Definicin del CCSID del gestor de colas en MQSeries para Sun Solaris . . . . . . . 22
| | | | |
Captulo 2. Instalacin del servidor MQSeries para Sun Solaris . . . . . . . 9 Preparacin para la instalacin . . . . . . 9 Creacin de objetos por omisin del sistema 9 Antes de la instalacin . . . . . . . . 9 Creacin de otro sistema de archivos para el cdigo del producto . . . . . 11 Configuracin del kernel . . . . . . . . 11 Migracin desde una versin anterior de MQSeries para Sun Solaris . . . . . . . 13 Cambios en el manejo de seales . . . . 13 Cambios realizados en qm.ini para los canales LU62 que utilizan Sunlink 9.1 . . 13 Instalacin del servidor MQSeries para Sun Solaris . . . . . . . . . . . . . . 14 Instalacin remota . . . . . . . . . 14 Instalacin del servidor y del cliente en la misma mquina . . . . . . . . . . . 14 Soporte para Java en MQSeries. . . . . . 15 Mensajes traducidos . . . . . . . . . 15 Manuales traducidos . . . . . . . . . 15 Verificacin de la instalacin de MQSeries para Sun Solaris. . . . . . . . . . . 16 Procedimiento de verificacin . . . . . 16 Verificacin de una instalacin local . . 16 Verificacin de una instalacin servidor a servidor . . . . . . . . . . . 18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Captulo 3. Instalacin del cliente MQSeries para Sun Solaris . . . . . . Planificacin de la instalacin del cliente MQSeries para Sun Solaris . . . . . . . Requisitos de hardware . . . . . . . Requisitos de software . . . . . . . Conectividad. . . . . . . . . . . Compiladores soportados para las aplicaciones Solaris. . . . . . . . . El directorio de instalacin . . . . . . Antes de la instalacin . . . . . . . Configuracin del kernel . . . . . . . Migracin desde una versin anterior de MQSeries para Sun Solaris . . . . . . . Cambios en el manejo de seales . . . . Instalacin del cliente MQSeries para Sun Solaris . . . . . . . . . . . . . . Mensajes traducidos . . . . . . . . Verificacin de la instalacin . . . . . . Cmo se lleva a cabo . . . . . . . . La instalacin utilizada para el ejemplo . . Qu muestra el ejemplo . . . . . . Configuracin del servidor . . . . . . Configuracin del cliente. . . . . . . Definicin de un canal de conexin con el cliente utilizando MQSERVER . . . Cmo poner un mensaje en la cola . . . Cmo obtener el mensaje de la cola . . . Finalizacin de la verificacin . . . . . Captulo 4. Aplicacin de mantenimiento a MQSeries para Sun Solaris . . . . . . Requisitos de espacio . . . . . . . . . Aplicacin de la informacin de mantenimiento . . . . . . . . . . Restauracin del nivel anterior de servicio
25 25 25 25 26 26 26 27 27 27 28 28 29 29 29 30 30 30 31 32 32 33 33
35 35 36 36
| |
Captulo 5. Desinstalacin de MQSeries para Sun Solaris . . . . . . . . .
. 37
Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris

En este captulo se muestran los requisitos para ejecutar MQSeries para Sun Solaris: v v v v Protocolos de red Compiladores Soporte de entrega Diversos componentes del producto
La siguiente informacin slo se aplica al entorno de servidor. Para ms informacin sobre la instalacin del cliente IBM MQSeries para Sun Solaris, consulte el Captulo 3. Instalacin del cliente MQSeries para Sun Solaris en la pgina 25.
Compatibilidad con el ao 2000 Cuando MQSeries se utiliza de acuerdo con la documentacin adecuada, puede procesar, proporcionar o recibir correctamente datos de fechas tanto del siglo veinte como del veintiuno, siempre y cuando todos los productos (por ejemplo, hardware, software y firmware) utilizados con este programa de IBM intercambien con l y de forma correcta datos exactos de fechas. Los clientes deben ponerse en contacto con los otros fabricantes o proveedores para saber en qu estado se encuentran sus productos respecto a este problema. IBM se reserva el derecho de actualizar esta informacin. Si desea conocer la informacin ms reciente sobre los niveles de software a los que se da soporte, vea la siguiente direccin:
http://www.software.ibm.com/ts/mqseries/platforms/supported.html
Para conocer las ltimas disposiciones de IBM en lo que se refiere a la preparacin para el ao 2000, vea la siguiente direccin:
http://www.ibm.com/IBM/year2000/
Requisitos de hardware Requisitos de hardware

| | | | v Servidores MQSeries: Todos los sistemas servidor o de sobremesa Sun SPARC y los sistemas servidor y de sobremesa Sun UltraSPARC, soportados por el release adecuado del entorno operativo Solaris, como se muestra en Requisitos de software.
Almacenamiento en disco
Los requisitos de instalacin dependen de los componentes que se instalan y de la cantidad de espacio de trabajo que se necesita. Esto depender de la cantidad de colas que se utilicen, el nmero y tamao de los mensajes de las colas y si los mensajes son permanentes o no lo son. Tambin se necesita capacidad para archivar en el disco, cinta u otro soporte de almacenamiento. Nota: Utilice el mandato df -k para determinar la cantidad de espacio libre disponible en el disco. A continuacin se muestran los requisitos de almacenamiento: v Servidor: Debe haber un mnimo de 25 MB de espacio en disco disponible para el cdigo del producto y los datos del sistema de archivos que contiene el directorio /opt. Los datos de trabajo de MQSeries para Sun Solaris se almacenan por omisin en /var/mqm. v Manuales en lnea Adems, si instala los manuales en lnea en formato HTML, necesitar 35 MB de almacenamiento para los mismos en el directorio /opt. Despus de la instalacin, los manuales se colocan en el directorio /opt/mqm/html. Nota: Para mayor seguridad respecto a la integridad de los datos, se recomienda enrgicamente transferir las anotaciones a una unidad fsica distinta de la que se utiliza para las colas.
| | | |
Requisitos de software
| | | | | | | Se indican los niveles mnimos soportados. Los ltimos niveles compatibles, si los hay, estn soportados a no ser que se indique lo contrario. v Sun Solaris Versin 2.6 con los parches 10518112 10521019 10773306 10556813 10559105 (necesario si se utiliza C++)
| | | | | | | | | | | | | | | | | | | 10612505 v Sun Solaris 7 con los parches 107171-02 107544-03 106541-09 106950-03 106980-05 106327-05 (necesario si se utiliza C++) 107443-11 (necesario si se utiliza DCE 3.1 en Sun Solaris versin 7) 107709-04 (necesario si se utiliza DCE 3.1 en Sun Solaris versin 7) Notas: 1. 107544-03 debe instalarse antes que el 106541-09. 2. 106541-09 es el mnimo nivel recomendado de parche de actualizacin del kernel. v Sun Solaris 8 Nota: Actualmente no se tiene ningn conocimiento de los parches necesarios para Solaris 8, sin embargo recomendamos leer el archivo README en el que encontrar la informacin ms reciente.
Conectividad
Los protocolos de red soportados son SNA LU 6.2 y TCP. | | | | | | | | Para la conectividad SNA, puede utilizar SunLink SNA Peer-to-Peer Versin 9.1 o SNAP-IX (SPARC Platform Edition), V6.2 o posterior. Si se utiliza la red en anillo: es necesario el controlador Sun TRI 4.0 o posterior. TCP/IP forma parte del sistema operativo base. En MQSeries para Sun Solaris, V5.2, se han incorporado mejoras gracias a las cuales ser ms provechoso combinar el uso de DHCP con los clusters del gestor de colas MQSeries. Para ms informacin sobre la especificacin del producto SNA que desea utilizar (SunLink SNA o Data Connection SNAP-IX), vea el apartado MQSeries Versin 5.2 Gua del release.
Compiladores Compiladores soportados para las aplicaciones Solaris

| | | | | | | v v v v v Compilador C de Sun Workshop 4.2 Compilador C++ de Sun Workshop 4.2 Compilador C de Sun Workshop 5.0 Compilador C++ de Sun Workshop 5.0 Forte C 6 (Sun Workshop 6 C)
v Forte C++ 6 (Sun Workshop 6 C++) v Merant Server Express V1.1
Opciones
Puede utilizar las siguientes opciones con MQSeries para Sun Solaris.
Supervisores de transacciones
Se pueden utilizar los siguientes supervisores del proceso de transacciones (la coordinacin puede realizarse a travs de la interfaz X/Open XA): v WebSphere 3.0x y 3.5x v BEA Tuxedo Versin 6.4 o 6.5 MQSeries para Sun Solaris, V5.2 da soporte a WebSphere como coordinador XA. Para ms informacin sobre el adaptador de aplicaciones MQSeries y sobre cmo crear aplicaciones Component Broker, consulte el manual WebSphere Application Server Enterprise Edition Component Broker MQSeries Application Adaptor Development Guide, SC094444.
| | | | | | | | | | | | | | | | | | | | |
Bases de datos
v Oracle 8i y 8iR2 (8.1.5 o 8.1.6) v DB2 Universal Database V5.0, V6.1 y 7 v Sybase V11: Adaptive Server Enterprise (A.S.E.), V11.5 Open Client (ctlib y dblib), V11.1 Embedded SQL/C, V11.0 XA Server, V11.1 v Sybase Adaptive Server Enterprise, V12, con opcin DTM. Nota: Si desea ver ms informacin sobre cmo configurar la coordinacin XA, consulte el manual MQSeries Administracin del sistema.
DCE
v Transarc DCE-DFS 2.0 para Sun Solaris 2.6 v IBM DCE 3.1 para Sun Solaris 7 v IBM DCE 3.1 para Sun Solaris 8
Opciones
| | | Si desea ejecutar las rutinas de envo, recepcin y salida de mensajes DCE que proporciona MQSeries, debe ser un producto DCE que d soporte al cifrado de datos DES. Los nombres de DCE y los mdulos de seguridad se suministran con MQSeries para Sun Solaris, V5.2.
Entrega
| | | | | | MQSeries para Sun Solaris, V5.2 se suministra en CD-ROM. El soporte para Java en MQSeries se puede instalar por separado del CD-ROM incluido en este paquete de producto. De forma alternativa, el soporte para Java de MQSeries se puede bajar del sitio Web MQSeries en
http://www.ibm.com/software/mqseries
donde siempre est disponible la versin ms reciente de este soporte.
Instalacin
MQSeries para Sun Solaris tarda unos 5 minutos en instalarse, si se utiliza el programa Solaris pkgadd. El proceso de instalacin se describe en el Captulo 2. Instalacin del servidor MQSeries para Sun Solaris en la pgina 9. | | Es posible instalar MQSeries llevando a cabo una instalacin remota. Para ms informacin, consulte el apartado Instalacin remota en la pgina 14
| Componentes de MQSeries para Sun Solaris | | | | | | | | | | | MQSeries para Sun Solaris, V5.2 incluye los siguientes componentes (denominados a veces catlogos de archivos):
Tabla 2. Componentes
Ttulo Servidor MQSeries Pginas Man Descripcin Soporte para conexiones de clientes. Requiere la instalacin del componente de ejecucin. Pginas Man para los siguientes mandatos: v Mandatos de control v Interfaz de Colas de Mensajes (MQI) v Mandatos MQSeries (MQSC) Programas de aplicacin de ejemplo.
Programas de ejemplo
Componentes de MQSeries para Sun Solaris

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Ejemplos de DCE Ejecucin de Internet Gateway Ejemplos de Internet Gateway Catlogos de mensajes DCE Soporte para los nombres DCE o seguridad en el servidor. Este componente slo debe instalarse si va a utilizarse DCE.
Tabla 2. Componentes (continuacin)

Ttulo Bibliotecas de cliente Sun Solaris 2 Descripcin El cliente MQSeries para Sun Solaris se puede instalar en la mquina servidor, lo que le permite tener el cliente y el servidor MQSeries en la misma mquina. Se proporcionan las versiones HTML de la v Documentacin de MQSeries v Documentacin de Internet de MQSeries Las versiones en PDF de los manuales MQSeries se encuentran tambin en el CD-ROM, pero no aparecen listados como componentes instalables. Las versiones en HTML y PDF de algunos de los manuales de MQSeries estn disponibles en los siguientes idiomas: Alemn Chino simplificado Chino tradicional Coreano Espaol Francs Ingls EE.UU. Italiano Japons Portugus - Brasil Este componente slo debe instalarse si va a utilizarse DCE. Proporciona acceso a las aplicaciones MQSeries a travs de HTML, CGI, ICAPI y NSAPI
Documentacin en lnea de MQSeries:
Nota: El producto base se instala de forma automtica.
Archivo README
Antes de empezar a instalar MQSeries para Sun Solaris, lea el archivo README que encontrar en el directorio raz del CD-ROM.
Captulo 2. Instalacin del servidor MQSeries para Sun Solaris

Este captulo explica cmo instalar MQSeries para Sun Solaris y cmo comprobar que la instalacin ha sido satisfactoria. El producto MQSeries se instala en el directorio /opt/mqm. Dicho directorio no puede cambiarse. No obstante, si no tiene suficiente espacio en el sistema de archivos /opt/mqm, siga el procedimiento que se indica en el apartado Creacin de otro sistema de archivos para el cdigo del producto en la pgina 11. Nota: El producto MQSeries se encuentra en el directorio /mq_solaris del CD-ROM.
Preparacin para la instalacin

Esta seccin le conduce por algunos de los pasos a seguir antes de instalar MQSeries para Sun Solaris. Si ya tiene instalada una versin anterior de MQSeries para Sun Solaris, consulte el apartado Migracin desde una versin anterior de MQSeries para Sun Solaris en la pgina 13 antes de instalar MQSeries para Sun Solaris, V5.2.
Creacin de objetos por omisin del sistema

Si utiliza el mandato crtmqm para crear un gestor de colas en este release de MQSeries, los objetos por omisin del sistema se crean automticamente. El archivo de ejemplo de definiciones de MQSC, amqscoma.tst, ya no se proporciona. | | | | | | | Si utiliz amqscoma.tst para personalizar los valores en la Versin 5.0, y desea utilizar los mismos valores con la Versin 5.2 del producto: 1. Guarde una copia de amqscoma.tst 2. Instale MQSeries V5.2 3. Cargue la copia de amqscoma.tst y utilice el archivo para volver a crear los objetos por omisin
Antes de la instalacin
Antes de instalar MQSeries para Sun Solaris, haga lo siguiente: v Debe instalar los parches que se indican en el archivo README. v Debe crear un grupo con el nombre mqm.

v Debe aadir root al grupo mqm. v Debe crear un ID de usuario con el nombre mqm. v Es aconsejable crear y montar un sistema de archivos /var/mqm, o los sistemas de archivos /var/mqm, /var/mqm/log y /var/mqm/errors para los datos. Debe tener como mnimo 30 MB de almacenamiento para /var/mqm, 2 MB para /var/mqm/errors y 20 MB para /var/mqm/log si va a crear sistemas de archivos separados. Para un solo sistema de archivos, utilice la suma de estas cifras como gua. Notas: 1. Para determinar el tamao del sistema de archivos /var/mqm, debe tener en cuenta los siguientes puntos: El nmero mximo de mensajes del sistema a la vez La posibilidad de que se produzca una acumulacin de mensajes, si hay un problema en el sistema El tamao medio de los datos del mensaje ms 500 bytes para la cabecera del mensaje El nmero de colas El tamao de los archivos de anotaciones y mensajes de error, si dichos archivos no van a estar en un sistema de archivos distinto. 2. Es mejor utilizar todo el espacio disponible, supervisar la utilizacin durante unas semanas y, si procede, reducir la cantidad de espacio asignado. Si el sistema de archivos inicial es demasiado pequeo, puede ocasionar problemas ms adelante. 3. Si crea particiones separadas, los siguientes directorios deben estar en un sistema de archivos local: /var/mqm /var/mqm/log Puede montar con NFS los directorios /var/mqm/errors y /var/mqm/trace para ahorrar espacio en el sistema local. 4. El tamao del archivo de anotaciones depende de los valores de anotaciones que utilice. El tamao aconsejado es para las anotaciones cronolgicas circulares (se debe comprobar si es adecuado para cada entorno concreto) que utilizan los valores por omisin. Para ms informacin sobre los tamaos de las anotaciones, consulte el manual MQSeries Administracin del sistema. Tras la instalacin, este ID de usuario (mqm) es el propietario de los directorios y archivos que tienen los recursos asociados al producto. Este grupo y usuario
| | | | | | | | | | | | | | | | | | | | | | | | | | | | |
10

deben definirse para cada mquina en la que vaya a instalarse el software de MQSeries, tanto si se trata de una mquina cliente como de una mquina servidor. Si desea ejecutar cualquier mandato de administracin, por ejemplo, crtmqm (crear gestor de colas) o strmqm (iniciar gestor de colas), su ID de usuario debe ser un miembro del grupo mqm. Para mquinas autnomas, puede crear localmente los nuevos ID de usuario y grupo. Para mquinas administradas en un dominio de servicios de informacin de red (NIS), los ID de usuario y de grupo pueden crearse en la mquina servidor maestro NIS. Creacin de otro sistema de archivos para el cdigo del producto Si no desea que el cdigo del producto se instale en el sistema de archivos /opt/mqm porque, por ejemplo, dicho sistema de archivos es demasiado pequeo para contener el producto, puede llevar a cabo una de estas dos operaciones: 1. Cree un nuevo sistema de archivos y mntelo como /opt/mqm. 2. En cualquier lugar de la mquina, cree un nuevo directorio que sea suficientemente grande para contener el producto y cree tambin un enlace simblico desde /opt/mqm a este nuevo directorio. Por ejemplo:
mkdir /bigdisk/mqm ln -s /bigdisk/mqm /opt/mqm
Notas: 1. Sea cual sea la opcin que escoja, debe hacerlo antes de instalar el cdigo del producto. 2. El sistema de archivos en el que se instala el cdigo puede ser un dispositivo remoto de la red, por ejemplo NFS, siempre y cuando las opciones de montaje se hayan definido en dicho dispositivo para que puedan ejecutarse los programas de setuid, incluido el acceso de usuario root.
Configuracin del kernel

MQSeries utiliza semforos, memoria compartida y descriptores de archivos, y es probable que la configuracin por omisin del kernel no sea la adecuada. En concreto, el nmero por omisin de semforos es 60, que no es suficiente para dar soporte a MQSeries. Si intenta utilizar MQSeries sin aumentar semmni, el nmero de semforos, el gestor de colas no se ejecuta correctamente y produce un archivo First Failure Support Technology (FFST). Este archivo indica que la llamada del sistema semop ha recibido un argumento que no es vlido. En la Figura 1 en la pgina 12
11
Configuracin del Kernel

pgina 12 se proporciona un ejemplo de un posible grupo de valores reales de kernel para todas las versiones Solaris a las que se da soporte. Sin embargo, para Sun Solaris el nmero de semforos y de conjuntos de semforos debe definirse de modo que sus estructuras de control ocupen menos del 25% del almacenamiento del kernel. Despus de la instalacin, debe revisar la configuracin de la mquina. Para ello, especifique el siguiente mandato:
sysdef -i
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Para cambiar los valores, aada una lnea set parameter = valor al archivo /etc/system. Para obtener ms informacin sobre la configuracin del sistema, consulte la documentacin de Sun Solaris System Administration.
set set set set set set set set set set set set set shmsys:shminfo_shmmax shmsys:shminfo_shmseg shmsys:shminfo_shmmni semsys:seminfo_semaem shmsys:shminfo_semmni semsys:seminfo_semmap semsys:seminfo_semmns semsys:seminfo_semmsl semsys:seminfo_semopm semsys:seminfo_semmnu semsys:seminfo_semume msgsys:msginfo_msgmap msgsys:msginfo_msgmax = = = = = = = = = = = = = 4294967295 1024 1024 16384 1024 1026 16384 100 100 2048 256 1026 4096
Figura 1. Valores de parmetros del kernel - valores de ejemplo en un sistema Solaris
Notas: 1. La utilizacin de la memoria compartida no vara con la permanencia o velocidad de los mensajes. 2. La utilizacin de semforos y de intercambios no vara con el tamao de los mensajes ni con la permanencia o velocidad de los mismos. 3. Los gestores de colas MQSeries son independientes entre s. Por lo tanto, los parmetros del kernel del sistema, como por ejemplo shmmni, semmni, semmns y semmnu, deben tener en cuenta el nmero de gestores de colas del sistema. Si desea informacin ms detallada, consulte el SupportPac adecuado, disponible en el sitio web de MQSeries en http://www.ibm.com/software/mqseries/. Sun Solaris tiene, por omisin, un lmite bajo flexible del sistema en lo que se refiere al nmero de descriptores de archivos. Cuando ejecute un proceso de mltiples hebras, es posible que alcance dicho lmite flexible de descriptores
12
Configuracin del Kernel

| | | de archivos. En este caso, recibira el cdigo de razn de MQSeries MQRC_UNEXPECTED_ERROR (2195) y si hay suficientes descriptores de archivos, un archivo MQSeries FFST. Para evitar este problema, puede aumentar el nmero de descriptores de archivos en el lmite flexible del sistema. Para aumentar el nmero de descriptores de archivos, edite el archivo /etc/system y cambie el valor del lmite de software del sistema de forma que coincida con el lmite estricto mximo del sistema (1024) aadiendo set rlim_fd_cur=1024. Adems, si ejecuta MQSeries bajo el servidor Lotus Domino, puede reducir el nmero de hebras del servidor activas en el proceso de Domino HTTP Server, abriendo el cuaderno Nombre y direccin del servidor y reduciendo el valor Nmero de hebras activas en el documento del servidor entre 50 y 60. | Migracin desde una versin anterior de MQSeries para Sun Solaris | | | | | | | | | | | | | | | | | | | | Se recomienda enrgicamente hacer una copia de seguridad de: v Los datos del gestor de colas v Las anotaciones del gestor de colas v Las definiciones de objetos del gestor de colas antes de empezar la migracin a una nueva versin de MQSeries. Para hacer una migracin de una versin anterior de MQSeries para Sun Solaris a MQSeries para Sun Solaris, V5.2, es necesario terminar toda la actividad de MQSeries en la mquina destino mediante endmqm. En el apartado Detencin de un gestor de colas en la pgina 56 encontrar ms informacin sobre cmo utilizar el mandato endmqm.
| |
Cambios en el manejo de seales

En MQSeries para Sun Solaris, V5.2 ha cambiado el modo en que se manejan las seales. Dichos cambios y los efectos en las aplicaciones existentes se describen en la publicacin MQSeries Versin 5.2 Gua del release.
Cambios realizados en qm.ini para los canales LU62 que utilizan Sunlink 9.1
En MQSeries para Sun Solaris, V5.2, es posible seleccionar qu software LU6.2 se utiliza. Para Sunlink 9.1, es necesario una nueva entrada en la seccin de LU6.2. Encontrar informacin detallada en la publicacin MQSeries Versin 5.2 Gua del release.
13
Instalacin del servidor Instalacin del servidor MQSeries para Sun Solaris
Esta seccin describe la instalacin del servidor MQSeries para Sun Solaris. Notas: 1. Si haba instalado antes MQSeries en el sistema, deber eliminar el producto con el programa pkgrm. Para ms informacin, consulte el apartado Migracin desde una versin anterior de MQSeries para Sun Solaris en la pgina 13. 2. Si el producto est en el sistema, pero no est instalado correctamente, es posible que tenga que suprimir manualmente los archivos y directorios que se encuentren en: /opt/mqm Lleve a cabo el siguiente procedimiento: 1. Monte el CD-ROM. 2. Utilice el programa Solaris pkgadd para instalar el software efectuando el siguiente procedimiento: | a. Escriba pkgadd -d /cdrom/mq_solaris. b. Se le solicitar una lista de componentes para instalar. Seleccione los que desee. Si desea instalar todo el producto MQSeries, seleccione todos. c. Pulse la tecla Intro. Para ms informacin sobre la utilizacin de pkgadd para instalar paquetes de software, consulte la documentacin de Solaris.
Instalacin remota
| | | | | Existe una instalacin remota que puede ejecutarse con el script silent.sh que est en el directorio silent, en el directorio raz del CD. Este script permite llevar a cabo una instalacin remota no interactiva de MQSeries, que no produce ninguna salida y no requiere ninguna entrada. Encontrar ms informacin sobre ello en el archivo script silent.sh. Nota: Para utilizar la instalacin remota, es necesario modificar el archivo de respuestas de la forma que se describe en la documentacin de pkgadd y, a continuacin, ejecutar
./silent.sh
Instalacin del servidor y del cliente en la misma mquina

Para instalar un cliente MQSeries para Sun Solaris en la mquina servidor, utilice el CD-ROM MQSeries Servidor. Elija la opcin de instalacin del cliente del CD-ROM del servidor para instalar el cdigo cliente en la mquina servidor. No utilice el CD-ROM MQSeries Cliente.
14
Instalacin del servidor y del cliente

Si lo desea, puede instalar componentes desde el CD-ROM MQSeries Cliente en una mquina y ms adelante puede optar por instalar el componente servidor MQSeries en la misma mquina. Si es as, antes debe eliminar de la mquina todos los componentes instalados desde el CD-ROM de clientes MQSeries. A continuacin, puede utilizar el CD-ROM MQSeries Servidor para instalar el servidor, el cliente y los dems componentes que necesite. No puede instalar el servidor en una mquina que ya tenga otros componentes instalados desde el CD-ROM MQSeries Clientes. Si desea ver ms informacin sobre la instalacin del cliente en una mquina distinta de la del servidor, consulte el apartado Captulo 3. Instalacin del cliente MQSeries para Sun Solaris en la pgina 25. | Soporte para Java en MQSeries | | | | | | | Si tienen aplicaciones que necesitan soporte para Java en MQSeries, es necesario instalarlo por separado despus de instalar MQSeries. El soporte para Java en MQSeries se puede instalar por separado del CD-ROM incluido en este paquete de producto. De forma alternativa, el soporte para Java de MQSeries se puede bajar del sitio Web MQSeries en
http://www.ibm.com/software/mqseries
donde siempre est disponible la versin ms reciente de este soporte.
Mensajes traducidos
Los mensajes en ingls de EE UU siempre estn disponibles. Si necesita algn otro idioma para el que MQSeries para Sun Solaris, V5.2 tenga soporte, debe asegurarse de que la variable de entorno NLSPATH incluye el directorio adecuado. Por ejemplo:
export LANG=de export NLSPATH=/usr/lib/locale/%L/LC_MESSAGES/%N
Manuales traducidos
Si decide instalar el componente de Documentacin en lnea, tendr los manuales en el idioma especificado al instalar el sistema operativo. No obstante, es posible que algunas de las publicaciones slo estn disponibles en ingls de EE UU y que algunos de los enlaces de hipertexto entre manuales no funcionen. Para solucionar este problema, debe instalar un juego completo de manuales en ingls de EE UU adems de instalar los manuales en su
15
Manuales traducidos
propio idioma. Si desea ver ms informacin sobre el enlace de hipertexto entre manuales traducidos, consulte el apartado Informacin en lnea en la pgina 66.
Verificacin de la instalacin de MQSeries para Sun Solaris

Esta seccin describe cmo verificar que MQSeries para Sun Solaris se ha instalado y configurado correctamente. Para ello, siga los pasos que se indican en el apartado Procedimiento de verificacin Si desea verificar un enlace de comunicaciones entre varias instalaciones MQSeries (por ejemplo, entre dos servidores o entre un cliente y un servidor), asegrese de que se han instalado (y configurado) en ambas mquinas los protocolos de comunicaciones necesarios. Los protocolos a los que se da soporte son TCP y SNA. Nota: En los siguientes ejemplos se da por supuesto que est utilizando una conexin TCP; si desea ver ms informacin sobre la utilizacin de otros protocolos, consulte el manual MQSeries Intercommunication. Sin embargo, tambin puede verificar la instalacin local (la cual no tiene enlaces de comunicaciones con otras instalaciones MQSeries) sin ningn protocolo de comunicaciones instalado.
Procedimiento de verificacin
Puede verificar la instalacin de MQSeries a tres niveles: v Una instalacin local (autnoma), en la que no hay enlaces de comunicaciones con otras mquinas MQSeries v Una instalacin servidor a servidor, en la que hay enlaces de comunicaciones con otros servidores MQSeries v Una instalacin cliente/servidor, en la que hay enlaces de comunicaciones entre una mquina servidor y un cliente MQSeries | | | | | La verificacin de las instalaciones local y de servidor a servidor se describe en los apartados Verificacin de una instalacin local y Verificacin de una instalacin servidor a servidor en la pgina 18. Para ms informacin sobre la verificacin de una instalacin cliente/servidor, consulte el apartado Verificacin de la instalacin en la pgina 29. Verificacin de una instalacin local Antes de verificar la instalacin local con las aplicaciones de ejemplo, compruebe que /opt/mqm/samp/bin est incluido en la variable de entorno PATH.
| | |
16
Verificacin de la instalacin
Siga los pasos siguientes para instalar y probar una configuracin sencilla de un gestor de colas y una cola, utilizando las aplicaciones de ejemplo para transferir un mensaje a la cola y para leer el mensaje de la cola: | | 1. Instale MQSeries para Sun Solaris en la estacin de trabajo (incluya como mnimo el servidor y los componentes de ejemplo). 2. Crear un gestor de colas por omisin (en este ejemplo denominado venus.queue.manager): v En el indicador de mandatos de la ventana, especifique lo siguiente:
crtmqm -q venus.queue.manager
v Pulse Intro. Aparecern mensajes que indicarn que se ha creado el gestor de colas y que se han creado los objetos por omisin de MQSeries. Nota: En releases anteriores de MQSeries era necesario ejecutar un archivo script llamado amqscoma.tst para definir los objetos por omisin de MQSeries. En este release del producto no hace falta seguir este paso. 3. Inicie el gestor de colas por omisin: v Escriba strmqm y pulse Intro. Un mensaje le indicar que el gestor de colas se ha iniciado. 4. Para habilitar los mandatos MQSC: v Escriba runmqsc y pulse Intro. Nota: MQSC se ha iniciado cuando aparece el siguiente mensaje:
Arrancando mandatos MQSeries.
| |
MQSC no tiene indicador de mandatos. 5. Defina una cola local (en este ejemplo, ORANGE.QUEUE): v Especifique lo siguiente y pulse Intro:
define qlocal (orange.queue)
Nota: Cualquier texto que se especifique en MQSC en minsculas se convierte automticamente a maysculas a no ser que lo delimite con apstrofos. Esto significa que si crea una cola con el nombre orange.queue, debe acordarse de hacer referencia a la misma como ORANGE.QUEUE en todos los mandatos que no sean MSQC. El mensaje Cola MQSeries creada aparece cuando se crea la cola. Ha definido: v Un gestor de colas por omisin llamado venus.queue.manager v Una cola llamada ORANGE.QUEUE
17
6. Detenga MQSC escribiendo end y pulsando Intro. Aparece el siguiente mensaje:
Un mandato MQSC ledo. Ningn mandato tiene ningn error de sintaxis. Se han procesado todos los mandatos MQSC vlidos.
7. Aparece de nuevo el indicador de mandatos. Para probar la cola y el gestor de colas, utilice los ejemplos amqsput (para transferir un mensaje a la cola) y amqsget (para obtener el mensaje de la cola): 1. Si no est indicado en la sentencia PATH, vaya al siguiente directorio:
/opt/mqm/samp/bin
2. Para transferir un mensaje a la cola, especifique el siguiente mandato y pulse Intro:

./amqsput ORANGE.QUEUE
Aparece el siguiente mensaje: | |

Inicio de ejemplo AMQSPUT0 cola de destino es ORANGE.QUEUE
3. Escriba un texto de mensaje y pulse Intro dos veces. Aparece el siguiente mensaje: |
Fin de ejemplo AMQSPUT0
Ahora el mensaje est en la cola y vuelve a aparecer el indicador de mandatos. 4. Para obtener el mensaje de la cola, especifique el siguiente mandato y pulse Intro:
./amqsget ORANGE.QUEUE
Se inicia el programa de ejemplo, aparece el mensaje, finaliza el ejemplo y vuelve a aparecer el indicador de mandatos. Ha finalizado la verificacin. Verificacin de una instalacin servidor a servidor Los pasos que se deben seguir para verificar una instalacin servidor a servidor son ms complejos, puesto que se debe comprobar el enlace de comunicaciones entre las dos mquinas. Siga los pasos siguientes para configurar las dos estaciones de trabajo, una como emisora y otra como receptora. Estacin de trabajo emisora: 1. Cree un gestor de colas por omisin denominado saturn.queue.manager:
18
v En el indicador de mandatos de una ventana, especifique:
crtmqm -q saturn.queue.manager
v Pulse Intro. Aparecern mensajes que le indicarn que se ha creado el gestor de colas y que se han creado los objetos por omisin de MQSeries. Nota: En algunos releases anteriores de MQSeries era necesario ejecutar un archivo script llamado amqscoma.tst para definir los objetos por omisin de MQSeries. En este release del producto no hace falta seguir este paso. 2. Inicie el gestor de colas: v Especifique lo siguiente y pulse Intro:
strmqm
Un mensaje le indicar que el gestor de colas se ha iniciado. 3. Habilite los mandatos de MQSeries (MQSC) especificando el siguiente mandato y pulsando Intro:
runmqsc
Nota: MQSC se ha iniciado cuando aparece el siguiente mensaje:

MQSC no tiene indicador de mandatos 4. Defina una cola local para utilizar como cola de transmisin denominada TRANSMIT1.QUEUE: v Especifique lo siguiente y pulse Intro:
define qlocal (transmit1.queue) usage (xmitq)
El mensaje Cola MQSeries creada aparece cuando se crea la cola. 5. Cree una definicin local de la cola remota:
define qremote (local.def.of.remote.queue) rname (orange.queue) + rqmname ('venus.queue.manager') xmitq (transmit1.queue)
Nota: El parmetro RNAME especifica el nombre de la cola en la mquina remota a la que se enva el mensaje. Por lo tanto, el nombre especificado con el parmetro RNAME (ORANGE.QUEUE) debe coincidir con el nombre de la cola a la que se enva el mensaje (ORANGE.QUEUE en la estacin de trabajo receptora). 6. Defina un canal emisor:
define channel (first.channel) chltype (sdr) conname (9.20.11.182) + xmitq (transmit1.queue) trptype (tcp)
19
| | | | | | Notas: a. El valor 9.20.11.182 es la direccin TCP de la estacin de trabajo receptora (tenga en cuenta que este ejemplo es especfico de TCP). b. Si es necesario, puede utilizarse de manera explcita el nmero de puerto, por ejemplo(9.20.11.182(8192)). Ha definido los siguientes objetos: v Un gestor de colas por omisin denominado saturn.queue.manager v Una cola de transmisin denominada TRANSMIT1.QUEUE v Una cola remota denominada LOCAL.DEF.OF.REMOTE.QUEUE v Un canal emisor llamado FIRST.CHANNEL 7. Detenga MQSC escribiendo end y pulsando Intro. Ahora configure la estacin de trabajo receptora. Estacin de trabajo receptora: Nota: Para efectuar los pasos 1 a 4 debe haberse conectado como superusuario o root. 1. Edite el archivo /etc/services. Si no tiene la siguiente lnea en dicho archivo, adala:
MQSeries 1414/tcp # receptor canal MQSeries
2. Edite el archivo /etc/inetd.conf. Si no tiene la siguiente lnea en dicho archivo, adala:

MQSeries stream tcp nowait mqm /opt/mqm/bin/amqcrsta amqcrsta
Nota: Si no est creando venus.queue.manager (en el paso 5) como gestor de colas por omisin en esta estacin de trabajo, aada -m venus.queue.manager al final de la lnea para especificar el nombre de gestor de colas que debe utilizarse. 3. Busque el ID de proceso de inetd con el siguiente mandato:
ps -ef | grep inetd
4. Ejecute el mandato:
kill -1 inetd idproceso
5. Crear un gestor de colas por omisin (en este ejemplo denominado venus.queue.manager): v En el indicador de mandatos, escriba lo siguiente:
crtmqm -q venus.queue.manager
v Pulse Intro. Aparecern mensajes que le indicarn que se ha creado el gestor de colas y que se han creado los objetos por omisin de MQSeries.
20
Nota: En algunos releases anteriores de MQSeries era necesario ejecutar un archivo script llamado amqscoma.tst para definir los objetos por omisin de MQSeries. En este release del producto no hace falta seguir este paso. 6. Inicie el gestor de colas: v Especifique lo siguiente y pulse Intro:
strmqm
Un mensaje le indicar que el gestor de colas se ha iniciado. 7. Habilite MQSC especificando el siguiente mandato y pulsando Intro:
runmqsc
Nota: MQSC se ha iniciado cuando aparece el siguiente mensaje:

MQSC no tiene indicador de mandatos. 8. Defina una cola local (en este ejemplo, ORANGE.QUEUE): v Especifique lo siguiente y pulse Intro:
define qlocal (orange.queue)
El mensaje
Cola MQSeries creada
aparece cuando se crea la cola. 9. Cree un canal receptor:

define channel (first.channel) chltype (rcvr) trptype (tcp)
Ha definido los siguientes objetos: v Un gestor de colas por omisin llamado venus.queue.manager v Una cola llamada ORANGE.QUEUE v Un canal receptor llamado FIRST.CHANNEL 10. Detenga MQSC especificando end y pulsando Intro. Establecimiento de comunicaciones entre las estaciones de trabajo: 1. Si por alguna razn los gestores de colas de las dos estaciones de trabajo se hubieran detenido, vulvalos a iniciar ahora (con el mandato strmqm). 2. En la estacin de trabajo emisora, inicie el canal emisor entrando el siguiente mandato:
runmqchl -c FIRST.CHANNEL -m saturn.queue.manager
El canal receptor de la estacin de trabajo receptora se inicia automticamente cuando se inicia el canal emisor.
21
3. En la estacin de trabajo emisora, utilice el programa de ejemplo amqsput para enviar un mensaje a la cola de la estacin de trabajo receptora:
amqsput LOCAL.DEF.OF.REMOTE.QUEUE
Nota: El mensaje se transfiere a la definicin local de la cola remota, la cual, a su vez, especifica el nombre de la cola remota. 4. Escriba el texto del mensaje y pulse la tecla Intro dos veces. 5. En la estacin de trabajo receptora, utilice el programa de ejemplo amqsget para obtener el mensaje de la cola:
amqsget ORANGE.QUEUE
Aparece el mensaje. Ha finalizado la verificacin.
Salidas de usuario
| | Compruebe que las salidas de usuario estn enlazadas con las bibliotecas enhebradas antes de utilizarlas en esta versin del producto. En el manual MQSeries Application Programming Guide encontrar informacin ms detallada sobre las bibliotecas enhebradas.
Definicin del CCSID del gestor de colas en MQSeries para Sun Solaris
El identificador de juego de caracteres codificado (CCSID) se determina al crear el gestor de colas. El CCSID utilizado es el que corresponde al conjunto de cdigos del entorno nacional (locale) que est usando para ejecutar el mandato crtmqm. | | | | | | | | | | | Ejemplos de definicin del CCSID en Solaris Versiones 2.6 y 7:
export LANG=en_US export LANG=pl
Ejemplos de definicin del CCSID en Solaris 8:

export LANG=en_US.ISO8859-1 utiliza el conjunto de cdigos ISO8859-1 y define el CCSID 819 export LANG=pl_PL.ISO8859-2 utiliza el conjunto de cdigos ISO8859-2 y define el CCSID 912
Para modificar un CCSID de gestor de colas existente, siga este procedimiento:
22
CCSID del gestor de colas

1. Anote el CCSID del gestor de colas existente utilizando el mandato de MQSeries (MQSC):
DISplay QMGR CCSID
2. Cambie el CCSID por el nuevo CCSID utilizando el mandato MQSC:

ALTer QMGR CCSID
3. Detenga el gestor de colas. 4. Reinicie el gestor de colas y todos los canales que utilice.
23
CCSID del gestor de colas
24
| | | | | | | | | |
Captulo 3. Instalacin del cliente MQSeries para Sun Solaris

En este captulo se describe cmo: v Planificar la instalacin del cliente MQSeries para Sun Solaris. v Instalar el cliente MQSeries para Sun Solaris en una mquina distinta de la del servidor MQSeries, con el CD-ROM MQSeries Cliente. v Verificar la comunicacin entre el cliente MQSeries para Sun Solaris y un servidor MQSeries. Nota: El cliente MQSeries se instala en el directorio /opt/mqm. Dicho directorio no puede cambiarse.
| | Planificacin de la instalacin del cliente MQSeries para Sun Solaris | | | | | | | | | | | | | | | | | | | | | | | | En esta seccin se describe: v El hardware y el software necesarios para el cliente MQSeries para Sun Solaris v Tareas que deben llevarse a cabo antes de instalar el cliente MQSeries para Sun Solaris
Requisitos de hardware
El cliente MQSeries para Sun Solaris: v Puede instalarse en todos los sistemas servidor o de sobremesa Sun SPARC y en los sistemas servidor y de sobremesa Sun UltraSPARC, soportados por el release adecuado del entorno operativo Solaris. Para ms informacin sobre el entorno operativo necesario, vea el apartado Requisitos de software. v Requiere un mnimo de 25 MB de espacio en disco. Nota: No existe soporte para sistemas Solaris de otros fabricantes.
Se indican los niveles mnimos soportados. Los ltimos niveles compatibles, si los hay, estn soportados a no ser que se indique lo contrario. v Sun Solaris Versin 2.6 con los parches 10518112 10521019 10773306 10556813 10559105 (necesario si se utiliza C++) 10612505
25
Planificacin de la instalacin del cliente

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | v Sun Solaris 7 con los parches 107171-02 107544-03 106541-09 106950-03 106980-05 106327-05 (necesario si se utiliza C++) Notas: 1. 107544-03 debe instalarse antes que el 106541-09. 2. 106541-09 es el mnimo nivel recomendado de parche de actualizacin del kernel. v Sun Solaris 8 Actualmente no se tiene ningn conocimiento de los parches necesarios para Solaris 8, sin embargo recomendamos leer el archivo README en el que encontrar la informacin ms reciente.
Conectividad
Los protocolos de red soportados son SNA LU 6.2 y TCP. Para la conectividad SNA, puede utilizar SunLink SNA Peer-to-Peer Versin 9.1 o SNAP-IX (SPARC Platform Edition), V6.2 o posterior. Si se utiliza la red en anillo: es necesario el controlador Sun TRI 4.0 o posterior. TCP/IP forma parte del sistema operativo base. En MQSeries para Sun Solaris, V5.2, se han incorporado mejoras gracias a las cuales ser ms provechoso combinar el uso de DHCP con los clusters del gestor de colas MQSeries. Para ms informacin sobre la especificacin del producto SNA que desea utilizar (SunLink SNA o Data Connection SNAP-IX), vea el apartado MQSeries Versin 5.2 Gua del release.
Compiladores soportados para las aplicaciones Solaris

v v v v v v v Compilador C de Sun Workshop 4.2 Compilador C++ de Sun Workshop 4.2 Compilador C de Sun Workshop 5.0 Compilador C++ de Sun Workshop 5.0 Forte C 6 (Sun Workshop 6 C) Forte C++ 6 (Sun Workshop 6 C++) Merant Server Express V1.1
El directorio de instalacin
Para instalar MQSeries en un sistema Sun Solaris, utilice el CD-ROM MQSeries Cliente que se suministra como parte del producto MQSeries.
26
Planificacin de la instalacin del cliente

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Nota: Si piensa instalar en la misma mquina un cliente y un servidor MQSeries, consulte el apartado Instalacin del servidor y del cliente en la misma mquina en la pgina 14. El cliente MQSeries para Sun Solaris se instala en el directorio /opt/mqm. Esto no puede cambiarse.
Antes de la instalacin
Antes de instalar el cliente MQSeries para Sun Solaris, debe: v Leer el archivo README para obtener la informacin ms reciente. v Crear un grupo con el nombre mqm. v Crear un ID de usuario con el nombre mqm. v Crear y montar un sistema de archivos /var/mqm o los sistemas de archivos /var/mqm, /var/mqm/log, y /var/mqm/errors. Notas: 1. Si crea particiones separadas, el directorio /var/mqm debe estar en un sistema de archivos local. Puede montar con NFS los directorios /var/mqm/errors y /var/mqm/trace para ahorrar espacio en el sistema local. 2. Tras la instalacin, el ID de usuario mqm es el propietario de los directorios y archivos que contienen los recursos asociados al producto. Este grupo y usuario deben definirse para cada mquina en la que vaya a instalarse el software MQSeries, tanto si se trata de una mquina cliente como de una mquina servidor. 3. Para mquinas autnomas, puede crear localmente los nuevos ID de usuario y grupo (o permitir que se creen automticamente durante la instalacin). Para mquinas administradas en un dominio de servicios de informacin de red (NIS), los ID de usuario y grupo deben crearse en la mquina servidor maestro NIS antes de la instalacin.
Configuracin del kernel

En el sitio web de la familia MQSeries que est en http://www.ibm.com/software/mqseries/ encontrar un SupportPac que proporciona informacin adicional sobre el rendimiento.
| | Migracin desde una versin anterior de MQSeries para Sun Solaris | | | | | Se recomienda enrgicamente hacer una copia de seguridad de: v Los datos del gestor de colas v Las anotaciones del gestor de colas v Las definiciones de objetos del gestor de colas antes de empezar la migracin a una nueva versin de MQSeries.
27
Migracin desde una versin anterior

| | | | | | | | | | | | | | | | | | Para hacer una migracin de una versin anterior de MQSeries para Sun Solaris a MQSeries para Sun Solaris, V5.2, primero es necesario terminar toda la actividad de MQSeries en la mquina destino mediante endmqm. En el apartado Detencin de un gestor de colas en la pgina 56 encontrar ms informacin sobre cmo utilizar el mandato endmqm. Compruebe si hay segmentos de memoria compartida y semforos mediante ipcs -a. A continuacin, debe utilizar el mandato ipcrm para eliminar todos los semforos y segmentos de memoria compartida. Si no eliminara todos los semforos y segmentos de memoria compartida antes de llevar a cabo la desinstalacin, es posible que las versiones posteriores de MQSeries no funcionen correctamente. Ahora ya puede instalar MQSeries para Sun Solaris, V5.2, como se describe en Instalacin del cliente MQSeries para Sun Solaris.
Cambios en el manejo de seales

En MQSeries para Sun Solaris, V5.2 ha cambiado el modo en que se manejan las seales. Dichos cambios y los efectos en las aplicaciones existentes se describen en la publicacin MQSeries Versin 5.2 Gua del release.
| | Instalacin del cliente MQSeries para Sun Solaris | | | | | | | | | | | Para instalar el cliente MQSeries para Sun Solaris, lleve a cabo el siguiente procedimiento: 1. Compruebe si el Gestor de volmenes est ejecutndose en el sistema escribiendo el siguiente mandato:
/usr/bin/ps -ef | /bin/grep vold
Si est ejecutndose, el CDROM se monta automticamente en /cdrom/mq_solaris. Si no est ejecutndose, monte el CD-ROM escribiendo los siguientes mandatos:
mkdir -p /cdrom/mqclient mount -F hsfs -r /dev/dsk/cntndnsn /cdrom/mqclient
sustituyendo cntndnsn por el nombre del dispositivo CD-ROM.
28
Instalacin del cliente

| | | | | | | | | | | | | | | | 2. Utilice el programa pkgadd de Sun Solaris para instalar el software efectuando el siguiente procedimiento: a. Escriba pkgadd -d /cdrom/mqclient. b. Se le solicitar una lista de componentes para instalar. Seleccione los que desee. Si desea instalar todo el cliente MQSeries, seleccione todos. c. Pulse la tecla Intro. Para ms informacin sobre la utilizacin de pkgadd para instalar paquetes de software, consulte la documentacin de Solaris.
Mensajes traducidos
Los mensajes en ingls de EE UU siempre estn disponibles. Si necesita algn otro idioma para el que MQSeries para Sun Solaris tenga soporte, debe asegurarse de que la variable de entorno NLSPATH incluye el directorio adecuado. Por ejemplo, para seleccionar mensajes en alemn, haga lo siguiente:
export LANG=de export NLSPATH=/usr/lib/locale/%L/LC_MESSAGES/%N
| | Verificacin de la instalacin | | | | | | | | | | | | | | | | | | Puede verificar la instalacin del cliente y servidor MQSeries mediante los programas de ejemplo PUT y GET que se suministran. Dichos programas verifican que la instalacin haya sido satisfactoria y que el enlace de comunicaciones funcione correctamente. Antes de empezar, asegrese de tener el mismo ID de usuario tanto en el sistema cliente como en el sistema servidor. Para ms informacin sobre seguridad y las razones por las que debe tener el mismo ID de usuario, consulte la publicacin MQSeries Intercommunication.
Cmo se lleva a cabo

A continuacin se proporcionan instrucciones sobre cmo utilizar los programas PUT y GET de ejemplo para verificar que un cliente MQSeries se haya instalado correctamente. stas le conducirn por las siguientes tareas: 1. Configurar el servidor 2. 3. 4. 5. Configurar el cliente MQSeries Poner un mensaje en la cola Obtener un mensaje de la cola Finalizar la verificacin
29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
La instalacin utilizada para el ejemplo

Las instrucciones dan por supuesto que: v Se ha instalado todo el producto MQSeries en una mquina servidor UNIX. Si conecta el cliente MQSeries para Sun Solaris a un servidor que no est ejecutando UNIX MQSeries, en la publicacin MQSeries Clientes encontrar instrucciones para la verificacin. v Se ha instalado el software de cliente MQSeries para Sun Solaris en la mquina cliente. v TCP/IP est configurado e inicializado en las mquinas servidor y cliente. Qu muestra el ejemplo En el siguiente ejemplo se muestra cmo crear un gestor de colas denominado saturn.queue.manager, una cola local denominada QUEUE1 y un canal de conexin con el servidor denominado CHANNEL1 en el servidor. Muestra cmo crear el canal de conexin con el cliente en la estacin de trabajo cliente MQSeries as como a utilizar los programas de ejemplos para poner un mensaje en una cola y obtenerlo de la cola. Nota: Las definiciones de objetos MQSeries son sensibles a las maysculas y minsculas. Debe escribir los ejemplos exactamente tal como se indican. Seguridad: En el ejemplo no sa tratan los temas de seguridad del cliente. En la publicacin MQSeries Clientes encontrar informacin detallada sobre los temas de seguridad del cliente MQSeries.
Configuracin del servidor

En el servidor, cree un directorio para guardar los archivos de trabajo (por ejemplo mqverify), y desplcese a dicho directorio. Para configurar la estacin de trabajo servidor, siga estos pasos: 1. Cree un gestor de colas por omisin denominado saturn.queue.manager escribiendo el siguiente mandato en el indicador de mandatos:
crtmqm -q saturn.queue.manager
2. Inicie el gestor de colas escribiendo el siguiente mandato:

strmqm
3. Inicie los mandatos de MQSeries (MQSC) especificando el siguiente mandato:

runmqsc
MQSC no proporciona ningn indicador pero debe responder con el mensaje:

4. Cree una cola local denominada QUEUE1 especificando el siguiente mandato:

DEFINE QLOCAL(QUEUE1)
30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5. Crear un canal de conexin con el servidor especificando el siguiente mandato:
DEFINE CHANNEL(CHANNEL1) CHLTYPE(SVRCONN) TRPTYPE(TCP) MCAUSER(' ')
6. Detenga MQSC especificando end y pulsando Intro. 7. Configure un escucha para iniciar los canales MQI. Para iniciar los canales MQI puede utilizar el escucha UNIX TCP estndar o el escucha MQSeries. Por razones de rendimiento, se recomienda utilizar el escucha MQSeries. Como alternativa, para configurar el escucha MQSeries para que inicie los canales MQI, utilice el mandato de control runmqlsr:
runmqlsr -m gestor_colas -t TCP -p nmero puerto
Para ejecutar el trabajo como proceso subordinado, aada un carcter ampersand (&) al final del mandato. Para configurar el daemon inetd para que inicie los canales MQI, debe haberse conectado como superusuario o root. a. Edite el archivo /etc/services. Si no tiene la siguiente lnea en dicho archivo, adala:
MQSeries 1414/tcp # escucha de canal MQSeries
1414 es el nmero de puerto por omisin. Si utiliza otro puerto, especifique su nmero en su lugar. b. Edite el archivo /etc/inetd.conf. Si no tiene la siguiente lnea en dicho archivo, adala:
MQSeries stream tcp nowait mqm /opt/mqm/bin/amqcrsta amqcrsta
Nota: Si saturn.queue.manager no es el gestor de colas por omisin en esta estacin de trabajo, deber aadir -m saturn.queue.manager al final de la lnea. c. Ejecute el mandato:
kill -1 inetd idproceso
Configuracin del cliente

Al ejecutar la aplicacin MQSeries en el cliente MQSeries, la informacin que ste necesita es la siguiente: v El nombre del canal MQI v El protocolo de comunicaciones v La direccin del servidor Debe proporcionar esta informacin definiendo un canal de conexin con el cliente. El nombre utilizado para este canal debe ser el nombre utilizado para el canal de conexin con el servidor definido en el servidor. En este ejemplo
31
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | se utiliza la variable de entorno MQSERVER para definir el canal de conexin con el cliente. Es la forma ms fcil, aunque no la nica. Antes de empezar, escriba ping direccin-servidor (donde direccin-servidor es el nombre de sistema principal TCP/IP del servidor) para confirmar que se han inicializado las sesiones TCP/IP del cliente y del servidor MQSeries. En vez del nombre del sistema principal, puede utilizar la direccin de red, en el formato n.n.n.n, en el mandato ping. Si el mandato ping no se ejecuta correctamente, verifique que el software de TCP/IP est bien configurado y que se haya iniciado. Definicin de un canal de conexin con el cliente utilizando MQSERVER Cree un canal de conexin con el cliente estableciendo la variable de entorno MQSERVER como se indica a continuacin:
MQSERVER=CHANNEL1/TCP/'direccin-servidor(puerto)'
y, a continuacin,
export MQSERVER
donde: CHANNEL1 Es el nombre del canal de conexin con el servidor ya definido en el servidor. TCP Es el protocolo de comunicaciones.
direccin-servidor Es el nombre de sistema principal TCP/IP del servidor. (puerto) Es opcional y es el nmero de puerto TCP/IP en el que el servidor est a la escucha. Si no se indica ningn nmero de puerto, MQSeries utilizar el especificado en el archivo QM.INI. Si no se especifica ningn valor en el archivo QM.INI, MQSeries utiliza el nmero de puerto identificado en el archivo de servicios TCP/IP para el nombre de servicio MQSeries. Si esta entrada del archivo de servicios no existe, se utiliza el valor por omisin 1414. Es importante que el nmero de puerto que el cliente utiliza y el nmero de puerto utilizado por el programa de escucha del servidor sean el mismo.
Cmo poner un mensaje en la cola

En primer lugar, asegrese de que /opt/mqm/samp/bin est incluido en la variable de entorno PATH. En la estacin de trabajo del cliente MQSeries, ponga un mensaje en la cola utilizando el programa de ejemplo AMQSPUTC:
32
| | | | | | | | | | | | | | | | | | | | | | | | 1. Entre el siguiente mandato:
amqsputc QUEUE1 saturn.queue.manager
donde saturn.queue.manager es el nombre del gestor de colas del servidor. Aparece el siguiente mensaje:
Inicio de ejemplo AMQSPUT0 nombrecola de destino es QUEUE1
2. Escriba un texto de mensaje y pulse Intro dos veces. Aparece el siguiente mensaje:
Fin de ejemplo AMQSPUT0
El mensaje est ahora en la cola.
Cmo obtener el mensaje de la cola

En la estacin de trabajo del cliente MQSeries, obtenga un mensaje de la cola utilizando el programa de ejemplo amqsgetc: v Desde el directorio que contiene los programas de ejemplo, entre el siguiente mandato:
amqsgetc QUEUE1 saturn.queue.manager
donde saturn.queue.manager es el nombre del gestor de colas del servidor. El mensaje se elimina de la cola y se visualiza.
Finalizacin de la verificacin
Ha finalizado la verificacin. Puede detener el gestor de colas en el servidor escribiendo:
endmqm -w saturn.queue.manager
Si desea suprimir el gestor de colas del servidor, escriba

dltmqm saturn.queue.manager
33
34
Captulo 4. Aplicacin de mantenimiento a MQSeries para Sun Solaris

Este captulo le explica cmo aplicar mantenimiento a MQSeries para Sun Solaris. Las actualizaciones de mantenimiento en el formato de un Arreglo temporal del programa (PTF), tambin denominadas CSD, se proporcionan en CD-ROM. Tambin pueden bajarse de:
Atencin Durante la instalacin de mantenimiento en MQSeries para AIX, no debe haber ningn gestor de colas en funcionamiento. Para finalizar todos los gestores de colas en ejecucin, emita los mandatos:
endmqm -i Nombregc endmqlsr -m Nombregc
Requisitos de espacio
Para su instalacin, un PTF necesita espacio en el disco duro. Adems, el proceso de instalacin requiere exactamente la misma cantidad de espacio en disco para guardar el nivel anterior. Por ejemplo, un PTF de 16 MB requiere 32 MB de espacio. Esto permite la eliminacin de un PTF y la restauracin automtica del nivel anterior. Si el espacio en disco es limitado, puede suprimirse la copia de seguridad creando un archivo indicador vaco con el nombre MQPTF_NOSAVE en el directorio /var/sadm/pkg. Tenga en cuenta que si utiliza esta opcin no se restaurar el nivel anterior si se elimina un PTF. En ese caso, la nica forma de restaurar un nivel anterior sera reinstalar el producto y aplicar de nuevo una imagen de PTF anterior.
35
Requisitos de espacio Aplicacin de la informacin de mantenimiento

1. Monte el CD-ROM. 2. Instale el software como se indica a continuacin: a. Escriba pkgadd -d /cdrom/mq_solaris/mqm/patchname. b. Pulse la tecla Intro. Para ms informacin sobre la utilizacin de pkgadd para instalar paquetes de software, consulte la documentacin de Solaris.
Restauracin del nivel anterior de servicio

Para restaurar el nivel de servicio anterior: 1. Inicie la sesin como root o utilice el mandato su. 2. Utilice el mandato pkgrm para eliminar del sistema el ltimo PTF. Por ejemplo, para eliminar el PTF U469913, emita el siguiente mandato:
pkgrm mqm.upd02
Nota: Los mensajes de error visualizados con el formato <no se ha eliminado la va de acceso compartida> pueden pasarse por alto. Encontrar informacin detallada sobre el mandato pkgrm en la documentacin de Solaris o utilizando el mandato man pkgrm. 3. Si instal un cliente MQI y dicho cliente se actualiz despus de instalar el PTF que va a eliminar, deber volver a actualizar especficamente la instalacin del cliente MQI despus de haber suprimido el PTF.
36
| | | |
Captulo 5. Desinstalacin de MQSeries para Sun Solaris

Utilice el programa pkgrm para desinstalar MQSeries del sistema Sun Solaris. Si por alguna razn el producto no se haba instalado correctamente, deber suprimir los archivos y directorios incluidos en /opt/mqm.
37
38
Parte 2. Iniciacin a MQSeries

Captulo 6. Acerca de MQSeries . . . . 41 Introduccin . . . . . . . . . . . . 41 Mensajes, colas y gestores de colas . . . . 42 Mensajes . . . . . . . . . . . . 42 Colas . . . . . . . . . . . . . 42 Gestores de colas . . . . . . . . . 43 Configuraciones de MQSeries . . . . . . 44 Canales . . . . . . . . . . . . 45 Clientes y servidores . . . . . . . . 45 Clusters . . . . . . . . . . . . 46 Posibilidades de MQSeries . . . . . . . 47 Soporte de transacciones . . . . . . . 47 Sucesos de instrumentacin . . . . . . 48 Proceso dirigido por mensajes . . . . . 49 Programacin de MQSeries . . . . . . . 50 Captulo 7. Utilizacin de los conjuntos de mandatos de MQSeries. . . . . . . . Introduccin de los conjuntos de mandatos Mandatos de control . . . . . . . . Utilizacin de los mandatos de control Mandatos MQSeries (MQSC) . . . . . Ejecucin de los mandatos MQSC . . . Mandatos PCF . . . . . . . . . . Trabajo con gestores de colas . . . . . . Creacin de un gestor de colas por omisin . . . . . . . . . . . . Inicio de un gestor de colas . . . . . . Detencin de un gestor de colas . . . . Cierre progresivo . . . . . . . . Cierre inmediato . . . . . . . . Cierre preferente . . . . . . . . Supresin de un gestor de colas . . . . Trabajo con objetos MQSeries . . . . . . Utilizacin del recurso MQSC de forma interactiva . . . . . . . . . . . Informacin de retorno de los mandatos MQSC . . . . . . . . . . . . Finalizacin de la entrada interactiva de MQSC . . . . . . . . . . . . . Definicin de una cola local . . . . . . Visualizacin de los atributos de objetos por omisin . . . . . . . . . . . Copia de una definicin de cola local . . Modificacin de los atributos de una cola local . . . . . . . . . . . . Supresin de los mensajes de una cola local . . . . . . . . . . . . Supresin de una cola local . . . . . Examen de las colas . . . . . . . . 61 . 61 . 61 . 62
Captulo 8. Utilizacin de MQSeries Internet Gateway . . . . . . . . . . 63 Visin general de MQSeries Internet Gateway 63 Documentacin de MQSeries Internet Gateway . . . . . . . . . . . . . 64
51 51 51 52 54 54 54 55 55 55 56 56 56 56 57 57 57 58 58 58 59 60
| | | | | | | | | | | |
Captulo 9. Obtencin de informacin adicional . . . . . . . . . . . . . Manuales en copia impresa . . . . . . . Informacin en lnea . . . . . . . . . Publicaciones que se suministran con el producto . . . . . . . . . . . . HTML . . . . . . . . . . . . PDF. . . . . . . . . . . . . Manuales en HTML y PDF en la World Wide Web. . . . . . . . . . . . . . . CD-ROM en formato BookManager . . . . Ayuda en lnea . . . . . . . . . . .
65 66 66 66 66 67 68 69 69
39
40
Captulo 6. Acerca de MQSeries

Este captulo es una introduccin a IBM MQSeries. Describe sus funciones bsicas y sus relaciones con los sistemas operativos, aplicaciones y otros productos de middleware.
Introduccin
MQSeries es un sistema de comunicaciones que proporciona la funcin de entrega asegurada de datos de una sola vez y de forma asncrona, a travs de una amplia gama de plataformas de hardware y software. Estas caractersticas convierten a MQSeries en la infraestructura ideal para las comunicaciones entre aplicaciones y en la solucin adecuada tanto si las aplicaciones se ejecutan en la misma mquina como si lo hacen en mquinas diferentes separadas por una o varias redes. MQSeries tiene soporte para todos los protocolos de comunicaciones importantes e incluso proporciona rutas entre redes que utilizan protocolos diferentes. MQSeries sirve de puente y pasarela entre productos y permite un acceso fcil (prcticamente sin ningn tipo de programacin) a muchos entornos de aplicaciones y sistemas existentespor ejemplo, Lotus Notes, navegadores web, applets Java y muchos otros. La funcin de entrega asegurada refleja las muchas funciones incorporadas en MQSeries que aseguran que no se perdern los datos debido a anomalas en el sistema subyacente o en la infraestructura de red. La funcin de entrega asegurada de mensajes convierte a MQSeries en la base de los sistemas de comunicaciones crticos a quien puede confiarse la entrega de datos de gran valor. Tambin existen opciones que permiten seleccionar un servicio de calidad menos potente, cuando sea necesario. Por ejemplo, en algunas circunstancias es posible que se prefiera una entrega rpida sin poner tanto nfasis en la entrega asegurada. Gracias al soporte del proceso asncrono en MQSeries el intercambio de datos entre las aplicaciones emisora y receptora es independiente del tiempo. De este modo, las aplicaciones emisora y receptora no han de estar acopladas y el emisor puede continuar el proceso sin tener que esperar a que el receptor indique que ha recibido los datos. De hecho, la aplicacin de destino ni siquiera tiene que estar ejecutndose cuando se envan los datos. Del mismo modo, no es necesario que la ruta de red existente entre el emisor y el receptor est disponible cuando se transmiten los datos.
41
Introduccin
La entrega de datos de una sola vez es una cuestin vital a tener en cuenta, sobretodo en las aplicaciones financieras y comerciales en las que precisamente no se desea que se dupliquen las peticiones de transferencia de grandes sumas de dinero de una cuenta a otra.
Mensajes, colas y gestores de colas

Los tres conceptos bsicos de MQSeries que es necesario comprender son: v Mensajes v Colas v Gestores de colas
Mensajes
Un mensaje es una serie de bytes que tiene significado para las aplicaciones que lo utilizan. Los mensajes se utilizan para transferir datos desde una aplicacin a otra (o a distintas partes de la misma aplicacin). Las aplicaciones pueden estar ejecutndose en la misma plataforma o en plataformas distintas. Los mensajes de MQSeries tienen dos partes: los datos de la aplicacin y un descriptor de mensaje. El contenido y la estructura de los datos de aplicacin se definen mediante los programas de aplicacin que utilizan los datos. El descriptor de mensaje identifica el mensaje y contiene ms informacin de control, como el tipo de mensaje y la prioridad que le ha asignado la aplicacin emisora.
Colas
Una cola es una estructura de datos en la que se almacenan los mensajes. Las aplicaciones o un gestor de colas, pueden transferir u obtener los mensajes de las colas como parte de su actividad normal. Las colas existen independientemente de las aplicaciones que las utilizan. Una cola puede estar en el almacenamiento principal (si es temporal), en un disco o en un tipo de almacenamiento similar (si debe conservarse por si es necesaria una recuperacin), o en ambos tipos de almacenamiento (si se est utilizando pero tambin debe guardarse para su recuperacin). Cada cola pertenece a un gestor de colas, que es el responsable de su mantenimiento. El gestor de colas transfiere los mensajes que recibe a la cola adecuada. Las colas pueden estar en el sistema local, en cuyo caso se denominan colas locales, o en otro gestor de colas, en cuyo caso se denominan colas remotas. Las aplicaciones envan y reciben mensajes de las colas. Por ejemplo, una aplicacin puede transferir un mensaje a una cola y otra aplicacin puede recuperar el mensaje de la misma cola.
42
Conceptos bsicos
Cada cola tiene atributos de cola que determinan lo que sucede cuando las aplicaciones hacen referencia a la cola. Los atributos indican: v Si las aplicaciones pueden recuperar mensajes de la cola (obtencin habilitada) v Si las aplicaciones pueden transmitir mensajes a la cola (transferencia habilitada) v Si el acceso a la cola es exclusivo de una aplicacin o lo comparten varias aplicaciones v El nmero mximo de mensajes que puede almacenarse en la cola al mismo tiempo (profundidad mxima de cola) v El tamao mximo de mensajes que se puede transferir a la cola (tamao mximo de mensajes)
Gestores de colas
Un gestor de colas proporciona servicios de gestin de colas a las aplicaciones, y gestiona las colas que le pertenecen. Se asegura de que: v Los atributos de objeto se modifiquen segn los detalles recibidos. v Se generen sucesos especiales (como, por ejemplo, sucesos de instrumentacin o activacin) cuando se cumplan las condiciones adecuadas. v Se transfieran los mensajes a la cola correcta, segn lo solicitado por la aplicacin. Si la operacin no puede realizarse, se informa de ello a la aplicacin y se emite el cdigo de razn adecuado. Cada cola pertenece a un solo gestor de colas y se dice que es una cola local respecto a ese gestor de colas. El gestor de colas al que est conectada una aplicacin es el gestor de colas local de esa aplicacin. Para la aplicacin, las colas que pertenecen a su gestor de colas local son colas locales. Una cola remota es simplemente una cola que pertenece a otro gestor de colas. Un gestor de colas remoto es cualquier gestor de colas distinto del gestor de colas local. Un gestor de colas remoto puede estar en una mquina remota en la red o en la misma mquina que el gestor de colas local. MQSeries tiene soporte para varios gestores de colas en una misma mquina.
43
Configuraciones de MQSeries Configuraciones de MQSeries

En las configuraciones ms sencillas, se instala MQSeries en una mquina y se crea un solo gestor de colas. Este gestor de colas permite definir las colas. A continuacin, las aplicaciones locales podrn utilizar estas colas para el intercambio de mensajes. Para que las aplicaciones puedan comunicarse con colas gestionadas por otro gestor de colas es necesario definir canales de mensajes. No es necesario definir directamente un canal en el gestor de colas de destino y, generalmente, lo adecuado es definir simplemente uno en el salto siguiente (es decir, un gestor de colas intermedio). Los canales de mensajes disponibles desde dicho gestor de colas se utilizarn para entregar el mensaje al gestor de colas de destino (o incluso a un salto siguiente). Se pueden crear configuraciones ms complejas utilizando una estructura de cliente/servidor. El producto MQSeries puede actuar como un servidor MQSeries para los clientes MQSeries. No es necesario que el cliente y el servidor estn en la misma plataforma. MQSeries da soporte a una amplia gama de plataformas de cliente. Generalmente, los productos MQSeries incluyen clientes para diferentes plataformas. Se pueden obtener clientes MQSeries adicionales en el sitio web de MQSeries. En una configuracin cliente/servidor, el servidor MQSeries proporciona los servicios de mensajera y gestin de colas a los clientes y tambin a cualquier aplicacin local. Los clientes se conectan al servidor a travs de canales dedicados (que se denominan canales de cliente) a los clientes. Este mtodo resulta muy rentable ya que un servidor puede dar soporte a centenares de clientes con una sola copia del producto servidor MQSeries. Sin embargo, el canal de cliente debe estar disponible de forma continua cuando se ejecutan las aplicaciones MQSeries del cliente. Esto es diferente en los canales de mensajes, ya que no es necesario que estn disponibles de forma continua para dar soporte a las aplicaciones MQSeries que se ejecutan en el servidor. Consulte el apartado Canales en la pgina 45 para obtener ms informacin. MQSeries tambin da soporte al concepto de clusters para simplificar su configuracin y funcionamiento. Un cluster es un grupo de gestores de colas con un nombre y cualquier gestor de colas puede pertenecer a uno, a varios o a ninguno de estos clusters. Los gestores de colas de un cluster pueden existir en la misma mquina o en mquinas diferentes.
44
Configuraciones de MQSeries
La utilizacin de los clusters ofrece dos ventajas importantes: 1. Las comunicaciones entre los miembros de un cluster se simplifican significativamente, sobre todo debido a que los canales necesarios para el intercambio de mensajes se crean y definen automticamente segn sean necesarios. 2. Algunas o todas las colas de los gestores de colas de un cluster se pueden definir como colas de cluster, con lo cual automticamente pasan a estar a disposicin de los dems gestores de colas del cluster. Consulte el apartado Clusters en la pgina 46 para obtener ms informacin.
Canales
Un canal proporciona una va de comunicaciones con un gestor de colas. Hay dos tipos de canales: canales de mensajes y canales MQI. Un canal de mensajes proporciona una va de comunicaciones entre dos gestores de colas de una misma plataforma o de plataformas distintas. El canal de mensajes se utiliza para la transmisin de mensajes de un gestor de colas a otro y protege los programas de aplicacin de las complejidades de los protocolos de red subyacentes. Un canal de mensajes slo puede transmitir mensajes en una direccin. Si es necesaria una comunicacin bidireccional entre dos gestores de colas, sern necesarios dos canales de mensajes. Un canal de cliente (al que tambin se conoce como canal MQI) conecta un cliente MQSeries con un gestor de colas de una mquina servidor y es bidireccional. Si desea obtener ms informacin acerca de los canales y sobre cmo los utiliza MQSeries para las comunicaciones entre los diferentes sistemas de la red, consulte el manual MQSeries Intercommunication.
Clientes y servidores
MQSeries da soporte a configuraciones cliente/servidor para las aplicaciones MQSeries. Un cliente MQSeries es una parte del producto MQSeries que se instala en una mquina para aceptar llamadas MQSeries de aplicaciones y pasarlas a una mquina servidor MQSeries. Estas llamadas las procesa entonces un gestor de colas. Normalmente, el cliente y el servidor residen en mquinas distintas, pero tambin pueden estar en una misma mquina. Un servidor MQSeries es un gestor de colas que proporciona servicios de gestin de colas a uno o varios clientes. Todos los objetos MQSeries (por ejemplo, las colas), nicamente existen en la mquina del gestor de colas (esto es, en la mquina servidor MQSeries). Un servidor tambin tiene soporte para aplicaciones MQSeries locales.
45
Configuraciones de MQSeries
La diferencia entre un servidor MQSeries y un gestor de colas normal es que el servidor MQSeries tiene soporte para clientes MQSeries y cada una de las aplicaciones de cliente MQSeries posee un enlace de comunicaciones dedicado con el servidor MQSeries. Para obtener ms informacin acerca del soporte del cliente, consulte el manual MQSeries Clientes.
Clusters
Un cluster es un grupo de gestores de colas al que se le ha dado un nombre. Los clusters requieren que como mnimo uno de los gestores de colas se defina como depsito (esto es, un lugar que contendr la informacin compartida del cluster). Por lo general, se suelen designar dos o ms depsitos de este tipo para proporcionar una disponibilidad continua si se produce una anomala del sistema. MQSeries se asegura de que la informacin de los depsitos est sincronizada. Cuando se define una cola como cola de cluster, se puede considerar una cola pblica ya que los dems gestores de colas del cluster pueden disponer libremente de la misma. Esto es diferente de las colas que no son de cluster, a las que slo puede accederse cuando se dispone de una definicin local. De este modo, una cola que no sea una cola de cluster posee las caractersticas de una cola privada y slo pueden acceder a la misma los gestores de colas que en su configuracin poseen informacin sobre la misma. Las colas pblicas que tienen el mismo nombre en el mismo cluster se consideran equivalentes. Si se enva un mensaje a dicho nombre de cola, por omisin, MQSeries lo enva a cualquiera de las instancias, utilizando un algoritmo de equilibrio de carga. Si no desea que esto suceda, puede utilizar el nombre de cola y de gestor de colas de la direccin y, de este modo, forzar la entrega del mensaje a un gestor de colas especfico. Alternativamente, puede sustituir la rutina de equilibrio de carga por una implementacin diferente. Esto es tpico de MQSeries, ya que en muchos casos se puede modificar el comportamiento estndar implementando el cdigo de usuario en rutinas de salida diseadas para este fin. En el manual MQSeries Queue Manager Clusters encontrar una descripcin detallada.
46
Posibilidades Posibilidades de MQSeries

MQSeries se puede utilizar para crear muchos tipos de soluciones diferentes. Algunas utilizan el soporte de plataformas, o las posibilidades de puente y pasarela, para conectar los sistemas existentes de forma integrada o para que las aplicaciones nuevas puedan obtener informacin, o intercambiar informacin, con los sistemas existentes. Otras soluciones tienen soporte para servidores de aplicaciones de la empresa, de modo que una agrupacin central de aplicaciones MQSeries puede gestionar el trabajo que se enva a travs de las redes. Tambin hay soporte para el direccionamiento complejo de informacin en entornos de flujo de trabajo. Publicacin/suscripcin o enviar y olvidar son otros ejemplos de aplicaciones que utilizan flujos de mensajes diferentes. Se pueden crear sistemas de equilibrio de carga y de modalidad de espera dinmica utilizando la potencia y la flexibilidad de MQSeries, que presenta funciones especficas para dar soporte a muchos de estos diferentes entornos. Consulte el manual MQSeries Application Programming Guide para obtener ms informacin acerca de cmo escribir aplicaciones MQSeries.
Soporte de transacciones
Es posible que un programa de aplicacin necesite agrupar un conjunto de actualizaciones en una unidad de trabajo. Dichas actualizaciones estn relacionadas lgicamente y deben ejecutarse todas correctamente para conservar la integridad de los datos. La integridad de los datos se perdera si una de las actualizaciones del grupo se ejecutara correctamente y otra no. MQSeries tiene soporte para la mensajera transaccional. Una unidad de trabajo se confirma cuando se ha completado correctamente. Al llegar a este punto, todas las actualizaciones efectuadas dentro de la unidad de trabajo son permanentes e irreversibles. Alternativamente, si la unidad de trabajo no se ejecuta correctamente, se restituyen todas las actualizaciones. La coordinacin de punto de sincronismo es el proceso mediante el cual una unidad de trabajo se confirma o restituye ntegramente. Una unidad de trabajo local es aquella en la que los nicos recursos actualizados son los del gestor de colas MQSeries. La coordinacin de punto de sincronismo la proporciona entonces el gestor de colas propiamente dicho utilizando un proceso de confirmacin en una fase.
47
Posibilidades
Una unidad de trabajo global es aquella en que tambin se actualizan los recursos pertenecientes a otros gestores de recursos, como, por ejemplo, las bases de datos que siguen la normativa XA. En este caso, deber utilizarse un procedimiento de confirmacin de dos fases y la unidad de trabajo puede coordinarla el propio gestor de colas o, de forma externa, otro gestor de transacciones que siga la normativa XA como, por ejemplo, IBM CICS, IBM Transaction Server, IBM TXSeries, Transarc Encina o BEA Tuxedo. Cuando el gestor de colas coordina unidades de trabajo globales, se pueden integrar actualizaciones de la base de datos en las unidades de trabajo MQSeries. Es decir, se puede escribir una aplicacin mixta, MQSeries y SQL, y se pueden utilizar mandatos para confirmar o restituir al mismo tiempo los cambios en las colas y en las bases de datos. El gestor de colas lleva esto a cabo mediante el protocolo de confirmacin en dos fases. Cuando debe confirmarse una unidad de trabajo, el gestor de colas pregunta en primer lugar a cada gestor de base de datos participante si est preparado para confirmar las actualizaciones. Slo si todos los participantes, incluido el gestor de colas propiamente dicho, estn preparados para la confirmacin, se confirmarn todas las actualizaciones de la cola y la base de datos. Si alguno de los participantes no puede preparar sus actualizaciones, la unidad de trabajo se restituir. Existe un soporte de recuperacin completa por si el gestor de colas pierde contacto con alguno de los gestores de bases de datos durante el protocolo de confirmacin. Si un gestor de base de datos deja de estar disponible mientras est pendiente, (es decir, si se le ha llamado para que se prepare pero an ha de recibirse una decisin de confirmacin o restitucin), el gestor de colas recordar el resultado de la unidad de trabajo hasta que sta se haya entregado satisfactoriamente. Del mismo modo, si el gestor de colas termina con operaciones de confirmacin incompletas pendientes, estas se recordarn cuando se reinicie el gestor de colas.
Sucesos de instrumentacin
Los sucesos de instrumentacin de MQSeries pueden utilizarse para supervisar la operacin de los gestores de colas. Los sucesos de instrumentacin originan mensajes especiales llamados mensajes de sucesos que se generarn siempre que el gestor de colas detecte un grupo de condiciones definidas previamente. Por ejemplo, se genera un mensaje de suceso de cola llena si: los sucesos de cola llena estn habilitados para una cola especificada; una aplicacin emite una llamada MQPUT para transferir un mensaje a dicha cola, pero la llamada no se realiza satisfactoriamente porque la cola est llena.
48
Posibilidades
Otras condiciones que pueden producir sucesos de instrumentacin son: v Se llega a un lmite predefinido del nmero de mensajes de una cola v No se ha dado servicio a una cola dentro del perodo de tiempo especificado v Se ha iniciado o detenido una instancia de canal Si define las colas de sucesos como colas remotas, puede transferir todas las colas de sucesos a un solo gestor de colas (en los nodos que admitan sucesos de instrumentacin). Esto le permitir utilizar los sucesos generados para supervisar una red de gestores de colas desde un solo nodo. Los sucesos de instrumentacin de MQSeries se clasifican del modo siguiente: Sucesos del gestor de colas Estos sucesos estn relacionados con las definiciones de recursos de los gestores de colas. Por ejemplo, si una aplicacin intenta abrir una cola, pero el ID de usuario asociado no tiene autorizacin para realizar esa operacin, se generar un suceso de gestor de colas. Sucesos de rendimiento Estos sucesos son notificaciones que indican que un recurso ha alcanzado una condicin de umbral. Por ejemplo, se ha llegado a un lmite de profundidad de cola o, despus de una peticin MQGET, no se ha atendido a una cola dentro del perodo de tiempo predefinido. Sucesos de canal Los canales informan de estos sucesos como resultado de las condiciones detectadas durante su operacin. Por ejemplo, se genera un suceso de canal cuando se detiene una instancia de canal.
Proceso dirigido por mensajes

Al llegar a una cola, los mensajes pueden iniciar automticamente una aplicacin utilizando un mecanismo denominado activacin. Si es necesario, las aplicaciones se pueden detener una vez procesados los mensajes.
49
Programacin de MQSeries Programacin de MQSeries

Se pueden desarrollar aplicaciones MQSeries utilizando diferentes lenguajes y tipos de programacin. Se da soporte a la programacin orientada a objetos y de procedimientos, dependiendo de la plataforma de MQSeries, utilizando por ejemplo Visual Basic, C, C++, Java, COBOL y PL/I. La funcin de MQSeries est dividida lgicamente en lo que normalmente necesitan las aplicaciones (como, por ejemplo, transferir mensajes a una cola) y lo que se necesita para la administracin (como, por ejemplo, modificar las definiciones de las colas o gestores de colas). La funcin de aplicacin se denomina MQI (interfaz de cola de mensajes). La funcin de administracin se denomina MQAI (interfaz de administracin de gestin de colas de mensajes). Las aplicaciones pueden combinar las funciones de MQI y MQAI, segn sea necesario. Las funciones de administracin se pueden implementar de dos formas: 1. Generalmente, mediante enlaces de lenguaje MQAI 2. Enviando mensajes a las colas de administracin para obtener los mismos resultados que con la MQAI, utilizando los formatos de mandatos programables (PCF)
50
Captulo 7. Utilizacin de los conjuntos de mandatos de MQSeries

Este captulo presenta los conjuntos de mandatos que pueden utilizarse para realizar tareas de administracin de sistemas en objetos MQSeries. Las tareas de administracin incluyen la creacin, el arranque, la modificacin, la visualizacin, la detencin y la supresin de objetos MQSeries como, por ejemplo, gestores de colas, colas, procesos, canales y listas de nombres. Para realizar estas tareas, debe seleccionar el mandato adecuado en los conjuntos de mandatos suministrados.
Introduccin de los conjuntos de mandatos

MQSeries proporciona tres conjuntos de mandatos para realizar las tareas de administracin: v Mandatos de control v Mandatos MQSC v Mandatos PCF Esta seccin describe los conjuntos de mandatos disponibles. Algunas tareas deben efectuarse utilizando un mandato de control o un mandato MQSC, pero otras tareas pueden realizarse utilizando un solo tipo de mandato. Si desea ver una comparacin de los recursos proporcionados por los distintos tipos de conjuntos de mandatos, consulte el manual MQSeries Administracin del sistema.
Mandatos de control
Los mandatos de control pueden ser de tres categoras: v Mandatos de gestor de colas, que incluyen mandatos para crear, arrancar, detener y suprimir gestores de colas y servidores de mandatos. v Mandatos de canal, que incluyen mandatos para iniciar y finalizar canales e iniciadores de canales. v Mandatos de utilidad, que incluyen mandatos asociados a la gestin de autorizaciones y a las rutinas de salida de conversin.
51
Conjuntos de mandatos de MQSeries

Utilizacin de los mandatos de control En los entornos MQSeries en UNIX, los mandatos de control se entran en una ventana del shell. En esos entornos, los mandatos de control, incluidos el nombre del mandato propiamente dicho, los indicadores y los argumentos que pueda haber, son sensibles a las maysculas y minsculas. Por ejemplo, en el mandato:
crtmqm -u SYSTEM.DEAD.LETTER.QUEUE jupiter.queue.manager
v El nombre del mandato debe ser crtmqm, no CRTMQM. v El indicador debe ser -u, no -U. v La cola de mensajes no entregados es SYSTEM.DEAD.LETTER.QUEUE. v El argumento se especifica como jupiter.queue.manager, que no es lo mismo que JUPITER.queue.manager. Por lo tanto, los mandatos deben escribirse exactamente tal como se indican en los ejemplos. La siguiente lista contiene una breve descripcin de cada mandato de control. Puede obtener ayuda sobre la sintaxis de cualquiera de los mandatos entrando el mandato seguido de un signo de interrogacin. MQSeries responde con un listado de la sintaxis necesaria para el mandato seleccionado. crtmqcvx (conversin de datos) Crea un fragmento de cdigo que efecta la conversin de datos en estructuras de tipo datos. crtmqm (crear gestor de colas) Crea un gestor de colas local y define los objetos por omisin y del sistema. dltmqm (suprimir gestor de colas) Suprime un gestor de colas especificado. dmpmqlog (volcar anotaciones) Vuelca una versin formateada de las anotaciones del sistema de MQSeries. dspmqaut (visualizar autorizaciones) Visualiza las autorizaciones actuales sobre un objeto especificado. dspmqcsv (visualizar servidor de mandatos) Visualiza el estado del servidor de mandatos para el gestor de colas especificado. dspmqfls (visualizar archivos MQSeries) Visualiza el nombre real de un sistema de archivos de todos los objetos MQSeries que coinciden con un criterio especificado. dspmqtrc (visualizar salida de rastreo MQSeries con formato) Visualiza la salida del rastreo MQSeries con formato. dspmqtrn (visualizar transacciones MQSeries) Visualiza detalles sobre transacciones pendientes.
52
Conjuntos de mandatos de MQSeries

endmqcsv (finalizar servidor de mandatos) Detiene el servidor de mandatos del gestor de colas especificado. endmqlsr Finaliza un proceso de escucha. endmqm (finalizar gestor de colas) Detiene un gestor de colas local especificado. endmqtrc (finalizar rastreo MQSeries) Finaliza el rastreo de la entrada especificada o de todas las entidades. rcdmqimg (grabar imagen en soporte magntico) Graba una imagen de un objeto o grupo de objetos MQSeries, en las anotaciones para poder utilizarla en la recuperacin desde soporte. rcrmqobj (volver a crear objeto) Vuelve a crear un objeto o grupo de objetos a partir de sus respectivas imgenes contenidas en las anotaciones. rsvmqtrn (resolver transacciones MQSeries) Confirma o restituye, tanto interna como externamente, las transacciones pendientes coordinadas. runmqchi (ejecutar iniciador de canal) Ejecuta un proceso iniciador de canal. runmqchl (ejecutar canal) Ejecuta un canal emisor (SDR) o peticionario (RQSTR). runmqdlq (ejecutar manejador de la cola de mensajes no entregados) Inicia el manejador de la cola de mensajes no entregados (DLQ), un programa de utilidad que puede ejecutarse para supervisar y gestionar mensajes que se encuentran en una cola de mensajes no entregados. runmqlsr (ejecutar escucha) Ejecuta un proceso de escucha. runmqsc (ejecutar mandatos MQSeries) Emite mandatos MQSC a un gestor de colas. runmqtrm (iniciar supervisor de activacin) Invoca un supervisor de activacin. setmqaut (establecer/restaurar autorizacin) Cambia las autorizaciones sobre un objeto o una clase de objetos. strmqcsv (iniciar servidor de mandatos) Inicia el servidor de mandatos para un gestor de colas especificado. strmqm (iniciar gestor de colas) Inicia un gestor de colas local. strmqtrc (iniciar rastreo MQSeries) Habilita el rastreo. Si desea ver ms informacin sobre la sintaxis y la finalidad de los mandatos de control, consulte el manual MQSeries Administracin del sistema.
53
Conjuntos de mandatos de MQSeries Mandatos MQSeries (MQSC)

Los mandatos de MQSeries (MQSC) se utilizan para gestionar objetos de gestores de colas, incluidos el propio gestor de colas, canales, colas y definiciones de proceso. Por ejemplo, hay mandatos para definir, alterar, visualizar y suprimir una cola especificada. Cuando se visualiza una cola utilizando el mandato DISPLAY QUEUE, se visualizan los atributos de la cola. Por ejemplo, el atributo MAXMSGL especifica la longitud mxima de un mensaje que puede transferirse a la cola. El mandato no muestra los mensajes existentes en la cola. Para obtener informacin detallada acerca de todos los mandatos MQSC, consulte el manual MQSeries Consulta de mandatos MQSC. Ejecucin de los mandatos MQSC Los mandatos MQSC se ejecutan emitiendo el mandato de control runmqsc. Puede ejecutar mandatos MQSC: v Interactivamente, escribindolos en el teclado v Como una secuencia de mandatos desde un archivo de texto Para obtener ms informacin acerca de cmo utilizar los mandatos MQSC, consulte el manual MQSeries Administracin del sistema.
Mandatos PCF
Los mandatos MQSeries en formato de mandatos programables (PCF) permiten programar tareas de administracin en un programa de administracin. De este modo, puede crear colas y definiciones de procesos y cambiar gestores de colas desde un programa. Los mandatos PCF cubren la misma gama de funciones que proporciona el recurso MQSC. Por lo tanto, puede escribir un programa para emitir mandatos PCF a cualquier gestor de colas de la red desde un nico nodo. De este modo, puede centralizar y automatizar las tareas de administracin. Nota: A diferencia de los mandatos MQSC, los mandatos PCF y sus respuestas no estn en un formato de texto legible por el usuario. Si desea ver la descripcin completa de las estructuras de datos PCF y la explicacin del modo de implementarlas, consulte el manual MQSeries Programmable System Management.
54
Trabajo con gestores de colas Trabajo con gestores de colas

Esta seccin explica cmo realizar operaciones en gestores de colas como, por ejemplo, crearlos de nuevo, iniciarlos, detenerlos y suprimirlos. Para realizar estas tareas, MQSeries proporciona los mandatos de control. Para poder hacer cualquier operacin con mensajes y colas, debe crear al menos un gestor de colas.
Creacin de un gestor de colas por omisin

El mandato siguiente: v Crea un gestor de colas por omisin llamado saturn.queue.manager v Crea automticamente los objetos por omisin y del sistema v Especifica los nombres de una cola de transmisin por omisin y de una cola de mensajes no entregados
crtmqm -q -d MY.DEFAULT.XMIT.QUEUE -u SYSTEM.DEAD.LETTER.QUEUE saturn.queue.manager
donde: -q Indica que este gestor de colas es el gestor de colas por omisin.
-d MY.DEFAULT.XMIT.QUEUE Es el nombre de la cola de transmisin por omisin. -u SYSTEM.DEAD.LETTER.QUEUE Es el nombre de la cola de mensajes no entregados. saturn.queue.manager Es el nombre de este gestor de colas. Debe ser el ltimo parmetro especificado en el mandato crtmqm. Para obtener ms informacin acerca de estos atributos, consulte el manual MQSeries Administracin del sistema.
Inicio de un gestor de colas

Aunque haya creado un gestor de colas, ste no podr procesar mandatos ni llamadas MQI hasta que se haya iniciado. Inicie el gestor de colas escribiendo este mandato:
strmqm saturn.queue.manager
El mandato strmqm no devolver el control hasta que el gestor de colas se haya iniciado y est preparado para aceptar peticiones de conexin.
55
Trabajo con gestores de colas Detencin de un gestor de colas

Para detener un gestor de colas, utilice el mandato endmqm. Por ejemplo, para detener un gestor de colas llamado saturn.queue.manager, utilice este mandato:
endmqm saturn.queue.manager
Cierre progresivo Por omisin, el mandato anterior realiza un cierre progresivo del gestor de colas especificado. Esta operacin puede tardar algo en realizarseun cierre progresivo espera a que se desconecten todas las aplicaciones conectadas. Utilice este tipo de cierre para indicar a las aplicaciones que deben detenerse; el usuario no recibir la notificacin de su detencin. Puede especificar el indicador -w si necesita recibir la confirmacin de la detencin del gestor de colas. Por ejemplo:
endmqm -w saturn.queue.manager
El indicador de mandatos no vuelve a visualizarse hasta que el gestor de colas se detiene. Cierre inmediato Un cierre inmediato permite que todas las llamadas actuales MQI terminen, pero no se ejecuta ninguna llamada nueva. Este tipo de cierre no espera a que las aplicaciones se desconecten del gestor de colas. Utilice este tipo de cierre como forma normal de detener el gestor de colas, opcionalmente tras un perodo de inmovilizacin. El mandato utilizado para un cierre inmediato es:
endmqm -i saturn.queue.manager
Cierre preferente Este mtodo slo debe utilizarse cuando todos los dems intentos de detener el gestor de colas utilizando el mandato endmqm hayan fracasado. Puede tener consecuencias imprevisibles para las aplicaciones conectadas. Si un cierre inmediato no funciona, deber recurrir a un cierre preferente, especificando el indicador -p. Por ejemplo:
endmqm -p saturn.queue.manager
Esto detendr inmediatamente todo el cdigo del gestor de colas.
56
Trabajo con gestores de colas Supresin de un gestor de colas

Para suprimir un gestor de colas llamado saturn.queue.manager, detngalo primero y despus utilice el siguiente mandato:
dltmqm saturn.queue.manager
Nota: Suprimir un gestor de colas es una decisin importante, ya que se suprimen tambin todos los recursos asociados al mismo, incluidas todas las colas y sus mensajes y todas las definiciones de objetos.
Trabajo con objetos MQSeries

Esta seccin explica brevemente cmo utilizar los mandatos MQSC para crear, visualizar, modificar, copiar y suprimir objetos MQSeries. El recurso MQSC puede utilizarse interactivamente (entrando mandatos por el teclado) o redirigiendo el dispositivo de entrada estndar (stdin) para que ejecute una secuencia de mandatos a partir de un archivo de texto. En ambos casos, el formato de los mandatos es el mismo. Los ejemplos incluidos aqu suponen que va a utilizar el mtodo interactivo. Para obtener ms informacin acerca de cmo utilizar los mandatos MQSC, consulte el manual MQSeries Administracin del sistema. Si desea ver la descripcin completa de los mandatos MQSC, consulte el manual MQSeries Consulta de mandatos MQSC. Para poder ejecutar los mandatos MQSC, debe haber creado e iniciado el gestor de colas que va a ejecutarlos. Para obtener ms informacin, consulte el apartado Creacin de un gestor de colas por omisin en la pgina 55.
Utilizacin del recurso MQSC de forma interactiva

Para empezar a utilizar interactivamente el recurso MQSC, se utiliza el mandato runmqsc. Abra un shell y escriba:
runmqsc
No se ha especificado ningn nombre de gestor de colas y, por lo tanto, los mandatos MQSC los procesar el gestor de colas por omisin. Escriba ahora todos los mandatos MQSC necesarios. Por ejemplo:
DEFINE QLOCAL(ORANGE.LOCAL.QUEUE)
Es necesario utilizar caracteres de continuacin para indicar que un mandato contina en la lnea siguiente: v Un signo menos () indica que el mandato debe continuar desde el principio de la lnea siguiente. v Un signo ms (+) indica que el mandato debe continuar desde el primer carcter de la lnea siguiente que no sea un blanco.
57
Trabajo con objetos

La entrada del mandato termina con el ltimo carcter que no sea un carcter de continuacin de una lnea que no est en blanco. Tambin puede terminar explcitamente la entrada de un mandato entrando un punto y coma (;). (Esto es especialmente til si entra accidentalmente un carcter de continuacin al final de la ltima lnea de entrada del mandato.) Informacin de retorno de los mandatos MQSC Cuando emite mandatos desde el recurso MQSC, el gestor de colas devuelve mensajes al operador que confirman sus acciones o que le indican los errores que ha cometido. Por ejemplo:
AMQ8006: Cola MQSeries creada . . . AMQ8405: Error de sintaxis detectado en o cerca del final del segmento de mandato siguiente:Z
El primer mensaje confirma que se ha creado una cola; el segundo indica que se ha cometido un error de sintaxis. Estos mensajes se envan al dispositivo de salida estndar. Si no ha entrado el mandato correctamente, busque la sintaxis correcta en el manual MQSeries Consulta de mandatos MQSC.
Finalizacin de la entrada interactiva de MQSC

Para finalizar la entrada interactiva de mandatos MQSC, entre el mandato END de MQSC:
END
Alternativamente, puede utilizar el carcter de fin de archivo CONTROL+D. No es necesario hacer esto si est redirigiendo entrada de otras procedencias, como por ejemplo de un archivo de texto.
Definicin de una cola local

Para una aplicacin, el gestor de colas local es el gestor de colas al que est conectada. Las colas gestionadas por el gestor de colas local son colas locales de dicho gestor de colas. Utilice el mandato DEFINE QLOCAL de MQSC para crear una definicin de una cola local y crear la estructura de datos llamada cola. Tambin puede modificar las caractersticas de la cola para que no sean las de la cola local por omisin. En este ejemplo, la cola que se define, ORANGE.LOCAL.QUEUE, va a tener las siguientes caractersticas:
58
Trabajo con objetos

v Est habilitada para operaciones de obtener, inhabilitada para operaciones de transferir y opera con el orden primero en entrar, primero en salir (FIFO). v Es una cola normal, es decir, que no es una cola de inicio ni una cola de transmisin, y no genera mensajes de activacin. v La capacidad mxima de la cola es de 1.000 mensajes; la longitud mxima de un mensaje es de 2.000 bytes. El mandato MQSC especificado a continuacin hace lo siguiente:
DEFINE QLOCAL (ORANGE.LOCAL.QUEUE) + DESCR('Cola para mensajes de otros sistemas') + PUT (DISABLED) + GET(ENABLED) + NOTRIGGER + MSGDLVSQ (FIFO) + MAXDEPTH (1000) + MAXMSGL (2000) + USAGE (NORMAL);
Notas: 1. La mayora de estos atributos son los valores por omisin que se suministran con el producto. No obstante, aparecen aqu slo como ejemplo. Puede omitirlos si est seguro de que los valores por omisin son los que desea y no han sido modificados. Consulte tambin el apartado Visualizacin de los atributos de objetos por omisin. 2. USAGE (NORMAL) indica que esta cola no es ni una cola de inicio ni una cola de transmisin. 3. Si ya tiene una cola local llamada ORANGE.LOCAL.QUEUE en el mismo gestor de colas, este mandato no se ejecutar correctamente. Utilice el atributo REPLACE si desea sobregrabar la definicin existente de una cola, pero consulte tambin el apartado Modificacin de los atributos de una cola local en la pgina 61.
Visualizacin de los atributos de objetos por omisin

Cuando se define un objeto MQSeries, ste toma del objeto por omisin todos los atributos que el usuario no especifica. Por ejemplo, cuando define una cola local, dicha cola toma de la cola local por omisin, llamada SYSTEM.DEFAULT.LOCAL.QUEUE, todos los atributos omitidos en la definicin. La cola local por omisin se crea automticamente al crear el gestor de colas por omisin. Para saber exactamente cules son estos atributos, utilice el siguiente mandato:
DISPLAY QUEUE (SYSTEM.DEFAULT.LOCAL.QUEUE)
Nota: La sintaxis de este mandato es distinta de la del mandato DEFINE correspondiente.
59
Trabajo con objetos

Puede visualizar de forma selectiva los atributos especificndolos individualmente. Por ejemplo:
DISPLAY QUEUE (ORANGE.LOCAL.QUEUE) + MAXDEPTH + MAXMSGL + CURDEPTH;
Este mandato visualiza los tres atributos especificados de la siguiente manera:

AMQ8409: Detalles de Display Queue (Visualizar cola) QUEUE(ORANGE.LOCAL.QUEUE) MAXDEPTH(1000) MAXMSGL (2000) CURDEPTH(0)
CURDEPTH es la profundidad actual de la cola, es decir, el nmero de mensajes de la cola. Visualizar este atributo resulta til, ya que puede utilizarlo para supervisar la profundidad de cola y asegurarse de que la cola no se llena.
Copia de una definicin de cola local

Puede copiar una definicin de cola utilizando el atributo LIKE en el mandato DEFINE. Por ejemplo:
DEFINE QLOCAL (MAGENTA.QUEUE) + LIKE (ORANGE.LOCAL.QUEUE)
Este mandato crea una cola con los mismos atributos que la cola original ORANGE.LOCAL.QUEUE, en vez de los de la cola local por omisin del sistema. Tambin puede utilizar esta forma del mandato DEFINE para copiar una definicin de cola, pero sustituyendo uno o ms cambios en los atributos de la cola original. Por ejemplo:
DEFINE QLOCAL (THIRD.QUEUE) + LIKE (ORANGE.LOCAL.QUEUE) + MAXMSGL(1024);
Este mandato copia los atributos de la cola ORANGE.LOCAL.QUEUE en la cola THIRD.QUEUE, pero especifica que la longitud mxima del mensaje de la nueva cola debe ser de 1.024 bytes, en vez de 2.000. Notas: 1. Cuando se utiliza el atributo LIKE en un mandato DEFINE, slo se copian los atributos de la cola. No se copian los mensajes de la cola. 2. Definir una cola local sin especificar LIKE, es igual que
DEFINE LIKE(SYSTEM.DEFAULT.LOCAL.QUEUE).
60
Trabajo con objetos Modificacin de los atributos de una cola local

Los atributos de cola pueden modificarse de dos formas, utilizando el mandato ALTER QLOCAL o el mandato DEFINE QLOCAL con el atributo REPLACE. En el apartado Definicin de una cola local en la pgina 58, se ha definido la cola ORANGE.LOCAL.QUEUE. Suponga que, por ejemplo, desea aumentar la longitud mxima de mensajes de esta cola a 10.000 bytes. v Utilice el mandato ALTER:
ALTER QLOCAL (ORANGE.LOCAL.QUEUE) MAXMSGL(10000)
Este mandato modifica un solo atributo, el de la longitud mxima de mensajes; todos los dems atributos permanecen iguales. v Utilice el mandato DEFINE con la opcin REPLACE, por ejemplo:
DEFINE QLOCAL (ORANGE.LOCAL.QUEUE) MAXMSGL(10000) REPLACE
Este mandato no slo modifica la longitud mxima de mensajes sino todos los dems atributos, a los que les asigna sus valores por omisin. Ahora, la cola est habilitada para transferir mientras que antes estaba inhibida para dichas operaciones. Por omisin, la cola est habilitada para transferir, segn lo especificado por la cola SYSTEM.DEFAULT.LOCAL.QUEUE, a menos que el usuario lo haya modificado. Si reduce la longitud mxima de mensajes de una cola existente, esto no afecta a los mensajes que contiene. Sin embargo, todos los mensajes nuevos deben cumplir con los nuevos criterios.
Supresin de los mensajes de una cola local

Para suprimir todos los mensajes de una cola local llamada MAGENTA.QUEUE, utilice el siguiente mandato:
CLEAR QLOCAL (MAGENTA.QUEUE)
Una cola no se puede borrar si: v Hay mensajes no confirmados que se han transferido a la cola bajo un punto de sincronismo. v Una aplicacin tiene abierta la cola en ese momento.
Supresin de una cola local

Utilice el mandato MQSC DELETE QLOCAL para suprimir una cola local. Una cola no puede suprimirse si contiene mensajes no confirmados. Adems, si la cola tiene uno o ms mensajes confirmados y ningn mensaje no confirmado, slo podr suprimirse si se especifica la opcin PURGE. Por ejemplo:
DELETE QLOCAL (PINK.QUEUE) PURGE
Especificando NOPURGE en lugar de PURGE se asegura de que la cola no se suprimir si contiene algn mensaje confirmado.
61
Trabajo con objetos Examen de las colas

MQSeries proporciona un examinador de colas de ejemplo que puede utilizarse para examinar el contenido de los mensajes de una cola. El examinador se suministra tanto en formato fuente como en formato ejecutable. Por omisin, los nombres de archivo y vas de acceso son: Fuente /opt/mqm/samp/amqsbcg0.c Ejecutable /opt/mqm/samp/bin/amqsbcg El ejemplo requiere dos parmetros de entrada, el nombre del gestor de colas y el nombre de la cola. Por ejemplo:
amqsbcg ORANGE.LOCAL.QUEUE saturn.queue.manager
No hay valores por omisin y los dos parmetros son necesarios.
62
Captulo 8. Utilizacin de MQSeries Internet Gateway

Este captulo presenta MQSeries Internet Gateway. Tambin indica cmo obtener ms informacin acerca de cmo utilizar el producto de MQSeries Internet Gateway. MQSeries Internet Gateway es uno de los componentes instalables del CD-ROM MQSeries Servidor y tambin est disponible desde el sitio web de MQSeries. Estn disponibles las siguientes pasarelas: v MQSeries Internet Gateway para AIX v MQSeries Internet Gateway para HP-UX v MQSeries Internet Gateway para Linux v MQSeries Internet Gateway para OS/2 v MQSeries Internet Gateway para OS/390 OpenEdition v MQSeries Internet Gateway para Sun Solaris v MQSeries Internet Gateway para Windows NT
Visin general de MQSeries Internet Gateway

MQSeries Internet Gateway es un puente entre la World Wide Web sncrona y las aplicaciones asncronas de MQSeries. MQSeries Internet Gateway, el software del servidor web y MQSeries proporcionan conjuntamente un navegador de la web conectado a Internet con acceso a las aplicaciones MQSeries. Esto significa que las empresas pueden beneficiarse del acceso asequible a los mercados mundiales que ofrece Internet y de la slida infraestructura y la entrega asegurada de mensajes de MQSeries. La interaccin del usuario con MQSeries Internet Gateway se realiza mediante peticiones POST de formularios HTML rellenables; las aplicaciones MQSeries responden devolviendo pginas HTML a MQSeries Internet Gateway, a travs de una cola MQSeries. MQSeries Internet Gateway da soporte a las siguientes interfaces de servidor web: v Common Gateway Interface (CGI) v Internet Connection Application Programming Interface (ICAPI) v Internet Services Application Programming Interface (ISAPI) v Netscape Connection Application Programming Interface (NSAPI)
63
Utilizacin de Internet Gateway

Tenga en cuenta que: v HP-UX no tiene soporte para NSAPI. v Sun Solaris no tiene soporte para ISAPI. v Linux slo tiene soporte para CGI.
| |
Documentacin de MQSeries Internet Gateway

El sitio web de la familia de productos MQSeries es:
Desde este sitio web puede acceder a la siguiente documentacin: v Cmo empezar con MQSeries Internet Gateway. Es el punto de partida para bajar e instalar MQSeries Internet Gateway. v MQSeries Internet Gateway Gua del usuario. Es la documentacin principal para los usuarios de MQSeries Internet Gateway.
64
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Captulo 9. Obtencin de informacin adicional

Este captulo describe la documentacin para MQSeries para Sun Solaris. En primer lugar, presenta una lista de las publicaciones y, a continuacin, describe los temas siguientes: v Manuales en copia impresa en la pgina 66 v Informacin en lnea en la pgina 66 MQSeries para Sun Solaris se describe en los manuales siguientes:
Tabla 3. Manuales de MQSeries para Sun Solaris
Nmero de pedido Ttulo Manuales especficos de Sun Solaris GC10-3076 (GC33-1870) MQSeries para Sun Solaris Gua rpida de iniciacin Manuales de la familia MQSeries GC10-3590 (GC34-5761) SC33-1872 SC34-5349 GC10-9654 (GC33-1632) SC10-3081 (SC33-1873) SC10-9438 (SC33-1369) SC33-1482 SC10-3342 (SC34-5390) GC10-3078 (GC33-1876) SC33-0807 SC33-1673 SX33-6095 SC33-1877 MQSeries Versin 5.2 Gua del release MQSeries Intercommunication MQSeries Queue Manager Clusters MQSeries Clientes MQSeries Administracin del sistema MQSeries Consulta de mandatos MQSC MQSeries Programmable System Management MQSeries Interfaz de administracin. Gua de programacin y consulta MQSeries Mensajes MQSeries Application Programming Guide MQSeries Application Programming Reference MQSeries Programming Interfaces Reference Summary MQSeries Using C++
65
Manuales en copia impresa

| | Manuales en copia impresa | | | | | | | | | | | | | | | | | | El manual que est leyendo en este momento es MQSeries para Sun Solaris, V5.2 Gua rpida de iniciacin. Este manual junto con el manual MQSeries Versin 5.2 Gua del release son los nicos que se incluyen con el producto en copia impresa. Sin embargo, puede solicitar o imprimir todos los manuales que figuran en la Tabla 3 en la pgina 65. Puede solicitar las publicaciones desde el sitio web de IBMLink:
http://www.ibm.com/ibmlink
En los Estados Unidos, tambin puede solicitar publicaciones llamando al nmero 1-800-879-2755. En Canad, puede solicitar publicaciones llamando al nmero 1-800-IBM-4YOU (1-800-426-4968). Para obtener informacin adicional acerca de cmo solicitar publicaciones, pngase en contacto con su concesionario autorizado o con su representante de ventas IBM. Para obtener informacin acerca de cmo imprimir manuales, consulte el apartado PDF en la pgina 67.
| | Informacin en lnea | | | | | | | | | | | | | | | | | Esta seccin incluye los apartados siguientes: v Publicaciones que se suministran con el producto v Manuales en HTML y PDF en la World Wide Web en la pgina 68 v CD-ROM en formato BookManager en la pgina 69 v Ayuda en lnea en la pgina 69
Publicaciones que se suministran con el producto

En el CD-ROM del producto hay un directorio books. El directorio books contiene los manuales de MQSeries en formatos HTML y PDF. Para acceder a los mismos apunte su navegador web a books/start.htm. HTML Desde el CD-ROM puede ver directamente la documentacin MQSeries en lnea en formato HTML. Todos los manuales, excepto el manual MQSeries Programming Interfaces Reference Summary en ingls de EE.UU. y tambin en algunos o en todos los siguientes idiomas nacionales: v Alemn v Chino simplificado v Coreano
66
Informacin en lnea
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | v v v v Espaol Francs Italiano Japons
Cuando lea los manuales en HTML, podr seguir los enlaces de hipertexto de un manual a otro. Si est leyendo manuales traducidos y enlaza con un manual que no est disponible en el idioma de su pas, en su lugar se abrir la versin del manual en ingls de EE UU. PDF En el CD-ROM se dispone de un PDF (Portable Document Format), que se corresponde con cada uno de los manuales en copia impresa. Puede leer los PDF utilizando Adobe Acrobat Reader. Tambin puede bajarlos a su propio sistema de archivos o puede imprimirlos en una impresora PostScript. Si tiene un navegador web, puede acceder a los PDF del CD-ROM del producto explorando con su navegador en books/start.htm. Los PDF estn disponibles en ingls de EE.UU y tambin en algunos o en todos los idiomas siguientes: v Alemn v Chino simplificado v Coreano v Espaol v Francs v Italiano v Japons Para obtener informacin sobre cules estn disponibles en su idioma, busque el directorio correspondiente en el CD-ROM. Los PDF estn en un subdirectorio denominado ll_LL, donde ll_LL es uno de los siguientes: v de_DE (Alemn) v zh_CN (Chino simplificado) v ko_KR (Coreano) v es_ES (Espaol) v fr_FR (Francs) v en_US (Ingls) v it_IT (Italiano) v ja_JP (Japons) En estos directorios, encontrar el conjunto de PDF disponibles. La Tabla 4 en la pgina 68 muestra los nombres de archivos que se utilizan para los archivos PDF.
67
Informacin en lnea
| | || || || || || || || || || | || || || || || |
Tabla 4. Publicaciones MQSeries nombres de archivos
Manual MQSeries para Sun Solaris Gua rpida de iniciacin MQSeries Versin 5.2 Gua del release MQSeries Intercommunication MQSeries Queue Manager Clusters MQSeries Clientes MQSeries Administracin del sistema MQSeries Consulta de mandatos MQSC MQSeries Programmable System Management MQSeries Interfaz de administracin. Gua de administracin y consulta MQSeries Mensajes MQSeries Application Programming Guide MQSeries Application Programming Reference MQSeries Programming Interfaces Reference Summary MQSeries Using C++ Nombre archivo AMQDSC03 AMQZSY00 CSQZAE04 CSQZAH02 CSQZSF04 AMQZSG01 CSQZSJ04 CSQZAI03 CSQZST01 AMQZSO01 CSQZAL04 CSQZAK04 CSQZAM04 AMQZAN03
| | Manuales en HTML y PDF en la World Wide Web | | | | | | | | | | | | | Adems de en el CD-ROM del producto, los manuales de MQSeries tambin estn disponibles en la World Wide Web. Tanto en formato PDF como HTML. El sitio web de la familia de productos MQSeries se encuentra en la siguiente direccin:
Siguiendo los enlaces de este sitio web, podr: v Obtener la informacin ms reciente sobre la familia de productos MQSeries. v Acceder a los manuales de MQSeries en formatos HTML y PDF. v Bajar SupportPacs de MQSeries.
68
Informacin en lnea
| | CD-ROM en formato BookManager | | | | | | | | | | | La biblioteca MQSeries se suministra con formato IBM BookManager en varios de los kits de bibliotecas en lnea, incluido el kit Transaction Processing and Data, SK2T-0730. Puede ver las publicaciones en copia software, con formato IBM BookManager, utilizando los siguientes programas IBM bajo licencia: BookManager READ/2 BookManager READ/6000 BookManager READ/DOS BookManager READ/MVS BookManager READ/VM BookManager READ para Windows
| | Ayuda en lnea | | | Se proporcionan pginas Man para todas las llamadas API, todos los mandatos MQSC y mandatos de control pertinentes, incluidos los mandatos crtmqm, strmqm y endmqm.
69
70
Parte 3. Apndices
71
72
Apndice A. Programas MQI y archivos MQSC de ejemplo

MQSeries para Sun Solaris proporciona un grupo de cortos programas de MQI y archivos de mandatos MQSC de ejemplo. Puede utilizarlos directamente o modificarlos para realizar pruebas.
Ejemplos de archivos de mandatos MQSC

La Tabla 5 muestra una lista con los archivos de ejemplo de mandatos MQSC. Estos ejemplos son simplemente archivos de texto ASCII que contienen mandatos MQSC. Puede invocar el mandato runmqsc con cada uno de los archivos para crear los objetos especificados en el archivo. Por omisin, estos archivos estn en el directorio /opt/mqm/samp.
Tabla 5. Archivos de mandatos MQSC
Nombre de archivo amqscic0.tst amqscos0.tst amqmdefs.tst Finalidad Definir los objetos que se utilizan en el ejemplo de transaccin CICS. Crear un conjunto de objetos MQI que se utilizan con programas de ejemplo C y COBOL. Definir objetos para la aplicacin de administracin de ejemplo.
Programas de ejemplo C y COBOL

La Tabla 6 muestra una lista con los archivos fuente MQI de ejemplo. Por omisin, los archivos fuente se encuentran en /opt/mqm/samp y las versiones compiladas en el directorio /opt/mqm/samp/bin. Si desea ms informacin sobre las funciones de estos programas y la forma de utilizarlos, consulte el manual MQSeries Application Programming Guide.
Tabla 6. Programas de ejemplo - archivos fuente
C amqsbcg0.c COBOL Finalidad Leer y despus generar la salida de los campos de descriptor de mensaje y de contexto de mensaje de todos los mensajes existentes en una cola especificada. Repetir un mensaje de una cola de mensajes en la cola de respuestas. Puede ejecutarse como un programa de aplicacin activado.
| | | | | | | | | | | |
amqsecha.c
amqmechx.cbl amqiechx.cbl
73
C y COBOL
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Tabla 6. Programas de ejemplo - archivos fuente (continuacin)
C amqsgbr0.c COBOL amq0gbr0.cbl Finalidad Escribir mensajes de una cola en stdout, dejando los mensajes en la cola. Utiliza MQGET con la opcin de examinar. Eliminar los mensajes de la cola indicada (utilizando MQGET) y grabarlos en stdout. Leer la cola activada. Lee cada peticin como si fuera un nombre de cola y responde con informacin sobre dicha cola. Copiar stdin en un mensaje y, a continuacin, transferir el mensaje a una cola especificada. Transferir mensajes de peticin a una cola especificada y despus visualizar los mensajes de respuesta. Inhibir las transferencias a una cola especificada y responder con una sentencia indicando el resultado. Se ejecuta como una aplicacin activada. Supervisor de activacin que lee una cola de inicio especificada y despus arranca el programa asociado con cada mensaje de activacin. Proporciona un subconjunto de la funcin de activacin completa del mandato runmqtrm facilitado. Ejemplo de estructura C de una rutina de salida de conversin de datos. Transferir mensajes a una lista de distribucin. Transferir mensajes a una cola. Obtener mensajes de referencia de una cola. Hacer referencia a una rutina de salida de canal de mensajes.
amqsget0.c
amqminqx.cbl amqiinqx.cbl amqminqx.cbl
amqsinqa.c
amqsput0.c
amq0put0.cbl
amqsreq0.c
amq0req0.cbl
amqsseta.c
amqmsetx.cbl amqisetx.cbl
amqstrg0.c
amqsvfc0.c
amqsptl0.c amqsprma.c amqsgrma.c amqsxrma.c
amq0ptl0.cbl
Nota: Puede crear los objetos necesarios para los ejemplos utilizando el archivo de mandatos MQSC amqscos0.tst.
74
CICS y Encina Soporte para CICS y Encina en el proceso de transacciones

Los ejemplos incluyen una transaccin CICS y algunas cabeceras y programas de inicializacin asociados.
Tabla 7. Ejemplos de proceso de transacciones con CICS y Encina
Nombre de archivo amqzscix.c amqscic0.ccs amqzscgx.c amqscih0.h Finalidad Programa de inicializacin de CICS Programa de ejemplo CICS Programa GLUE para CICS para Solaris Archivo de cabecera para ejemplo de transaccin CICS amqscic0
Nota: Los objetos para dar soporte al proceso de transacciones pueden crearse mediante el archivo de mandatos MQSC amqscic0.tst.
Soporte para Tuxedo en el proceso de transacciones

Los ejemplos incluyen transacciones de cliente y algunas definiciones y archivos de configuracin asociados.
Tabla 8. Ejemplos para el proceso de transacciones con Tuxedo
Nombre de archivo amqstxsx.c amqstxgx.c amqstxpx.c amqstxvx.flds ubbstxcx.cfg Finalidad Servidor de ejemplo Aplicacin de ejemplo GET de cliente Aplicacin de ejemplo PUT de cliente Definicin de campo Archivo de configuracin
Apndice A. Programas MQI y archivos MQSC de ejemplo
75
Bases de datos Soporte para bases de datos

| | | | | | | | | | | | | | Los ejemplos de bases de datos se encuentran en el subdirectorio xatm del directorio de ejemplos.
Tabla 9. Programas de ejemplo - bases de datos
C amqsxas0.c COBOL Finalidad Actualizar una sola base de datos dentro de una unidad de trabajo MQSeries. Se utiliza slo con amqsxas0.sgc amq0xag0.cbl amqsxag0.c, junto con amqsxab0.sqc y amqsxaf0.sqc, o amq0xag0.cbl, con amq0xab0.sqb y amq0xaf0.sqb, actualizan dos bases de datos dentro de una unidad de trabajo MQSeries.
amqsxag0.c
Herramientas varias
Estos archivos de herramientas se facilitan par dar soporte al formateador y la conversin de cdigo.
Tabla 10. Archivos varios
Nombre de archivo amqtrc.fmt ccsid.tbl Ubicacin /opt/mqm/lib /var/mqm/conv/table Finalidad Definir los formatos de rastreo de MQSeries. Editar este archivo para aadir al sistema MQSeries todos los valores de CCSID para los que hay soporte.
76
Apndice B. Pginas de cdigos soportadas en MQSeries para Sun Solaris

| | | | MQSeries para Sun Solaris da soporte a la mayora de las pginas de cdigos que se utilizan en los distintos entornos nacionales (locales); es decir, los subconjuntos de entorno de usuario que definen los convenios para cada cultura que se proporcionan como estndar en Sun Solaris. Si no se define el entorno nacional, se utiliza el valor de la variable de entorno LANG. Si no se definen ni el entorno nacional ni la variable de entorno LANG, el CCSID que se utiliza es el 819 - la pgina de cdigos ISO 8859-1. Nota: No todas las versiones de Solaris dan soporte a todos los entornos nacionales indicados a continuacin. En el apartado Migracin al soporte para el euro en la pgina 83 encontrar ms informacin sobre el soporte para el carcter del euro. El CCSID (Identificador de juego de caracteres codificado) que se utiliza en MQSeries para identificar la pgina de cdigos utilizada para el mensaje y los datos de la cabecera del mensaje se obtienen analizando la variable de entorno LC_CTYPE. La Tabla 11 muestra los entornos nacionales y los CCSID que estn registrados para la pgina de cdigos que utiliza el entorno nacional.
Tabla 11. Entornos nacionales y CCSID
Entorno nacional C ar ar_AA ar_EY bg bg_BG cs cs_CZ cz Idioma Ingls rabe rabe rabe - Egipto Blgaro Blgaro Checo Checo Checo pgina de cdigos ISO8859-1 ISO8859-6 ISO8859-6 ISO8859-6 ISO8859-5 ISO8859-5 ISO8859-2 ISO8859-2 ISO8859-2 CCSID 819 1089 1089 1089 915 915 912 912 912
| | | | | | | | | | | | |
77
Pginas de cdigos soportadas

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Tabla 11. Entornos nacionales y CCSID (continuacin)
Entorno nacional da da.ISO8859-15 da_DK da_DK.ISO8859-15 de de.ISO8859-15 de.UTF-8 de_DE de_DE.ISO8859-15 de_DE.UTF-8 de_AT de_AT.ISO8859-15 de_CH el el_GR el_GR.sun_eu_greek en en_GB en_GB.ISO8859-15 en_UK en_EU.ISO8859-15 en_EU.UTF-8 en_AU en_CA en_IE en_IE.ISO8859-15 en_NZ Idioma Dans Dans Dans Dans Alemn Alemn Alemn Alemn Alemn Alemn Alemn - Austria Alemn - Austria Alemn - Suiza Griego Griego Griego Ingls - Reino Unido Ingls - Reino Unido Ingls - Reino Unido Ingls - Reino Unido Ingls - Europa Ingls - Europa Ingls - Australia Ingls - Canad Ingls - Irlanda Ingls - Irlanda Ingls - Nueva Zelanda pgina de cdigos ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-7 ISO8859-7 CCSID 819 923 819 923 819 923 1208 819 923 1208 819 923 819 813 813
sun_eu_greek 4090 ISO8859-1 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-15 ISO8859-1 819 819 923 819 923 1208 819 819 819 923 819
78

| | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Entorno nacional en_US en_US.ISO8859-15 en_US.UTF-8 es es.ISO8859-15 es.UTF-8 es_ES es_ES.ISO8859-15 es_ES.UTF-8 es_AR es_BO es_CL es_CO es_CR es_EC es_GT es_MX es_NI es_PA es_PE es_PY es_SV es_UY es_VE et et_EE Idioma Ingls - EE.UU. Ingls - EE.UU. Ingls - EE.UU. Espaol - Espaa Espaol - Espaa Espaol - Espaa Espaol - Espaa Espaol - Espaa Espaol - Espaa Espaol - Argentina Espaol - Bolivia Espaol - Chile Espaol - Colombia Espaol - Costa Rica Espaol - Ecuador Espaol - Guatemala Espaol - Mxico Espaol - Nicaragua Espaol - Panam Espaol - Per Espaol - Paraguay Espaol - El Salvador Espaol - Uruguay Espaol - Venezuela Estonio Estonio pgina de cdigos ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-1 ISO8859-15 CCSID 819 923 1208 819 923 1208 819 923 1208 819 819 819 819 819 819 819 819 819 819 819 819 819 819 819 819 923
79

| | | | | | | | | | | | | | | | | | | | | | | | |
Entorno nacional fi fi.ISO8859-15 fi_FI fi_FI.ISO8859-15 fr fr.ISO8859-15 fr.UTF-8 fr_FR fr_FR.ISO8859-15 fr_FR.UTF-8 fr_BE fr_BE.ISO8859-15 fr_CA fr_CH he he_IL hr hr_HR hu hu_HU is is_IS Idioma Fins Fins Fins Fins Francs - Francia Francs - Francia Francs - Francia Francs - Francia Francs - Francia Francs - Francia Francs - Blgica Francs - Blgica Francs - Canad Francs - Suiza Hebreo Hebreo Croata Croata Hngaro Hngaro Islands Islands pgina de cdigos ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-1 ISO8859-8 ISO8859-8 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-1 ISO8859-1 CCSID 819 923 819 923 819 923 1208 819 923 1208 819 923 819 819 916 916 912 912 912 912 819 819
80

| | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Entorno nacional it it.ISO8859-15 it.UTF-8 it_IT it_IT.ISO8859-15 it_IT.UTF-8 it_CH ja ja_JP ja_JP.PCK ja_JP.UTF-8 ko ko.UTF-8 ko_KR lt lt_LT lv lv_LV mk mk_MK nl nl.ISO8859-15 nl_NL nl_NL.ISO8859-15 nl_BE nl_BE.ISO8859-15 Idioma Italiano - Italia Italiano - Italia Italiano - Italia Italiano - Italia Italiano - Italia Italiano - Italia Italiano - Suiza Japons Japons Japons Japons Coreano Coreano Coreano Lituano Lituano Letn Letn Macedonio Macedonio Holands - Holanda Holands - Holanda Holands - Holanda Holands - Holanda Holands - Blgica Holands - Blgica pgina de cdigos ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 eucJP eucJP PCK UTF-8 eucKR UTF-8 eucKR ISO8859-13 ISO8859-13 ISO8859-13 ISO8859-13 ISO8859-5 ISO8859-5 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 CCSID 819 923 1208 819 923 1208 819 5050 5050 943 1208 970 1208 970 921 921 921 921 915 915 819 923 819 923 819 923
81

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Entorno nacional no no_NO nr pl pl_PL POSIX pt pt.ISO8859-15 pt_PT pt_PT.ISO8859-15 pt_BR ro ro_RO ru ru.KOI8-R ru_RU ru_RU.KOI8-R ru_RU.ANSI1251 ru_SU sh_BA sl sl_SI sk sk_SK sq_AL sr sr_SP sr_YU Idioma Noruego Noruego Bosnio Polaco Polaco Ingls Portugus Portugus Portugus Portugus Portugus - Brasil Rumano Rumano Ruso Ruso Ruso Ruso Ruso Ruso Bosnio Esloveno Esloveno Eslovaco Eslovaco Albans Serbio Serbio Serbio pgina de cdigos ISO8859-1 ISO8859-1 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-1 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-15 ISO8859-1 ISO8859-2 ISO8859-2 ISO8859-5 KOI8-R ISO8859-5 KOI8-R ANSI1251 ISO8859-5 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-2 ISO8859-5 ISO8859-5 ISO8859-5 CCSID 819 819 912 912 912 819 819 923 819 923 819 912 912 915 878 915 878 1251 915 912 912 912 912 912 912 915 915 915
82

| | | | | | | | | | | | | | | | | | | | |
Entorno nacional sv sv.ISO8859-15 sv.UTF-8 sv_SE sv_SE.ISO8859-15 sv_SE.UTF-8 th th_TH tr tr_TR zh zh.GBK zh.UTF-8 zh_TW zh_TW.UTF-8 zh_TW.BIG5 Idioma Sueco Sueco Sueco Sueco Sueco Sueco Tailands Tailands Turco Turco Chino simplificado Chino simplificado Chino simplificado Chino tradicional Chino tradicional Chino tradicional pgina de cdigos ISO8859-1 ISO8859-15 UTF-8 ISO8859-1 ISO8859-15 UTF-8 TIS620.2533 TIS620.2533 ISO8859-9 ISO8859-9 eucCN GBK UTF-8 eucTW UTF-8 BIG5 CCSID 819 923 1208 819 923 1208 874 874 920 920 1383 1386 1208 964 1208 950
Para ms informacin sobre el soporte entre plataformas de estos entornos nacionales, consulte la publicacin MQSeries Application Programming Reference.
Migracin al soporte para el euro

Para utilizar el carcter del euro con MQSeries primero deber instalar todas las actualizaciones del sistema necesarias para visualizar el carcter del euro. Modifique ahora el sistema MQSeries: | | | | | | v Edite el archivo CCSID.TBL existente, que est en /var/mqm/conv/table/, para habilitar la nueva versin de euro del identificador del juego de caracteres codificado (CCSID). Para ello, elimine el primer smbolo # de la lnea adecuada de la seccin CCSID Mapping del archivo CCSID.TBL. Una vez realizada esta operacin, todos los gestores de colas que cree adoptarn el nuevo CCSID que contiene el euro.
83
Soporte para el euro

| | | | | | | Nota: Si desea crear un nuevo gestor de colas con un CCSID que tenga soporte para el carcter del euro, seleccione un entorno nacional con soporte para el euro. Para ms informacin, consulte el sitio web de MQSeries en:
v Para modificar los gestores de colas existentes que no tengan soporte para el carcter del euro, efecte este procedimiento: 1. Habilite los mandatos MQSeries (MQSC) escribiendo runmqsc. 2. Anote el CCSID del gestor de colas existente utilizando el mandato de MQSC:
DISplay QMGR CCSID
| | | | |
3. Cambie el CCSID por el CCSID que tiene soporte para el euro utilizando el mandato MQSC: ALTer QMGR CCSID (nm. de ccsid). 4. Detenga los mandatos MQSC escribiendo END. 5. Detenga el gestor de colas. 6. Reinicie el gestor de colas y todos los canales que utilice escribiendo strmqm. A partir de ahora, todos los nuevos mensajes que se emitan utilizando el CCSID del gestor de colas emplearn el nuevo CCSID preparado para el euro. Todos los mensajes que se reciban utilizando MQGET con conversin y que soliciten la utilizacin del CCSID del gestor de colas, adoptarn el CCSID con soporte para el euro. Los CCSID y el texto de objetos (por ejemplo descripciones, definiciones y nombres de salidas) procedentes de mensajes ya existentes no cambiarn. Modifique ahora las aplicaciones para que tengan soporte para el carcter del euro. Si las aplicaciones utilizan CCSID codificados en fbrica que no pueden modificarse, asegrese de que empleen ahora el nuevo CCSID preparado para el euro.
84
Apndice C. Avisos
Esta informacin se ha desarrollado para productos y servicios que se ofrecen en los Estados Unidos. Es posible que en otros pases IBM no ofrezca los productos, los servicios o las caractersticas que se describen en este documento. Pngase en contacto con el representante local de IBM que le informar sobre los productos y servicios disponibles actualmente en su localidad. Las referencias a programas, productos o servicios de IBM no pretenden indicar ni implicar que slo puedan utilizarse los productos, programas o servicios de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y comprobar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. IBM puede tener patentes o solicitudes de patentes en trmite que afecten a los temas tratados en esta informacin. La posesin de esta informacin no confiere ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias, por escrito, a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 Estados Unidos Para consultas sobre licencias en las que se solicite informacin sobre el juego de caracteres de doble byte (DBCS), pngase en contacto con el departamento de propiedad intelectual de IBM de su pas o enve directamente las consultas por escrito a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokio 106, Japn
85
Avisos
El prrafo siguiente no se aplica al Reino Unido ni a ningn otro pas donde estas disposiciones sean incompatibles con la legislacin vigente: INTERNATIONAL BUSINESS MACHINES CORPORATION FACILITA ESTA PUBLICACIN COMO EST SIN GARANTAS DE NINGN TIPO, NI EXPLCITAS NI IMPLCITAS, INCLUYENDO, PERO SIN QUE ELLO CONSTITUYA UN LMITE, LAS GARANTAS IMPLCITAS DE NO INFRACCIN, COMERCIALIZACIN O ADECUACIN A UN FIN CONCRETO. Algunos estados o pases no permiten la renuncia a las garantas explcitas o implcitas en ciertas transacciones, por tanto, es posible que esta declaracin no resulte aplicable a su caso. Esta informacin puede contener imprecisiones tcnicas o errores tipogrficos. Peridicamente se efectan cambios en la informacin aqu contenida; dichos cambios se incorporarn en nuevas ediciones de la informacin. IBM se reserva el derecho a realizar, si lo considera oportuno, cualquier modificacin en los productos o programas que se describen en esta informacin y sin notificarlo previamente. Las referencias de esta informacin a sitios Web que no sean de IBM se proporcionan nicamente como ayuda y no se consideran en modo alguno documentos o sitios Web aprobados por IBM. Los materiales de dichos sitios Web no forman parte de este producto de IBM y la utilizacin de los mismos ser por cuenta y riesgo del usuario. IBM puede utilizar o distribuir la informacin que se le suministre de cualquier modo que considere adecuado sin incurrir por ello en ninguna obligacin con el remitente. Los titulares de licencias de este programa que deseen informacin sobre el mismo con el fin de permitir: (i) el intercambio de informacin entre programas creados independientemente y otros programas (incluido ste) y (ii) la utilizacin mutua de la informacin intercambiada, deben ponerse en contacto con IBM United Kingdom Laboratories, Mail Point 151, Hursley Park, Winchester, Hampshire, Inglaterra SO21 2JN. Dicha informacin puede estar disponible, sujeta a los trminos y condiciones adecuados, incluido, en algunos casos, el pago de una tasa.
86
Avisos
El programa bajo licencia que se describe en esta informacin, y todos los materiales bajo licencia disponibles para el mismo, los proporciona IBM bajo los trminos del Contrato con el cliente IBM, del Contrato Internacional de Licencias para Programas IBM o de cualquier contrato equivalente entre el cliente e IBM. La informacin relacionada con productos que no son de IBM se ha obtenido de los proveedores de dichos productos, de sus anuncios publicados o de otras fuentes de disponibilidad pblica. IBM no ha comprobado estos productos y no puede confirmar la precisin de su rendimiento, compatibilidad ni ninguna otra reclamacin relacionada con los productos que no son de IBM. Las cuestiones relacionadas con las posibilidades de los productos que no son de IBM debern dirigirse a los proveedores de estos productos.
Marcas registradas
Los siguientes trminos son marcas registradas de International Business Machines Corporation en los Estados Unidos de Amrica y/o en otros pases:
AIX CICS IBM OpenEdition SupportPac WebSphere AS/400 DB2 IBMLink OS/2 TXSeries BookManager First Failure Support Technology (FFST) MQSeries OS/390 VSE/ESA
Lotus Notes y Domino son marcas registradas de Lotus Development Corporation en los Estados Unidos de Amrica y/o en otros pases. Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Sun Microsystems Inc. en los Estados Unidos de Amrica y/o en otros pases. ActiveX, Microsoft, Visual Basic, Windows y Windows NT son marcas registradas de Microsoft Corporation en los Estados Unidos de Amrica y/o en otros pases. UNIX es una marca registrada en los Estados Unidos de Amrica y/o en otros pases cuyas licencias facilita exclusivamente X/Open Company Limited. Otros nombres de empresas, productos y servicios pueden ser marcas registradas o marcas de servicio de terceros.
Apndice C. Avisos
87
88
ndice
A
activacin 49 actualizacin de MQSeries para Sun Solaris 35 archivo README 8 archivos de ejemplo CICS y Encina 75 MQSC 73 Tuxedo 75 varios 76 atributo LIKE 60 atributos atributo ALL 59 modificacin 61 por omisin 59 ayuda en lnea 69 cola remota 43 colas atributos 42 descripcin 42 examinar 62 locales copiar 60 definicin 58 supresin 61 suprimir los mensajes 61 modificacin de atributos 61 colas locales copiar definiciones 60 definir una 58 supresin 61 suprimir los mensajes 61 compatibilidad con el ao 2000 3 compiladores 6 compiladores (para el cliente) 26 componentes 7 conectividad 5 conectividad (para el cliente) 26 configuracin kernel 11 configuracin, kernel 27 configuracin de inetd 31 configuracin del cliente, ejemplo 31 configuracin del kernel 11, 27 configuracin del servidor, ejemplo 30 configuraciones 44 configuraciones cliente/servidor 45 conjunto de mandatos de administracin 51 conjuntos de mandatos de administracin mandatos de control 51 mandatos en formato de mandatos programables (PCF) 54 mandatos MQSeries (MQSC) 54 creacin gestor de colas 55 grupos cliente 27 servidor 9 sistema de archivos para el cdigo del producto 11 creacin (continuacin) usuarios 9, 27 creacin de objetos por omisin del sistema 9
D
DCE 6 definicin del CCSID (identificador del juego de caracteres codificado) 22 desinstalar MQSeries 37 detencin de un gestor de colas 33, 56 directorio de instalacin 9
E
ejemplo canal de conexin con el cliente, definicin 32 canal de conexin con el servidor, creacin 31 cola local, creacin 30 configuracin de inetd 31 configuracin del cliente 31 configuracin del servidor 30 gestor de colas crear 30 inicio 30 MQSC, detener 31 MQSC, iniciar 30 obtener el mensaje de la cola en el cliente MQSeries 33 poner un mensaje en la cola en el cliente MQSeries 32 verificacin, finalizacin 33 ejemplos de archivos CICS y Encina 75 MQSC 73 Tuxedo 75 varios 76 ejemplos de programas 73 bases de datos 76 C y COBOL 73 eliminar MQSeries 37 enlazar salidas de usuario 22 entorno nacional (locale) 77 error de sintaxis, en mandatos MQSC 58 estacin de trabajo emisora 18 estacin de trabajo receptora 20
B
bases de datos 6 bibliografa 65 BookManager 69
C
cambios en el manejo de seales 13, 28 canal mensaje 45 MQI 31, 45 sucesos 49 canal de cliente 45 canal de conexin con el cliente, ejemplo 32 canal de conexin con el servidor, ejemplo 31 canal MQI 45 CCSID (identificador de juego de caracteres codificado) 77 definicin 22 cierre controlado 56 cierre del gestor de colas controlado 56 inmediato 56 preferente 56 progresivo 56 cierre preferente del gestor de colas 56 cierre progresivo 56 clientes 45 clusters 46 cola local 43 Copyright IBM Corp. 1995, 2000
89
examen de las colas
62
F
finalizar gestor de colas 56 mandatos MQSC interactivos 58 formato de mandatos programables (PCF) administracin con 54
G
gestor de colas cierre controlado 56 inmediato 56 preferente 56 progresivo 56 cierre inmediato 56 cierre preferente 56 creacin 55 definicin 30 descripcin 43 detencin 33, 56 inicio 30, 55 sucesos 49 supervisin 49 supresin 33, 57 gestor de colas local 43 gestor de colas remoto 43 grupos, creacin 9, 27
instalacin (continuacin) procedimiento para el servidor 14 remota 14 servidor 9 verificacin 16 verificacin de servidor a servidor 18 instalacin, antes 9 instalacin (visin general) 7 instalacin del cliente 25, 28 instalacin del servidor 9 procedimiento 14 instalacin local verificacin 16 instalacin remota 14 interfaz de la World Wide Web 63 Internet Gateway 63 introduccin a MQSeries 41
J
Java soporte para MQSeries 15
L
longitud de mensaje, reduccin 61
M
mandato dltmqm 33 mandato endmqm 33, 56 mandato strmqm 55 mandatos de control 51 formato de mandatos programables (PCF) 54 MQSC ALTER QLOCAL 61 DEFINE QLOCAL 60 DEFINE QLOCAL LIKE 60 DEFINE QLOCAL REPLACE 61 DELETE QLOCAL 61 utilizacin de 54 runmqsc 57 mandatos de control runmqsc 57 sensibles a las maysculas y minsculas 52 mandatos de control sensibles a las maysculas y minsculas 52 mandatos MQSC ALTER QLOCAL 61 DEFINE QLOCAL 60 DEFINE QLOCAL LIKE 60 DEFINE QLOCAL REPLACE 61 DELETE QLOCAL 61
H
Hypertext Markup Language (HTML) 68
I
identificador de juego de caracteres codificado (CCSID) 77 definicin 22 imprimir manuales 67 informacin, pedidos de publicaciones 66 informacin de retorno de los mandatos MQSC 58 informacin en copia software 66 inicio de un gestor de colas 55 instalacin actualizaciones de mantenimiento 35 cliente 26 clientes en el servidor 14 configuracin del kernel 11, 27 directorio, cliente 26 planificacin del cliente 25 preparacin 9, 27 procedimiento de verificacin 16
mandatos MQSC (continuacin) emitir interactivamente 57 finalizar la entrada interactiva 58 utilizacin de 54 mandatos shell para MQSeries 51 manejo de seales, cambios en 13, 28 mantenimiento 35 mantenimiento de MQSeries para Sun Solaris instalacin de actualizaciones 35 requisitos de espacio 35 manuales imprimir 67 pedido de publicaciones 66 manuales en lnea 66 manuales HTML 66 manuales traducidos 15 mensaje canales 45 descripcin 42 descriptor 42 mensajes de error 58 mensajes traducidos 29 servidor 15 migracin al soporte para el euro 83 migracin desde una versin anterior 13, 27 modificacin de atributos de cola 61 MQAI (interfaz de administracin MQSeries) 50 MQSC interactivos finalizar 58 informacin de retorno de 58 utilizacin de 57 MQSeries para Sun Solaris aplicacin de mantenimiento 35 componentes 7 instalacin del cliente 25 requisitos de hardware 3 requisitos de hardware del cliente 25 requisitos de software 3 restauracin del nivel anterior de servicio 35 visin general de 3 MQSeries para Sun Solaris, V5.0, migracin desde 13, 27 MQSeries para Sun Solaris V2.2, migracin desde 13, 27
90
O
objetos atributos por omisin 59 trabajar con 57 objetos, creacin de valores por omisin del sistema 9 objetos por omisin del sistema, creacin 9
restauracin del nivel anterior de servicio 36 runmqsc finalizar 58 informacin de retorno 58 utilizacin interactiva 57
S
salidas de usuario, enlazar 22 sistema de archivos, crear para el cdigo del producto 11 sitio web de MQSeries 64 soporte de idioma 15 soporte de transacciones 47 soporte para el euro, migracin al 83 sucesos 48, 49 canal 49 sucesos de instrumentacin 48 sucesos de rendimiento 49 supervisin de los gestores de colas 49 supervisores de transacciones 6 supresin cola local 61 gestor de colas 33, 57 suprimir los mensajes de una cola local 61
P
pgina de cdigos 77 pginas de cdigos soportadas 77 PDF (Portable Document Format) 67 pedido de manuales 66 pedidos de publicaciones 66 planificacin de la instalacin del cliente 25 por omisin atributos de los objetos 59 mandatos del gestor de colas procesados 57 Portable Document Format (PDF) 67 posibilidades de MQSeries 47 procedimiento de verificacin 16 proceso dirigido por mensajes 49 profundidad de cola actual 60 determinacin de 60 profundidad de cola actual (CURDEPTH) 60 programa de ejemplo amqsgetc 33 programa de ejemplo amqsputc 32 programacin con MQSeries 50 programas de ejemplo 73 bases de datos 76 C y COBOL 73 programas de ejemplo C y COBOL 73 publicaciones 65
verificar la instalacin 16, 29 (continuacin) ejemplo de instalacin 30 finalizacin de la verificacin 33 obtener un mensaje de la cola 33 poner un mensaje en la cola 32 qu muestra el ejemplo 30 versiones anteriores migracin desde la versin 2.2 o la versin 5.0 13, 27 visin general de MQSeries para Sun Solaris 3
W
WebSphere 6
T
tecnologa de soporte de primera anomala (FFST) 11 traducido, mensaje 15 traducidos, manuales 15
U
usuarios, creacin 9, 27
V
variable de entorno LANG 15 MQSERVER 32 NLSPATH 15 variable de entorno LANG 15 variable de entorno MQSERVER 32 variable de entorno NLSPATH 15 verificacin instalacin de servidor a servidor 18 instalacin local 16 verificacin, finalizacin 33 verificacin de una instalacin servidor a servidor 18 verificar la instalacin 16, 29 cmo se lleva a cabo 29 configuracin del cliente 31 configuracin del servidor 30 ndice
R
requisitos, hardware y software requisitos de disco para la instalacin 4 cliente 25 requisitos de espacio instalacin 4 mantenimiento 35 requisitos de hardware 4 cliente MQSeries para Sun Solaris 25 requisitos de software 4, 25 requisitos del disco duro 4 3
91
92
Envo de comentarios a IBM

Si ha habido algn aspecto de este manual que le ha agradado o desagradado especialmente, utilice uno de los mtodos indicados a continuacin para enviar sus comentarios a IBM. No dude en comentar todo aquello que considere errores y omisiones especficos, as como todo lo que afecte a la precisin, organizacin, tema tratado o integridad del manual. Limite sus comentarios a la informacin que contiene esta publicacin y a la forma en que est presentada. Si desea pedir otras publicaciones o hacer preguntas o comentarios sobre las funciones de productos o sistemas de IBM, pngase en contacto con el concesionario autorizado de IBM o con el representante de IBM. Al enviar comentarios a IBM, se concede a IBM un derecho no exclusivo de utilizacin o distribucin de los mismos en la forma que considere adecuada y sin incurrir por ello en ninguna obligacin con el remitente. Puede enviar sus comentarios a IBM en una de las formas siguientes: v Por correo, a la direccin: User Technologies Department (MP095) IBM United Kingdom Laboratories Hursley Park WINCHESTER, Hampshire Reino Unido v Por fax: Desde fuera del Reino Unido, despus de marcar el cdigo de acceso internacional, marque 441962870229 Desde el Reino Unido, marque 01962870229 v Electrnicamente, utilice el ID de red adecuado: IBM Mail Exchange: GBIBM2Q9 at IBMMAIL IBMLink: HURSLEY(IDRCF) Internet: idrcf@hursley.ibm.com
93
Sea cual sea el mtodo utilizado, no olvide incluir: v El ttulo de la publicacin y el nmero de pedido v El tema al que se refiere el comentario v Su nombre y direccin/nmero de tlefono/nmero de fax/ID de red.
94
Envo de comentarios a IBM
95
Printed in Denmark by IBM Danmark A/S
GC10-3076-03
Spine information:
Versin 5.2

Amqdsc 03

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Amqdsc 03

Transféré par

Droits d'auteur :

Formats disponibles

MQSeries para Sun Solaris

Gua rpida de iniciacin

MQSeries para Sun Solaris

Gua rpida de iniciacin

| Novedades de MQSeries para Sun Solaris, | Versin 5 Release 2 . . . . . . . . . xi

Restauracin del nivel anterior de servicio

Captulo 5. Desinstalacin de MQSeries para Sun Solaris . . . . . . . . .

Parte 2. Iniciacin a MQSeries . . 39

Envo de comentarios a IBM .

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Copyright IBM Corp. 1995, 2000

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Copyright IBM Corp. 1995, 2000

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Bienvenido a MQSeries para Sun Solaris

Copyright IBM Corp. 1995, 2000

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Novedades de MQSeries para Sun Solaris, Versin 5 Release 2

Copyright IBM Corp. 1995, 2000

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Parte 1. Instalacin de MQSeries para Sun Solaris

Captulo 5. Desinstalacin de MQSeries para Sun Solaris . . . . . . . . .

Copyright IBM Corp. 1995, 2000

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris

Copyright IBM Corp. 1995, 2000

Requisitos de hardware Requisitos de hardware

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris

Compiladores Compiladores soportados para las aplicaciones Solaris

v Forte C++ 6 (Sun Workshop 6 C++) v Merant Server Express V1.1

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

donde siempre est disponible la versin ms reciente de este soporte.

Captulo 1. Planificacin de la instalacin del servidor MQSeries para Sun Solaris

Componentes de MQSeries para Sun Solaris

Tabla 2. Componentes (continuacin)

Documentacin en lnea de MQSeries:

Nota: El producto base se instala de forma automtica.

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Captulo 2. Instalacin del servidor MQSeries para Sun Solaris

Preparacin para la instalacin

Creacin de objetos por omisin del sistema

Copyright IBM Corp. 1995, 2000

Preparacin para la instalacin

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Preparacin para la instalacin

Configuracin del kernel

Configuracin del Kernel

Figura 1. Valores de parmetros del kernel - valores de ejemplo en un sistema Solaris

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Configuracin del Kernel

Cambios en el manejo de seales

Captulo 2. Instalacin del servidor MQSeries para Sun Solaris

Instalacin del servidor y del cliente en la misma mquina

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Instalacin del servidor y del cliente

donde siempre est disponible la versin ms reciente de este soporte.

Captulo 2. Instalacin del servidor MQSeries para Sun Solaris

Verificacin de la instalacin de MQSeries para Sun Solaris

MQSeries para Sun Solaris V5.2 Gua rpida de iniciacin

Captulo 2. Instalacin del servidor MQSeries para Sun Solaris

2. Para transferir un mensaje a la cola, especifique el siguiente mandato y pulse Intro:

Aparece el siguiente mensaje: | |