Comandos de Control

Comandos de Control
Cap. 1
addmqinf: amqmdain: amqmfsck:
Lista de Comandos
Aade informacin de configuracin MQ WebSphere (Solo plataformas Windows y UNIX). Es usado para configurar o controlar algunas tareas administrativas especficas de Windows. (comprueba sistema de ficheros). amqmfsck comprueba si es compartido un sistema de ficheros en sistemas UNIX e IBM i buscandos los requerimientos para asignacin de los datos del administrador de colas de un administrador de colas multi-instancia. Crea cdigo de conversin de datos desde estructuras de tipo dato. Crea una lista de variables de entorno para una instalacin de WebSphere MQ, en UNIX, Linux, y Windows. Crea entradas de instalacin en mqinst.ini de sistemas UNIX y Linux. Crea un administrador de Colas Borra entradas de instalacin para mqinst.ini en sistemas UNIX y Linux. Borra un administrador de colas. Vuelca una lista de autorizaciones actuales para un rango de tipos de objeto y perfiles WebSphere MQ. Usa el dmpmqcfg para volcar la configuracin de un administrador de colas WebSphere MQ. Visualiza y formatea una porcin del Log de sistema WebSphere MQ. Visualiza informacin sobre los administradores de cola. Visualiza las autorizaciones de un objeto especfico WebSphere MQ. Visualiza el estado de un servidor de comando. Visualiza nombres de fichero correspondientes a objetos WebSphere MQ. Visualiza informacin de configuracin WebSphere MQ (Slo Plataformas -Windows y UNIX). Visualiza entradas de instalacin desde mqinst.ini en UNIX, Linux, y Windows. Determina la ruta que un mensaje ha tomado a travs de una red de administrador de cola. Visualiza una lista de todos los vigas y detalles de un viga nombrado. Formatea y visualiza traza de WebSphere MQ (Slo plataformas Unix). Visualiza en-doubt y heursticamente transacciones completadas. Visualiza versin de WebSphere MQ e informacin de construccin. Para el servidor de comandos para un administrador de colas Finaliza todos los procesos Listener para un administrador de colas. Para el monitor .NET para una cola (Slo Windows). Para el administrador de colas o cambia a un estado dormido.
Esta coleccin de temas suministra referencia de informacin para cada uno de los comandos de control MQ. Estos comandos de control necesitan que el ID est en el grupo mqm.
crtmqcvx: crtmqenv: crtmqinst: crtmqm: dltmqinst: dltmqm: dmpmqaut: dmpmqcfg: dmpmqlog: dspmq: dspmqaut: dspmqcsv: dspmqfls: dspmqinf: dspmqinst: dspmqrte: dspmqspl: dspmqtrc: dspmqtrn: dspmqver: endmqcsv: endmqlsr: endmqdnm: endmqm:
endmqsvc: endmqtrc: migmbbrk:
Finaliza el servicio WebSphere MQ IBM en Windows. (Ejecuta el comando slo en Windows). Finaliza la traza para algunos o todas las entidades que estn con la traza iniciada. El comando migmbbrk migra los datos de configuracin publish/subscribe de WebSphere Event Broker Versin 6.0 WebSphere Message Broker Versin 6.0 6.1 a WebSphere MQ Versin 7.0.1 versiones posteriores. (cdigo retorno MQ) Visualiza informacin sobre cdigos de retorno. Escribe la imagen de un objeto o grupo de objetos al log para medio de recuperacin. Recrea un objeto, o grupo de objetos, desde sus imgenes contenidas en el log. Retira informacin de configuracin WebSphere MQ (slo plataformas Windows y UNIX). Confirma o retrocede una transaccin (Commit or back out) Ejecuta un proceso iniciador de canal para automatizar inicio de canales. Inicia un canal emisor o peticionario. Inicializa el canal de cola muerta para monitorizar y procesar mensajes en la cola muerta. Inicia procesado de mensajes en una cola usando el monitor .NET (slo Windows). Ejecuta un proceso listener para listado de peticiones remotas en varios protocolos de comunicacin. Ejecuta comandos WebSphere MQ en un administrador de cola. Inicia el monitor de disparo en un cliente. Inicia el monitor de disparo en un servidor. Cambia de cluster el canal en UNIX, Linux, y Windows. Cambia las autorizaciones a un perfil, objeto, o clase de objetos. Las autorizaciones pueden garantizarse, o revocarse, cualquier nmero de principales o grupos. Administrador CRL (lista de revocacin de certificado) definiciones LDAP en un Directorio Activo (slo Windows). Selecciona el entorno WebSphere MQ, en UNIX, Linux, y Windows. Selecciona instalaciones WebSphere MQ, en UNIX, Linux, y Windows. Selecciona la instalacin asociada de un administrador de cola. Define una nueva poltica de seguridad, despus que ya existe una, o retira una existente. Matricula una licencia de produccin WebSphere MQ. Publica definiciones de canal de conexin cliente en un Directorio Activo (Slo Windows). Inicia un Explorador WebSphere MQ (Slo Plataformas Windows, Linux x86, y Linux x86-64). Inicia el servidor de comando para un administrador de cola. Inicia servicio IBM WebSphere MQ (solo Windows). Inicia un administrador de cola o lo habilita para operaciones de reserva. Activa Traza en un nivel de detalle especificado, o informa del nivel de trazado en efecto.
mqrc: rcdmqimg: rcrmqobj: rmvmqinf: rsvmqtrn: runmqchi: runmqchl: runmqdlq: runmqdnm: runmqlsr: runmqsc: runmqtmc: runmqtrm: runswchl: setmqaut: setmqcrl: setmqenv: setmqinst: setmqm: setmqspl: setmqprd: setmqscp: strmqcfg: strmqcsv: Strmqsvc: strmqm: strmqtrc:
Cap. 2
2.1
Detalle de Comandos
Addmqinf
Aade informacin de configuracin MQ WebSphere (Solo plataformas Windows y UNIX).
2.1.1
Propsito
Use el comando addmqinf para aadir informacin a los datos de configuracin WebSphere MQ. Por ejemplo, usar dspmqinf y addmqinf para copiar datos de configuracin desde el sistema donde un administrador de cola ha sido definido, a otro sistema donde el mismo administrador de cola mult-instancia tambin est para ser iniciado.
2.1.2
Sintaxis
.------------------------. .- -s -QueueManager-. V | >>-addmqinf -+-------------------+---- -v - Attribute= Value-+->< '- -s -StanzaType---'
2.1.3
Parmetro
Parmetros necesarios
Descripcin
El nombre y valor de los atributos de estrofa a ser colocados en la estrofa especificada en el comando. La siguiente tabla lista los valores de atributos de estrofa QueueManager. La estrofa administrador de cola es la nica estrofa que est soportada actualmente.
-v Attribute=Value
Tabla 1. Atributos de grupo QueueManager

Atributo Name Valor El nombre del administrador de cola. Debe suministrar un You must provide a different name from any other queue manager stanza on the system. The directory path under which this queue manager data directory is stored by default. You can use Prefix to modify the location of the queue manager data directories. The value of Directory is automatically appended to this path. The name of the queue manager data directory. Sometimes the name must be provided (as in Example), because it is different from the queue manager name. Copy the directory name from the value returned by dspmqinf. The rules for transforming queue manager names into directory names are described in Understanding WebSphere MQ file names. The directory path where the queue manager data files are placed. The value of Directory is not automatically appended to this path - you must provide the transformed queue manager name as part of DataPath. If the DataPath attribute is omitted on UNIX, the queue manager data directory path is defined as Prefix/Directory. Necesario/Opcional Necesario
Prefix
Necesario
Directory
Necesario
DataPath
UNIX: Opcional Windows: Necesario
2.1.4
Parmetro
-s StanzaType
Parmetros opcionales
Descripcin
Un estrofa del tipo StanzaType es aadida a la configuracin de WebSphere MQ. El valor por defecto de StanzaType es QueueManager. El nico valor soportado de StanzaType is QueueManager.
2.1.5
Cd. Ret.
0 1 39 45 46 58 69 71 72 100
Cdigos de retorno
Descripcin
Operacin exitosa Localizacin de administrador de cola no vlida (bien Prefijo o RutaDatos) Parmetros de lnea-de-comandos malos La estrofa ya existe Est desaparecido atributo de configuracin necesario Inconsistencia de uso de instalaciones detectadas. Almacenamiento no disponible Error inesperado Error en nombre de administrador de cola Localizacin de Log no vlida
2.1.6
Ejemplo
addmqinf v DataPath=/MQHA/qmgrs/QM!NAME -v Prefix=/var/mqm -v Directory=QM!NAME -v Name=QM.NAME Define la siguiente estancia en mqs.ini: QueueManager: Name=QM.NAME Prefix=/var/mqm Directory=QM!NAME DataPath=/MQHA/qmgrs/QM!NAME
2.1.7
Notas de Uso
Usar dspmqinf con addmqinf para definir una instancia de un administrador de cola multi-instancia en un servidor diferente. Para usar este comando debe ser un administrador de WebSphere MQ y un miembro del grupo mqm.
2.1.8
Comandos relacionados
Descripcin
Visualiza informacin de configuracin de WebSphere MQ Retira informacin de configuracin WebSphere MQ
Command
dspmqinf rmvmqinf
2.2
amqmdain
Es usado para configurar o controlar algunas tareas administrativas especficas de Windows.
2.2.1
Propsito
Aplicable solo a WebSphere MQ para Windows.
Usado para realizar algunas tareas administrativas especficas de Windows. Inicia un administrador de cola con amqmdain es equivalente a usar el commando strmqm con la opcin ss. amqmdain realiza la ejecucin del administrador de colas en una sesin no-interactiva bajo una cuenta de usuario diferente. Sin embargo, para asegurar que todos los administradores de colas que iniciaron la regeneraron se devuelve a la lnea de comando, usa el comando strmqm -ss mejor que amqmdain. Debe usarse el commando amqmdain desde la instalacin asociada con el administrador de cola con el que ests trabajando. Puedes buscar qu instalacin del administrador de cola est asociado con el usando el commando de instalacin dspmq -o. Para administrar y definer el servicio y objetos listener de WebSphere MQ, usar comandos MQSC, comandos PCF, o el Explorador WebSphere MQ. El comando amqmdain ha sido actualizado para modificar bien los ficheros .ini o el registro segn proceda.
2.2.2
Sintaxis
>>-amqmdain-----------------------------------------------------> >--+| +| | | | +| | ++++| | ++| 'qmgr start --QMgrName--------------------------+--------->< .- -c -. | qmgr end --QMgrName--+-+------+--+------+-+----+ | +- -w -+ +- -s -+ | | | +- -i -+ '- -r -' | | | '- -p -' | | '- -x ---------------' | qmgr alter --QMgrName--+---------------------+-+ +- -i --Initiation----+ | '- -x--Multi-instance-' | refresh ---------------------------------------+ auto --QMgrName--------------------------------+ manual --QMgrName------------------------------+ status --+----------+--------------------------+ +-QMgrName-+ | '-all------' | regsec ----------------------------------------+ spn --QMgrName--+-set---+----------------------+ '-unset-' | reg --+----------+--RegParams------------------' +-QMgrName-+ '- * ------'
2.2.3
Palabras clave y parmetros
Son necesarios todos los parmetros a menos que la descripcin de estados All sean opcionales. En cualquier caso, QMgrName es el nombre del administrador de cola para el que se aplican los comandos. Parmetro
qmgr start QMgrName
Descripcin
Inicia un administrador de cola. Este parmetro puede tambin ser escrito en el formato start QMgrName. Si inicias el administrador de cola como un servicio y necesitas que el administrador de cola contine ejecutndose despus de terminar la sesin, usar el comando strmqm -ss qmgr en lugar de amqmdain start qmgr. Finaliza un administrador de cola. Este parmetro puede tambin escribirse en el formato end QMgrName. Para consistencia en plataformas cruzadas, usar endmqm qmgr en lugar de amqmdain end qmgr. Para una completa descripcin de las opciones, consultar endmqm.
qmgr end QMgrName
Parmetro
-c -w -i -p -r -s -x qmgr alter QMgrName -i Initiation
Descripcin
Apagado controlado (o inactivo). Apagado con espera. Apagado inmediato. Apagado preventivo. Reconectar clientes. Conmuta entre una instancia administrador de cola de reserva. Finaliza la instancia de reserve de una administrador de cola sin finalizar la instancia activa. Altera un administrador de cola. Especifica el tipo de iniciacin. Los valores posibles son: Descripcin Sets the queue manager to automatic startup (when the machine starts, or more precisely when the WebSphere MQ service starts). The syntax is: amqmdain qmgr alter QmgrName i auto interactive Sets the queue manager to manual startup that then runs under the logged on (interactive) user. The syntax is: amqmdain qmgr alter QmgrName i interactive service Sets the queue manager to manual startup that then runs as a service. The syntax is: amqmdain qmgr alter QmgrName i service Specifies if auto queue manager start by the WebSphere MQ service permits multiple instances. Equivalent to the -sax option on the crtmqm command. Also specifies if the amqmdain start qmgr command permits standby instances. Possible values are: Valor Descripcin set Sets automatic queue manager startup to permit multiple instances. Issues strmqm -x. The set option is ignored for queue managers that are initiated interactively or as a manual service startup. The syntax of the command is: Valor auto
-x Multi-instance
amqmdain qmgr alter QmgrName x set

unset Selecciona automticamente el inicio del administrador de cola a una simple instancia. Emitir strmqm. La opcion unset es ignorada para administradores de cola que son iniciados interactivamente o como un inicio de servicio manual. La sintxis del commando es:
amqmdain qmgr alter QmgrName x unset

refresh auto QMgrName manual QMgrName status QMgrName | all Refresca o chequea el estado de un administrador de cola. No vers ningn retorno en la pantalla despus de ejecutar este commando. Sets a queue manager to automatic startup. Selecciona un administrador de cola para inicio manual. Este parmetro es opcional. Si no es suministrado parmetro: Visualiza el estado de los servicios WebSphere MQ. Si es suministrado un Visualiza estado del administrador de cola nombrado. QMgrName: Si es suministado el parmetro Visualiza estado de los servicios WebSphere MQ y all: todos los administradores de cola. Ensures that the security permissions assigned to the Registry keys containing installation information are correct. Puedes seleccionar agrupado o desagrupado el nombre de servicio principal para un administrador de cola. Los parmetros QMgrName, y * son opcionales. Si solo es especificado RegParams: Modifies queue manager configuration information related to the default queue manager. Si son especificados QMgrName y Modifies queue manager configuration information RegParams: related to the queue manager specified by QMgrName. Si son especificados * y RegParams: Modifies WebSphere MQ configuration information. El parmetro, RegParams, especifica la estrofa a cambiar, y los cambios a realizar. RegParams toma uno de los formatos siguientes: -c add -s stanza -v attribute=value -c remove -s stanza -v [attribute|*] -c display -s stanza -v [attribute|*] Si has especificado una informacin de configuracin del administrador de cola, los valores vlidos para la estrofa son : QMErrorLog QueueManagerStartup XAResourceManager\name Broker TCP ApiExitLocal\name LU62 Channels ExitPropertiesLocal SPX ExitPath
regsec spn QMgrName set | unset reg QMgrName
* RegParams
Parmetro
Descripcin
InstanceData NetBios SSL Log Connection Si ya has modificado informacin de configuracin WebSphere MQ, los valres vlidos para la estrofa son: LogDefaults AllQueueManagers ApiExitCommon\name ExitProperties Channels ApiExitTemplate\name DefaultQueueManager ACPI The following are usage considerations: amqmdain does not validate the values you specify for name, attribute, or value. When you specify add, and an attribute exists, it is modified. If a stanza does not exist, amqmdain creates it. When you specify remove, you can use the value * to remove all attributes. When you specify display, you can use the value * to display all attributes which have been defined. This value only displays the attributes which have been defined and not the complete list of valid attributes. If you use remove to delete the only attribute in a stanza, the stanza itself is deleted. Any modification you make to the Registry re-secures all WebSphere MQ Registry entries.
2.2.4
Ejemplos
El ejemplo siguiente aade un XAResourceManager al Test administrador de cola. Los comandos emitidos son: amqmdain reg TEST -c add -s XAResourceManager\Sample -v SwitchFile=sf1 amqmdain reg TEST -c add -s XAResourceManager\Sample -v ThreadOfControl=THREAD amqmdain reg TEST -c add -s XAResourceManager\Sample -v XAOpenString=openit amqmdain reg TEST -c add -s XAResourceManager\Sample -v XACloseString=closeit To display the values set by the commands above, use: amqmdain reg TEST -c display -s XAResourceManager\Sample -v * La visualizacin debera asemejarse a lo siguiente: 0784726, 5639-B43 (C) Copyright IBM Corp. 1994, 2002. ALL RIGHTS RESERVED. Displaying registry value for Queue Manager 'TEST' Attribute = Name, Value = Sample Attribute = SwitchFile, Value = sf1 Attribute = ThreadOfControl, Value = THREAD Attribute = XAOpenString, Value = openit Attribute = XACloseString, Value = closeit Para retirar el XAResourceManager del Test administrador de cola, usa: amqmdain reg TEST -c remove -s XAResourceManager\Sample -v *
2.2.5
Cd. Ret. 0 -2 -3 -6 -7 -9 -16 -29 62 71 119
Cdigos de retorno
Descripcin
Comando completado normalmente Error de sintxis Inicializacin fallida de MFC Feature no longer supported Configuration failed Unexpected Registry error Failed to configure service principal name Inconsistencia de uso de instalaciones detectadas. The queue manager is associated with a different installation Error inexperado Permission denied (Windows only)
Nota: Si es emitido el comando qmgr start QMgrName, todos los cdigos de retorno que pueden ser devueltos con strmqm, tambin pueden ser devueltos. Para una lista de cdigos de retorno, consultar strmqm.
Si es emitido el comando qmgr end QMgrName, todos los cdigos que pueden ser devueltos con endmqm, pueden tambin ser retornados. Para una lista de estos cdigos de retorno, consultar endmqm.
2.3
amqmfsck (comprueba el sistema de ficheros)
amqmfsck comprueba si un sistema de ficheros compartido en sistemas UNIX e IBM reune los requerimientos para asignar datos de administrador de cola de un administrador de cola multi-instancia.
2.3.1
Propsito
El commando amqmfsck se aplica solo a sistemas UNIX e IBM i. No necesitas comprobar la uniad de red en Windows. amqmfsck testea que un sistema de fichero canaliza correctamente escrituras a un fichero y la espera y libera bloqueos.
2.3.2
Sintaxis
>>-amqmfsck--+-----+--+-----------------------------+--DirectoryName->< '- -v-' +- -a ------------------------+ +- -c ------------------------+ +- -f -+--------------------+-+ | | .-262144----. | | | '- -p -+-PageCount-+-' | +- -i ------------------------+ +- -w ------------------------+ '- - x -----------------------'
2.3.3
DirectoryName
El nombre del directorio a comprobar.
2.3.4
Parmetro
-a -c -f -i -p
Descripcin
Realiza la segunda fase del test de integridad de datos. Ejecuta esto en dos mquinas al mismo tiempo. Debes tener formateado el fuchero de test usando la opcin f previamente Test writing to a file in the directory concurrently. Perform the first phase of the data integrity test. Formats a file in the directory in preparation for data integrity testing. Perform the third phase of the data integrity test. Checks the integrity of the file after the failure to discover whether the test worked. Specifies the size of the test file used in the data integrity test in pages. . The size is rounded up to the nearest multiple of 16 pages. The file is formatted with PageCount pages of 4 KB. The optimum size of the file depends on the speed of the filesystem and the nature of the test you perform. If this parameter is omitted, the test file is 262144 pages, or 1 GB. The size is automatically reduced so that the formatting completes in about 60 seconds even on a very slow filesystem. Verbose output. Testea esperando para liberar bloqueos. Deletes any files created by amqmfsck during the testing of the directory. Do not use this option until you have completed the testing, or if you need to change the number of pages used in the integrity test.
-v -w -x
2.3.5
Uso
Debes ser un administrador WebSphere MQ para ejecutar el commando. Debes tener acceso de lectura/escritura para el directorio que se ha de comprobar.
En IBM i, usa QSH para ejecutar el programa. No es un comando CL. El commando devuelve un cdigo de salida de 0 si el test tiene xito completo. La tarea, Verifying shared file system behavior, describe como usar amqmfsck para comprobar si un fichero de sistema es conveniente para administradores de cola multi-instancia.
2.3.6
Interpretacin de resultados
If the check fails, the file system is not capable of being used by WebSphere MQ queue managers. If the tests fail, choose verbose mode to help you to interpret the errors. The output from the verbose option helps you understand why the command failed, and if the problem can be solved by reconfiguring the file system. Sometimes the failure might be an access control problem that can be fixed by changing directory ownership or permissions. Sometimes the failure can be fixed by reconfiguring the file system to behave in a different way. For example, some file systems have performance options that might need to be changed. It is also possible that the file system protocol does not support concurrency sufficiently robustly, and you must use a different file system. For example, you must use NFSv4 rather than NFSv3. If the check succeeds, the command reports The tests on the directory completed successfully. If your environment is not listed as supported in the testing and support statement, this result does not necessarily mean that you can run WebSphere MQ multi-instance queue managers successfully. You must plan and run a variety of tests to satisfy yourself that you have covered all foreseeable circumstances. Some failures are intermittent, and there is a better chance of discovering them if you run the tests more than once.
2.3.7
Tareas relacionadas:
Verifying shared file system behavior
2.4
crtmqcvx
Define cdigo de conversion de datos desde estructuras de tipo dato.
2.4.1
Propsito
Use el commando crtmqcvx para definer un fragment de cdigo que realize conversion de datos en estructuras de tipo dato. El comando genera una function C que puede ser usada en una salida a convertir estructuras C. El commando lee un fichero de entrada conteniento estructuras a ser convertidas, y escribe un fichero de alida conteniendo fragmentos de aquellas estructuras a convertir. Para informacin sobre el uso de este commando, consulta Utility for creating conversionexit code.
2.4.2
Sintaxis
>>-crtmqcvx--SourceFile--TargetFile----------------------------><
2.4.3
Parmetro
SourceFile TargetFile
Descripcin
El fichero conteniendo las estructuras C a convertir. El fichero de salida conteniendo los fragmentos de cdigo generados para convertir las estructuras.
2.4.4
Cdigos de retorno
Cd. Ret.
0 10 20 Comando completado normalmente Comando completado con resultados inexperados Ha ocurrido un error durante el proceso
Descripcin
2.4.5
Ejemplos
El siguiente ejemplo muestra los resultados de uso del commando de conversion de datos nuevamente en una estructura fuente C. El comando emitido es: crtmqcvx fuente.tmp destino.c El fichero de entrada, fuente.tmp, se ver semejante a esto: /* Este es una estructura C de test que puede ser convertida */ /* por la utilidad crtmqcvx */ struct mi_estructura { int code; MQLONG value; }; El fichero de salida, destino.c. producido por el comando, se asemejar a esto: MQLONG Convertmy_structure( PMQDXP pExitParms, PMQBYTE *in_cursor, PMQBYTE *out_cursor, PMQBYTE in_lastbyte, PMQBYTE out_lastbyte, MQHCONN hConn, MQLONG opts, MQLONG MsgEncoding, MQLONG ReqEncoding, MQLONG MsgCCSID, MQLONG ReqCCSID, MQLONG CompCode, MQLONG Reason) { MQLONG ReturnCode = MQRC_NONE; ConvertLong(1); /* code */ AlignLong(); ConvertLong(1); /* value */ Fail: return(ReturnCode); } Puedes usar este fragmento de cdigo en tus aplicaciones para convertir estructuras de datos. Sin embargo, si lo haces, el fragmento usa macros suplidas en el fichero de cabecera amqsvmha.h.
2.5
crtmqenv
Crea una lista de variables de entorno para la instalacin de WebSphere MQ, en UNIX, Linux, y Windows.
2.5.1
Propsito
Puedes usar el commando crtmqenv para definer una lista de variables de entorno con los valores apropiados para una instalacin de WebSphere MQ. La lista de variables de entorno son
visualizadas en la lnea de commando, y cualquier variable que exista en el sistema tiene los valores WebSphere MQ aadidos a ella. Este comando no selecciona variables de entorno, pero guarda las apropiadas cadenas para seleccionar las variables mismas, por ejemplo, con tus propios scripts. Si deseas seleccionar variables de entorno para tu capa de entorno, puedes usar el commando setmqenv en lugar de utilizar el comando crtmqenv. You can specify which installation the environment is created for by specifying a queue manager name, an installation name, or an installation path. You can also create the environment for the installation that issues the crtmqenv command by issuing the command with the -s parameter. sistema: Este commando lista las siguientes variables de entorno, y sus valores, apropiados para tu CLASSPATH INCLUDE LIB MANPATH MQ_DATA_PATH MQ_ENV_MODE MQ_FILE_PATH MQ_JAVA_INSTALL_PATH MQ_JAVA_DATA_PATH MQ_JAVA_LIB_PATH MQ_JAVA_JVM_FLAG MQ_JRE_PATH PATH
En sistemas UNIX y Linux, si es especificada la seal -l o -k, la variable de entorno LIBPATH es seleccionada a AIX, y la variable de entorno LD_LIBRARY_PATH es seleccionada a HPUX, Linux, y Solaris.
2.5.2
Notas de Uso
El commando crtmqenv retira todos los directories para todas las instalaciones WebSphere MQ desde las variables de entorno antes de aadir nuevas referencias a la instalacin para la que ests ajustando el entorno. Por lo tanto, si deseas seeccionar cualquier variable de entorno adicional que referencie a WebSphere MQ, selecciona las variables despus de emitir el comando crtmqenv. Por ejemplo, si deseas aadir MQ_INSTALLATION_PATH/java/lib a LD_LIBRARY_PATH, debes hacerlo despus de ejecutar crtmqenv.
2.5.3
Sintaxis
-m--QMgrName---------+--+-----+--+-----------+--+-----+->< -n--InstallationName-+ +- -k-+ '- -x -Mode-' '- -i-' -p--InstallationPath-+ '- -l ' -r-------------------+ -s-------------------'
>>-crtmqenv--++++'-
2.5.4
Descripcin
Define el entorno para la instalacin asociada con el administrador de cola QMgrName. Define el entorno para la instalacin nombrada InstallationName. Define el entorno para la instalacin en la ruta InstallationPath. Retira todas las instalaciones para el entorno. Define el entorno para la instalacin que ha emitido el comando.
Parmetro
-m QMgrName -n InstallationName -p InstallationPath -r -s
2.5.5
Parmetro
-k
Descripcin
UNIX and Linux only.
-l
-x Mode
-I
Include the LD_LIBRARY_PATH , or LIBPATH, environment variable in the environment, adding the path to the WebSphere MQ libraries at the start of the current LD_LIBRARY_PATH, or LIBPATH, variable. UNIX and Linux only. Include the LD_LIBRARY_PATH, or LIBPATH, environment variable in the environment, adding the path to the WebSphere MQ libraries at the end of the current LD_LIBRARY_PATH, or LIBPATH, variable. Mode can take the value 32, or 64. Create a 32-bit or 64-bit environment. If this parameter is not specified, the environment matches that of the queue manager or installation specified in the command. Any attempt to display a 64-bit environment with a 32bit installation fails. List only the additions to the environment. When this parameter is specified, the environment variables set for previous installations remain in the environment variable path and must be manually removed.
2.5.6
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
Comando completado normalmente. Comando completado con resultados inexperados. Ha ocurrido un error durante el proceso.
2.5.7
Ejemplos
Los siguientes ejemplos asumen que una copia de WebSphere MQ est instalada en /opt/mqm de un sistema UNIX o Linux. 1. Este comando define una lista de variables de entorno para una instalacin instalada en /opt/mqm:
/opt/mqm/bin/crtmqenv -s 2. Este commando define una lista de variables de entorno para una instalacin instalada en /opt/mqm2, e incluye la ruta de la instalacin al final del valor actual de la variables LD_LIBRARY_PATH: /opt/mqm/bin/crtmqenv -p /opt/mqm2 -l 3. Este commando define una lista de variables de entorno para el administrador de cola QM1, en un entorno de 32-bit: /opt/mqm/bin/crtmqenv -m QM1 -x 32 4. El siguiente ejemplo assume que est instalada una copia de WebSphere MQ en c:\Program Files\IBM\WebSphere MQ de un sistema Windows. Este comando define una lista de variables de entorno para una instalacin llamada instalacion1: "c:\Program Files\IBM\WebSphere MQ\crtmqenv" -n instalacion1
2.5.8
Referencia relacionada:
setmqenv
2.5.9
Informacin relacionada
Choosing a primary installation Multiple installations
2.6
crtmqinst
Define entradas de instalacin en mqinst.ini para sistemas UNIX y Linux.
2.6.1
Propsito
El fichero mqinst.ini contiene informacin sobre todas las instalaciones WebSphere MQ en un sistema. Para ms informacin sobre mqinst.ini, see Installation configuration file, mqinst.ini. La primera instalacin de WebSphere MQ installation es guardada automticamente en un nombre de instalacin de Installation1 ya que el comando crtmqinst no est disponible hasta que una instalacin de WebSphere MQ est en el sistema. Instalaciones siguientes pueden tener un nombre de instalacin seleccionada antes de que ocurra la instalacin, al usar el comando crtmqinst. EL nombre de instalacin no puede ser cambiado despus de la instalacin. Para ms informacin sobre nombres de instalacin, consultar Choosing an installation name.
2.6.2
Sintaxis
>>-crtmqinst----+- -p -InstallationPath----------------------------+--+---------------------+--->< +- -n -InstallationName----------------------------+ '- -d DescriptiveText-' | (1) | +- -p -InstallationPath-- -n -InstallationName-----+ | (1) | '- -n--InstallationName-- -p -InstallationPath-----' Notas: Cuando se especifica conjuntamente, el nombre de instalacin y la ruta de instalacin deben referirse a la misma instalacin.
2.6.3
-d
Parmetros
Descripcin
Texto que describe la instalacin. El texto puede ser de hasta 64 caracteres de byte-simple, o 32 caracteres de bytedoble. El valor por defecto es todo blancos. Debes usar las comillas para el texto que contenga blancos. El nombre de la instalacin. El nombre puede contener hasta 16 caracteres de byte-simple y debe ser una combinacin de caracteres algabticos y numricos en los rangos de a-z, A-Z, y 0-9. El nombre de instalacin debe ser nico, independiente de si se usan maysculas o minsculas. Por ejemplo, los nombres INSTALACIONNOMBRE e InstalacionNombre no son nios. Si no suministras un nombre de instalacin, es usado el siguiente nombre disponible en la serie Installation1, Installation2.... La ruta de intalacin. Si no suministras la ruta de instalacin, es usado, /opt/mqm en sistemas UNIX y Linux, y /usr/mqm en AIX.
Parmetro
-n InstallationName
-p InstallationPath
2.6.4
Cd. Ret.
0 10 36 37 45 59 71 89 96 98 131
Cdigos de retorno
Descripcin
Entrada creada sin error Nivel de instalacin no valido Argumentos suplidos no validos El texto descriptivo est en error Ya existe la entrada Instalacin especificada no vlida Error inexperado .Error en fichero INI No puede bloquear el fichero .INI Autoridad insuficiente para acceder a fichero .INI Problema de recurso
2.6.5
Ejemplo
Este commando define una entrada con un nombre de instalacin de miInstalacion, una ruta de instalacin de /opt/miInstalacion, y una descriocin "Mi instalacin WebSphere MQ": crtmqinst -n MiInstalacion -p /opt/miInstalacion -d "Mi instalacion WebSphere MQ" El encomillado es necesario ya que el texto descriptivo contiene espacios.
2.7
crtmqm
Define un administrador de cola.
2.7.1
Propsito
Use el commando crtmqm para definir un administrador de cola y definir los objetos y sistema por defecto. Los objetos definidos por crtmqm estn listados en System and default objects. Cuando un administrador de cola ha sido definido, usa el comando strmqm para iniciarlo. El administrador de cola es asociado automticamente con la instalacin desde el commando crtmqm que ha sido emitido. Para cambiar la instalacin asociada, usa el commando setmqm. Observa que el instalador de Windows no aade al usuario que realize la instalacin al grupo de mqm, para ms detalles, consulta Authority to administer WebSphere MQ on UNIX, Linux and Windows systems.
2.7.2
Sintaxis
>>-crtmqm--+-------------------------------------+--------------> | (1) | '- -a -+-LocalGroup-------------+-----' +-GlobalGroup------------+ +-Domain--\--GlobalGroup-+ '-GlobalGroup--@--Domain-' >--+-----------+--+-------------------------------+-------------> '- -c -Text-' '- -d -DefaultTransmissionQueue-' .- -lc-. >--+-------------------------+--+------+--+---------------+-----> '- -h -MaximumHandleLimit-' '- -ll-' '- -ld -LogPath-' >--+--------------------+--+-----------------------+------------> '- -lf -LogFilePages-' '- -lp -LogPrimaryFiles-' .- -ss--. >--+-------------------------+--+-----+--+-------+--------------> '- -ls -LogSecondaryFiles-' '- -q ' +- -sa--+ +- -sax-+ '- -si--' >--+----------------+--+-----------------------+----------------> '- -md -DataPath-' '- -g -ApplicationGroup-' >--+--------------------+--+----------------------+-------------> '- -t -IntervalValue-' '- -u -DeadLetterQueue-' >--+---------------------------------+--+-----+--QMgrName------>< '- -x -MaximumUncommittedMessages-' '- -z ' Notas: Slo Windows
2.7.3
Descripcin
Parmetro
QMgrName
El nombre del administrador de cola a definir. El nombre puede contener hasta 48 caractres. Este parmetro debe ser el ultimo item del comando.
2.7.4
Descripcin
El nombre de un grupo de acceso de seguridad adicioal. Debes definir el grupo adicional antes de ejecutar el comando crtmqm con la opcin -a. El grupo es un gupo de seguridad global o local. Es tpicamente un grupo de seguridad global, que es usado para suministrar administradores de cola multi-instancia con acceso a carpeta de datos y logs de un administrador de cola compartido. Usa el grupo de acceso de seguridad adicional para seleccionar permisos de lectura y escritura en la carpeta o ficheros de datos y logs contenidos en el administrador de cola compartido. El grupo de acceso de seguridad adicional es una alternativa a usar el grupo local mqm The additional security access group is an alternative to using the local group mqm to set permissions on the folder containing queue manager data and logs. Unlike the local group mqm, you can make the additional security access group a local or a global group. It must be a global group to set permissions on the shared folders that contain the data and log files used by multi-instance queue managers. Windows checks the access permissions to read and write queue manager data and log files. It checks the permissions of the user ID that is running queue manager processes. Which user ID is checked depends on whether you started the queue manager as a service or started it interactively. If you started the queue manager as a service, the user ID it checks is the one you configured with the "Prepare WebSphere MQ" wizard. If you started the queue manager interactively, it is the user ID that ran the strmqm command. The user ID must be a member of the local mqm group to start the queue manager. If the user ID is a member of the additional security access group, the queue manager can read and write files that are given permissions using the group. Restriction: Specify an additional security access group only on Windows. If you specify an additional security access group on other platforms, the crtmqm command returns an error. Texto descriptive para este administrador de cola. Puedes usar hasta 64 caracteres; por defecto es todo blancos. Si incluyes caracteres especiales, cierra la descripcin entre comillas. El mximo nmero de caracteres se reduce si el sistema usa el set de caracteres de byte-doble (DBCS). El nombre de la cola de transmission local donde son colocados mensajes remotes si una cola de transmisin no est definida explicitamente por su destino. No hay valor por defecto. El nombre del grupo conteniendo los miembros permitidos para: Ejecutar aplicaciones MQI Actualizar todos los recursos IPCC Cambiar los contenidos de algunos directories de administracin de cola Esta opcin se aplica solo para WebSphere MQ para AIX, Solaris, HP-UX, y Linux. El valor por defecto es -g all, que permite acceso no restringido. El valor -g ApplicationGroup es registrado en el fichero de configuracin del administrador de cola, qm.ini. EL ID de usuario mqm y el usuario ejecutando el commando deben estar en el Grupo de Aplicacin especificado. Para ms detalles de la operacin del modo restringido, consultar Modo Restringido. El mximo nmero de anales que cualquier otra aplicacin puede tener abiertos a la vez. Especifica un valor en el rango de 1 - 999999999. El valor por defecto es 256. Las siguientes 6 descripciones de parmetro relatan el Logeo, que est descrito en Usar el log para recuperacin. Nota: Elegir los arreglos de logeo con cuidado, ya que algunos no pueden ser cambiados despus de son confirmados. Use circular logging. This method is the default logging method. The directory used to store log files. The default directory to store log paths is defined when you install WebSphere MQ. If the volume containing the log file directory supports file security, the log file directory must have access permissions. The permissions must allow the user IDs, under which authority the queue manager runs, read and write access to the directory and its subdirectories. You grant the user IDs, and the mqm group, permissions on the default log directory when you install WebSphere MQ. If you set LogPath to write the log file to a different directory, you must grant the user IDs permission to read and write to the directory. The user ID and permissions are different for UNIX and Linux, and for Windows: UNIX and Linux
Parmetro
-a LocalGroup|Domain\ GlobalGroup|GlobalG roup@Domain
-c Text
-d DefaultTransmission Queue -g ApplicationGroup
-h MaximumHandleLimi t
-lc -ld LogPath
-lf LogFilePages
-ll -lp LogPrimaryFiles
-ls LogSecondaryFiles
-md DataPath
The directory, and subdirectories, must be owned by the user mqm in the group mqm. If the log file is shared between different instances of the queue manager, the security identifiers (sid) that are used, must be the same for the different instances. You must have set the user mqm to the same sid on the different servers running instances of the queue manager. Likewise for the group mqm. Windows If the directory is accessed by only one instance of the queue manager, you must give read and write access permission to the directory for the following groups and users: The local group mqm The local group Administrators The SYSTEM user ID To give different instances of a queue manager access to the shared log directory, the queue manager must access the log directory using a global user. Give the global group, which contains the global user, read and write access permission to the log directory. The global group is the additional security access group specified in the -a parameter. In WebSphere MQ for Windows systems, the default is C:\Program Files\IBM\WebSphere MQ\log (assuming that C is your data drive). If the volume supports file security, the SYSTEM ID, Administrators, and mqm group must be granted read/write access to the directory. In WebSphere MQ for UNIX and Linux systems, the default is /var/mqm/log. User ID mqm and group mqm must have full authorities to the log files. If you change the locations of these files, you must give these authorities yourself. This authorities are set automatically, if the log files are in their default locations. The log data is held in a series of files called log files. The log file size is specified in units of 4 KB pages. In WebSphere MQ for UNIX and Linux systems, the default number of log file pages is 4096, giving a log file size of 16 MB. The minimum number of log file pages is 64 and the maximum is 65 535. In WebSphere MQ for Windows systems, the default number of log file pages is 4096, giving a log file size of 16 MB. The minimum number of log file pages is 32 and the maximum is 65 535. Note: The size of the log files specified during queue manager creation cannot be changed for a queue manager. Usa logeo linear. The log files allocated when the queue manager is created. The minimum number of primary log files you can have is 2 and the maximum is 254 on Windows, or 510 on UNIX and Linux systems. The default is 3. The total number of primary and secondary log files must not exceed 255 on Windows, or 511 on UNIX and Linux systems, and must not be less than 3. Operating system limits can reduce the maximum log size. The value is examined when the queue manager is created or started. You can change it after the queue manager has been created. However, a change in the value is not effective until the queue manager is restarted, and the effect might not be immediate. For more information about primary log files, see What logs look like. To calculate the size of the primary log files, see Calculating the size of the log. The log files allocated when the primary files are exhausted. The minimum number of secondary log files is 1 and the maximum is 253 on Windows, or 509 on UNIX and Linux systems. The default number is 2. The total number of primary and secondary log files must not exceed 255 on Windows, or 511 on UNIX and Linux systems, and must not be less than 3. Operating system limits can reduce the maximum log size. The value is examined when the queue manager is started. You can change this value, but changes do not become effective until the queue manager is restarted, and even then the effect might not be immediate. For more information about the use of secondary log files, see What logs look like. To calculate the size of the secondary log files, see Calculating the size of the log. The directory used to hold the data files for a queue manager. In WebSphere MQ for Windows systems, the default is C:\Program Files\IBM\WebSphere MQ\qmgrs (assuming that C is your data drive). If the volume supports file security, the SYSTEM ID, Administrators, and mqm group must be granted read/write access to the directory. In WebSphere MQ for UNIX and Linux systems, the default is /var/mqm/qmgrs. User ID mqm and group mqm must have full authorities to the log files. The DataPath parameter is provided to assist in the configuration of multi-instance queue managers. For example on UNIX and Linux systems; if /var/mqm is located on a local file system, use DataPath and LogPath to point to the shared file systems accessible to multiple queue managers. Note: A queue manager created using DataPath parameter does run on versions of WebSphere MQ earlier than version 7.0.1, but it needs reconfiguring to remove the DataPath parameter from its configuration. You have two options to restore the queue
-q
-sa
-sax
-si
-ss
-t IntervalValue
-u DeadLetterQueue
-x MaximumUncommitt edMessages
-z
manager to a pre-version 7.0.1 configuration and run without the DataPath parameter. If you are confident about editing queue manager configurations, you can manually configure the queue manager using the Prefix queue manager configuration parameter. Alternatively, Stop the queue manager. Save the queue manager data and log directories. Delete the queue manager. Backout WebSphere MQ to the pre-v7.0.1 fix level. Create the queue manager with the same name. Replace the new queue manager data and log directories with the ones you saved. Makes this queue manager the default queue manager. The new queue manager replaces any existing default queue manager. If you accidentally use this flag and want to revert to an existing queue manager as the default queue manager, change the default queue manager as described in Making an existing queue manager the default. Automatic queue manager startup. For Windows systems only. The queue manager is configured to start automatically when the computer starts, or more precisely, when the WebSphere MQ Service starts. This is the default option if you create a queue manager from WebSphere MQ Explorer. Queue managers created in WebSphere MQ releases earlier than V7 retain their existing startup type. Automatic queue manager startup, permitting multiple instances. For Windows systems only. The queue manager is configured to start automatically when the computer starts, or more precisely, when the WebSphere MQ Service starts. If an instance of the queue manager is not already running elsewhere, the queue manager starts, the instance becomes active, and standby instances are permitted elsewhere. If a queue manager instance that permits standbys is already active on a different server, the new instance becomes a standby. Only one instance of a queue manager can run on a server. Queue managers created in WebSphere MQ releases earlier than V7.0.1 retain their existing startup type. Interactive (manual) queue manager startup. The queue manager is configured to start only when manually requested using the strmqm command. The queue manager then runs under the logged on (interactive) user. Queue managers configured with interactive startup end when the user who started them logs off. Service (manual) queue manager startup. A queue manager configured to start only when manually requested using the strmqm command. The queue manager then runs as a child of the service when the WebSphere MQ Service starts. Queue managers configured with service startup continue to run even after the interactive user has logged off. This is the default option if you create a queue manager from the command line. The trigger time interval in milliseconds for all queues controlled by this queue manager. This value specifies the time after receiving a trigger-generating message when triggering is suspended. That is, if the arrival of a message on a queue causes a trigger message to be put on the initiation queue, any message arriving on the same queue within the specified interval does not generate another trigger message. You can use the trigger time interval to ensure that your application is allowed sufficient time to deal with a trigger condition before it is alerted to deal with another on the same queue. You might choose to see all trigger events that happen; if so, set a low or zero value in this field. Specify a value in the range 0 through 999999999. The default is 999999999 milliseconds, a time of more than 11 days. Allowing the default to be used effectively means that triggering is disabled after the first trigger message. However, an application can enable triggering again by servicing the queue using a command to alter the queue to reset the trigger attribute. The name of the local queue that is to be used as the dead-letter (undeliveredmessage) queue. Messages are put on this queue if they cannot be routed to their correct destination. The default is no dead-letter queue. The maximum number of uncommitted messages under any one sync point. That is, the sum of: The number of messages that can be retrieved from queues The number of messages that can be put on queues Any trigger messages generated within this unit of work This limit does not apply to messages that are retrieved or put outside a sync point. Specify a value in the range 1 through 999999999. The default value is 10000 uncommitted messages. Suppresses error messages. This flag is used within WebSphere MQ to suppress unwanted error messages. Because
using this flag can result in loss of information, do not use it when entering commands on a command line.
2.7.5
Cd. Ret.
0 8 39 49 58 69 70 71 72 74 100 111
Cdigos de retorno
Descripcin
Administrador de cola definido Existe el administrador de cola Parmetro especificado no vlido Administrador de cola parado Detectado el uso inconsistente de intalaciones Asignacin no disponible Espacio de cola no disponible Error inexperado Error en nombre del Adminsitrador de cola name error The WebSphere MQ service is not started. Log location invalid Queue manager created. However, there was a problem processing the default queue manager definition in the product configuration file. The default queue manager specification might be incorrect. Invalid log size Permission denied (Windows only)
115 119
2.7.6
1.
Ejemplos
Este commando define un administrador de cola por defecto llamado Paint.queue.manager, con una descripcin corta de Paint shop, y define el sistema y objetos por defecto. Tambin especifica que Logeo linear es usado:
crtmqm -c "Paint shop" -ll -q Paint.queue.manager 2. Este commando define un administrador de cola por defecto llamado Paint.queue.manager, define el sistema y objetos por defecto, y pide dos ficheros de log primaries y tres secundarios: crtmqm -c "Paint shop" -ll -lp 2 -ls 3 -q Paint.queue.manager 3. Este commando define un administrador de cola llamado travel, define el sistema y objetos por defecto, selecciona el disparador a intervalos de 5000 milisegundos (o 5 segundos), y especifica SYSTEM.DEAD.LETTER.QUEUE como su cola dead-letter. crtmqm -t 5000 -u SYSTEM.DEAD.LETTER.QUEUE travel 4. This command creates a queue manager called QM1 on UNIX and Linux systems with its log and queue manager data folders in a common parent directory. The parent directory is to be shared on highly available networked storage to create a multi-instance queue manager. Before issuing the command, create /MQHA, /MQHA/logs and /MQHA/qmgrs owned by user and group mqm, and with permissions rwxrwxr-x. crtmqm -ld /MQHA/logs -md /MQHA/qmgrs QM1
2.7.7
strmqm endmqm dltmqm setmqm
Comando
Inicia administrador de cola Finaliza administrador de cola Borra administrador de cola Selecciona la instalacin asociada
Descripcin
2.8
dltmqinst
Borra entradas de instalacin del mqinst.ini en sistemas UNIX y Linux.
2.8.1
Propsito
El fichero mqinst.ini contiene informacin sobre las instalaciones WebSphere MQ en un sistema. Para ms informacin sobre mqinst.ini, consulta Installation configuration file, mqinst.ini.
2.8.2
Sintaxis
>>-dltmqinst----+- -p -InstallationPath----------------------------+--->< +- -n -InstallationName----------------------------+ | (1) | +- -p -InstallationPath-- -n -InstallationName-----+ | (1) | '- -n -InstallationName-- -p -InstallationPath-----' Notas: Cuando se especifican conjuntamente, el nombre de instalacin y ruta de instalacin deben referirse a la misma instalacin.
2.8.3
Parmetros
Descripcin
El nombre de la instalacin. La ruta de instalacin es la localizacin donde est instalado WebSphere MQ.
Parmetro
-n InstallationName -p InstallationPath
2.8.4
Cdigos de retorno
Cd. Ret.
0 5 36 44 59 71 89 96 98 131 Borrada la entrada sin error La entrada an est activa Argumentos suplidos no validos La entrada no existe Instalacin especificada no vlida Error inexperado Error en fichero INI No puede bloquear fichero INI Autoridad insuficiente para acceder a fichero INI Problema de Recursos
Descripcin
2.8.5
Ejemplo
Este commando borra una entrada con un nombre de instalacin de miInstalacion, y una ruta de instalacin de /opt/miInstalacion: dltmqinst -n MiInstalacion -p /opt/miInstalacion Nota: Slo puedes usar el comando dltmqinst en otra instalacin desde la que ests ejecutando. Si slo tienes una instalacin WebSphere MQ, el commando no trabajar.
2.9
dltmqm
Borra un administrador de cola.
2.9.1
Propsito
Usa el comando dltmqm para borrar un administrador de cola especificado y todos los objetos asociados con el. Antes de borrar un administrador de cola, debes borrar un administrador de cola, debes finalizarlo y usar el commando endmqm command. Debes usar el commando dltmqm desde la instalacin asociada con el administrador de cola con el que ests trabajando. Puedes encontrar que instalacin de un administrador de cola est asociada a el usando el comando dspmq -o installation. En para WebSphere MQ, es un error borrar un administrador de cola cuando estan abiertos los ficheros del administrador de cola. Si obtienes este error, cierra los ficheros y vuelve a emitir el comando.
2.9.2
Sintaxis
>>-dltmqm--+------+--QMgrName---------------------------------->< '- -z -'
2.9.3
Parmetro
QMgrName
Descripcin
El nombre del administrador de cola a borrar.
2.9.4
Parmetro
-z
Descripcin
Suprime mensajes de error.
2.9.5
Cdigos de retorno
Descripcin
Administrador de cola borrado Queue manager being created Queue manager running Queue manager does not exist A process that was using the previous instance of the queue manager has not yet disconnected. An error occurred while creating or checking the directory structure for the queue manager. Queue manager running as a standby instance. Queue manager could not obtain data lock. Administrador de cola borrado, however there was a problem removing it from Active Directory. An error occurred while deleting the directory structure for the queue manager. Queue manager stopping Inconsistencia de uso de instalaciones detectadas. The queue manager is associated with a different installation Storage not available Error inexperado Error en nombre de administrador de cola The WebSphere MQ service is not started. Log location invalid. Administrador de cola borrado. However, there was a problem processing the default queue manager definition in the product configuration file. The default queue manager specification might be incorrect.
Cd. Ret.
0 3 5 16 24 25 26 27 29 33 49 58 62 69 71 72 74 100 112
Cd. Ret.
119 Permission denied (Windows only).
Descripcin
2.9.6
Ejemplos
El siguiente commando borra el administrador de cola saturn.queue.manager.
dltmqm saturn.queue.manager El siguiente commando borra el administrador de cola viajes y tambin suprime cualquier mensaje producido por el comando. dltmqm -z travel
2.9.7
Notas de Uso
En WebSphere MQ para Windows, es un error borrar un administrador de cola cuando los ficheros del administrador de cola estn abiertos. Si obtienes este error, cierra los ficheros y vuelve a emitir el comando. Deleting a cluster queue manager does not remove it from the cluster. To check whether the queue manager you want to delete is part of a cluster, issue the command DIS CLUSQMGR(*). Then check whether this queue manager is listed in the output. If it is listed as a cluster queue manager you must remove the queue manager from the cluster before deleting it. See the related link for instructions. If you do delete a cluster queue manager without first removing it from the cluster, the cluster continues to regard the deleted queue manager as a member of the cluster for at least 30 days. You can remove it from the cluster using the command RESET CLUSTER on a full repository queue manager. Re-creating a queue manager with an identical name and then trying to remove that queue manager from the cluster does not result in the cluster queue manager being removed from the cluster. This is because the newly created queue manager, although having the same name, does not have the same queue manager ID (QMID). Therefore it is treated as a different queue manager by the cluster.
2.9.8
crtmqm strmqm endmqm
Comando
Inicia un administrador de cola Finaliza el administrador de cola
Descripcin
Define un administrador de cola
2.10
dmpmqaut
Volcar una lista de autorizaciones actuales para una serie de perfiles y tipos de objetos de WebSphere MQ.
2.10.1
Finalidad
Utilice el mandato dmpmqaut para realizar un volcado de las autorizaciones actuales para un objeto especificado.
2.10.2
Sintaxis
>>-dmpmqaut--+-------------------------+--+--------------+------> '- -m --NombreGestorColas-' +- -n --Perfil-+ +- -l ---------+ '- -a ---------' >--+------------------+--+--------------------------+----------->
'- -t --TipoObjeto-'
'- -s --ComponenteServicio-'
>--+-----------------------+--+------+------------------------->< +- -p --NombrePrincipal-+ +- -e -+ '- -g --NombreGrupo-----' '- -x -'
2.10.3
Descripcin
Realizar un volcado de los registros de autorizacin solamente para el gestor de colas especificado. Si omite este parmetro, solamente se realizar un volcado de los registros de autorizacin del gestor de colas predeterminado. El nombre del perfil para el que se debe realizar el volcado de autorizaciones. El nombre de perfil puede ser genrico, para lo que se utilizarn caracteres comodn que permiten especificar un rango de nombres, como se describe en el apartado Utilizacin de perfiles genricos del OAM en sistemas UNIX o Linux y Windows. Realizar un volcado solamente del nombre y del tipo de perfil. Utilice esta opcin para generar una lista concisa de todos los nombres y tipos de perfil definidos. Generar mandatos de establecimiento de autorizacin. El tipo de objeto para el que se debe realizar el volcado de autorizaciones. Los valores posibles son:
Parmetro
-m NombreGestorColas -n Perfil
-l -a -t TipoObjeto
Valor
authinfo
Descripcin
-s ComponenteServicio
-p NombrePrincipal
Un objeto de informacin de autenticacin, para utilizarlo con la seguridad de canal SSL (Secure Sockets Layer) channel o chl Un canal clntconn o clcn Un canal de conexin de cliente listener o lstr Un escucha namelist o nl Una lista de nombres process o prcs Un proceso queue o q Una cola o colas que coinciden con el parmetro de nombre de objeto qmgr Un gestor de colas rqmname o rqmn Un nombre de gestor de colas remoto service o srvc Un servicio topic o top Un tema Si hay soporte para servicios de autorizacin instalables, especifica el nombre del servicio de autorizacin para el que se realizar el volcado de autorizaciones. Este parmetro es opcional; si lo omite, la consulta de las autorizaciones se realiza en el primer componente instalable del servicio. Este parmetro slo se aplica a WebSphere MQ para Windows; los sistemas UNIX slo guardan registros de autorizacin de grupo. El nombre de un usuario para el que se han de volcar autorizaciones sobre el objeto especificado. El nombre del principal puede incluir opcionalmente un nombre de dominio, especificado con el formato siguiente:
ID_usuario@dominio
-g NombreGrupo Si desea ver ms informacin sobre la inclusin de nombres de dominio en el nombre de un principal, consulte el apartado Principales y grupos. El nombre del grupo de usuarios para el que se van a volcar las autorizaciones. Slo puede especificarse un nombre, que debe ser el nombre de un grupo de usuarios existente. Slo para WebSphere MQ para Windows, el NombreGrupo puede incluir opcionalmente un nombre de dominio, especificado con los formatos siguientes:
GroupName@domain domain\NombreGrupo
-e Mostrar todos los perfiles utilizados para calcular la autorizacin acumulativa que la entidad tiene para el objeto especificado en -n Perfil. La variable Perfil no debe contener carcter comodn. Tambin se deben especificar los siguientes parmetros: -m NombreGestorColas -n Perfil -t TipoObjeto y -p NombrePrincipal, o -g NombreGrupo. Mostrar todos los perfiles que tiene el mismo nombre que el especificado en -n Perfil. Esta opcin no se aplica al objeto QMGR, por lo que las peticiones de volcado con el formato dmpmqaut-m QM -t QMGR ... -x no son vlidas.
-x
2.10.4
Ejemplos
Los ejemplos siguientes muestran cmo se utiliza dmpmqaut para realizar un volcado de los registros de autorizacin de perfiles genricos: En este ejemplo se vuelcan todos los registros de autorizacin que tienen un perfil que coincide con la cola a.b.c del principal user1. dmpmqaut -m qm1 -n a.b.c -t q -p user1 El volcado resultante sera similar al siguiente: profile: a.b.* object type: queue entity: user1 type: principal authority: get, browse, put, inq Nota: Los usuarios de UNIX no pueden utilizar la opcin -p; en su lugar deben utilizar -g nombre_grupo. Este ejemplo se realiza un volcado de todos los registros de autorizacin que tienen un perfil que coincide con la cola a.b.c. dmpmqaut -m qmgr1 -n a.b.c -t q El volcado resultante sera similar al siguiente: profile: a.b.c object type: queue entity: Administrator type: principal authority: all - - - - - - - - - - - - - - - - profile: a.b.* object type: queue entity: user1 type: principal authority: get, browse, put, inq - - - - - - - - - - - - - - - - profile: a.** object type: queue entity: group1 type: group authority: get Este ejemplo se realiza un volcado de todos los registros de autorizacin para el perfil a.b.* de tipo queue. dmpmqaut -m qmgr1 -n a.b.* -t q El volcado resultante sera similar al siguiente: profile: a.b.* object type: queue entity: user1 type: principal authority: get, browse, put, inq Este ejemplo se realiza un volcado de todos los registros de autorizacin para el gestor de colas qmX. dmpmqaut -m qmX El volcado resultante sera similar al siguiente: profile: q1 object type: queue entity: Administrator type: principal authority: all - - - - - - - - - - - - - - - - profile: q* object type: queue entity: user1 type: principal authority: get, browse
- - - - - - - - - - - - - - - - profile: name.* object type: namelist entity: user2 type: principal authority: get - - - - - - - - - - - - - - - - profile: pr1 object type: process entity: group1 type: group authority: get Este ejemplo se realiza un volcado de todos los nombres de perfil y tipos de objeto para el gestor de colas qmX. dmpmqaut -m qmX -l El volcado resultante sera similar al siguiente: profile: q1, type: queue profile: q*, type: queue profile: name.*, type: namelist profile: pr1, type: process Nota: Slo para WebSphere MQ para Windows, todos los principales visualizados incluyen informacin de dominio, por ejemplo: profile: a.b.* object type: queue entity: user1@domain1 type: principal authority: get, browse, put, inq Cada clase de objeto tiene registros de autorizacin para cada grupo o principal. Estos registros tienen el nombre de perfil @CLASS y rastrean la autorizacin crt (crear) comn a todos los objetos de dicha clase. Si se cambia la autorizacin crt de algn objeto de esta clase, se actualiza el registro. Por ejemplo: profile: @class object type: queue entity: test entity type: principal authority: crt Esto muestra que los miembros del grupo test tienen autorizacin crt para la clase queue. Slo para WebSphere MQ para Windows, a los miembros del grupo "Administradores" se les asigna de forma predeterminada autorizacin total. Esta autorizacin, no obstante, la concede automticamente el OAM, y no se define en los registros de autorizacin. El mandato dmpmqaut muestra la autorizacin definida nicamente en los registros de autorizacin. Por lo tanto, a menos que se haya definido explcitamente un registro de autorizacin, al ejecutar el mandato dmpmqaut para el grupo de "Administradores" no se muestra ningn registro de autorizacin para dicho grupo.
2.11
dmpmqcfg
Use el commando dmpmqcfg para volcar la configuracin de un administrador de cola WebSphere MQ.
2.11.1
Propsito
Usa el commando dmpmqcfg para volcar la configuracin de admistradores de cola WebSphere MQ. >>-dmpmqcfg--+-----+--+----------------------------+------------> '- -?-' +- -c--DEFINE CHANNEL String-+ '- -c--default---------------' >--+------------------+--+-----+--+----------------+--+-----+---> | .- all----. | '- -a-' '- -s--SeqNumber-' '- -z-' '- -x--+---------+-'
+-object--+ +-authrec-+ +-chlauth-+ '-sub-----' >--+---------------------+--+-------------------+---------------> | .-*----------. | | .-all------. | '- -n--+------------+-' '- -t--+----------+-' '-ObjectName-' +-authinfo-+ +-channel--+ +-clntconn-+ +-comminfo-+ +-lstr-----+ '-namelist-' >--+--------------------+---------------------------------------> | .-mqsc------. | '- -o--+-----------+-' +-1line-----+ +-setmqaut--+ '-grtmqmaut-' >--+-------------------------------------+--+--------------+----> | .-SYSTEM.DEFAULT.MODEL.QUEUE-. | '- -r--RmtQMgr-' '- -q--+----------------------------+-' '-ReplyQueueName-------------' >--+---------------+------------------------------------------->< '- -m--QMgrName-'
2.11.2
Parmetro
-? -c
Descripcin
Pregunta el uso de mensaje para dmpmqcfg. Fuerza un modo de conexin cliente. Si el parmetro -c est cualificado con la opcin por defecto, es usado el proceso de conexin por defecto. Si -c es omitido, el valor por defecto es usado primeramente para intentar conectar al administrador de cola al usar servidores unidos y despus si este falla por clientes usados unidos. Si la opcin es cualificada con una cadena MQSC DEFINE CHANNEL CHLTYPE(CLNTCONN) entonces este es pasado y si tiene xito, usado para definir una conexin temporal al administrador de cola. Filter the definition procedure to show object definitions, authority records, channel authentication records, or durable subscriptions. The default value all is that all types are returned. Return object definitions to show all attributes. The default is to return only attributes which differ from the defaults for the object type. Reset channel sequence number for sender, server and cluster sender channel types to the numeric value specified. The value SeqNumber must be in the range 1 - 999999999. Activate silent mode in which warnings, such as those which appear when inquiring attributes from a queue manager of a higher command level are suppressed. Filter the definitions produced by object or profile name, the object/profile name may contain a single asterisk. The * option can be placed only at the end of the entered filter string Choose a single type of object for which to export. Possible values are:
-x [ all | object | authrec | chlauth | sub ] -a -sSeqNumber -z -n [ * | ObjectName ] -t
Valor
all authinfo channel o chl comminfo lstr o listener namelist o nl process o prcs queue o q qmgr srvc o service topic o top Los valores posibles son:
Descripcin
Todos los tipos de objeto Un objeto de informacin de autenticacin Un canal (incluido tipo de canal MQTT) Un objeto informacin de comunicaciones Un listener Un namelist Un proceso Una cola Un administrador de cola Un servicio Un tema
-o[ mqsc | 1line | setmqaut |
Valor
Descripcin
grtmqmaut ]
mqsc 1line setmqaut
-q -r
-m
Multi-line MQSC that can be used as direct input to runmqsc MQSC with all attributes on a single line for line diffing setmqaut statements for UNIX and Windows queue managers; valid only when -x authrec is specified grtmqmaut Linux only; generates iSeries syntax for granting access to the objects. The name of the reply-to queue used when getting configuration information. The name of the remote queue manager/transmit queue when using queued mode. If this parameter is omitted the configuration for the directly connected queue manager (specified with the -m parameter) is dumped. The name of the queue manager to connect to. If omitted the default queue manager name is used.
2.11.3
Autorizaciones
The user must have MQZAO_OUTPUT (+put) authority to access the command input queue (SYSTEM.ADMIN.COMMAND.QUEUE) and MQZAO_DISPLAY (+dsp) authority to access the default model queue (SYSTEM.DEFAULT.MODEL.QUEUE), to be able to create a temporary dynamic queue if using the default reply queue. The user must also have MQZAO_CONNECT (+connect) and MQZAO_INQUIRE (+inq) authority for the queue manager, and MQZAO_DISPLAY (+dsp) authority for every object that is requested.
2.12
dmpmqlog
Visualiza y formatea una porcin del Log del sistema WebSphere MQ.
2.12.1
Propsito
Use el commando dmpmqlog para volcar una version formateada del Log de sistema de WebSphere MQ a una salida estndar. El Log a ser volcado debe haber sido definido en el mismo tipo del sistema operativo que se usa inicialmente para emitir el comando. 2.12.2
Sintaxis
>>-dmpmqlog--+--------------------+--+--------------+-----------> +- -b ---------------+ '- -e --EndLSN-' +- -s --StartLSN-----+ '- -n --ExtentNumber-' >--+-------------------+--+----------------+------------------->< '- -f --LogFilePath-' '- -m --QMgrName-'
2.12.3
Parmetro
Descripcin
Use one of the following parameters to specify the log sequence number (LSN) at which the dump should start. If you omit this, dumping starts by default from the LSN of the first record in the active portion of the log. Start dumping from the base LSN. The base LSN identifies the start of the log extent that contains the start of the active portion of the log. Start dumping from the specified LSN. The LSN is specified in the format nnnn:nnnn:nnnn:nnnn. If you are using a circular log, the LSN value must be equal to or greater than the base LSN value of the log. Start dumping from the specified extent number. The extent number must be in the range 09 999 999. This parameter is valid only for queue managers using linear logging. End dumping at the specified LSN. The LSN is specified in the format nnnn:nnnn:nnnn:nnnn.
Dump start point
-b -s StartLSN
-n ExtentNumber
-e EndLSN
-f LogFilePath
-m QMgrName
The absolute (rather than relative) directory path name to the log files. The specified directory must contain the log header file (amqhlctl.lfh) and a subdirectory called active. The active subdirectory must contain the log files. By default, log files are assumed to be in the directories specified in the WebSphere MQ configuration information. If you use this option, queue names associated with queue identifiers are shown in the dump only if you use the -m option to name a queue manager name that has the object catalog file in its directory path. On a system that supports long file names this file is called qmqmobjcat and, to map the queue identifiers to queue names, it must be the file used when the log files were created. For example, for a queue manager named qm1, the object catalog file is located in the directory ..\qmgrs\qm1\qmanager\. To achieve this mapping, you might need to create a temporary queue manager, for example named tmpq, replace its object catalog with the one associated with the specific log files, and then start dmpmqlog, specifying -m tmpq and -f with the absolute directory path name to the log files. The name of the queue manager. If you omit this parameter, the name of the default queue manager is used. Note: Do not dump the log while the queue manager is running, and do not start the queue manager while dmpmqlog is running.
2.13
dspmq
Visualiza informacin sobre administradores de cola.
2.13.1
Propsito
Use el comando dspmq para visualizar nombres y detalles de los administradores de cola en un sistema.
2.13.2
Sintaxis
.- -s ----------------------. >>-dspmq--+----------------+--+---------------------------+-----> '- -m --QMgrName-' +- -o all ------------------+ | .-----------------------. | | V | | '---+-------------------+-+-' +- -o default ------+ +- -o installation -+ +- -o status -------+ '- -o standby ------' >--+-----+--+-----+--+-----+----------------------------------->< '- -x-' '- -n-' '- -a-'
2.13.3
Ninguno
2.13.4
Parmetro
-a
Descripcin
Displays information about the active queue managers only. A queue manager is active if it is associated with the installation from which the dspmq command was issued and one or more of the following statements are true: The queue manager is running A listener for the queue manager is running A process is connected to the queue manager The queue manager for which to display details. If you give no name, all queue manager names are displayed. Suppresses translation of output strings. The operational status of the queue managers is displayed. This parameter is the default
-m QMgrName -n -s
status setting. The parameter -o status is equivalent to -s. -o all The operational status of the queue managers is displayed, and whether any are the default queue manager. On Windows, UNIX and Linux, the installation name (INSTNAME), installation path (INSTPATH), and installation version (INSTVER) of the installation that the queue manager is associated with is also displayed. Displays whether any of the queue managers are the default queue manager. Windows, UNIX and Linux only. Displays the installation name (INSTNAME), installation path (INSTPATH), and installation version (INSTVER) of the installation that the queue manager is associated with. The operational status of the queue managers is displayed. Visualiza un administrador de cola actualmente permitido iniciando una instancia de reserve lista. Los posibles valores se muestran a continuacin:
-o default -o installation
-o status -o standby
Valor
Permitido No permitido No aplicable -x
Descripcin
El administrador de cola est ejecutndose y permitiendo instancias de reserva listas El administrador de cola est ejecutndose y no permite instancias de reserva listas El administrador de cola no est ejecutndose. Puedes iniciar el administrador de cola y esta instancia ya active si lo inicias con xito
Es visualizada informacin sobre instancias del administrador de cola. Los valores posibles se muestran a continuacin:
Valor
Active Standby
Descripcin
La instancia es la instancia active La instancia es una instancia de reserva lista.
2.13.5
Estados del Administrador de Cola

La siguiente lista muestra los diferentes estados que un administrador de cola puede tener:
Starting Running Running as standby Running elsewhere Quiescing Ending immediately Ending pre-emptively Ended normally Ended immediately Ended unexpectedly Ended pre-emptively Status not available
2.13.6
Cd. Ret.
0 36 58 71 72
Cdigos de retorno
Descripcin
Comando completado normalmente Argumentos suplidos no validos Inconsistencia de uso de instalaciones detectadas. Error inexperado Error en nombre de administrador de cola
2.13.7
1.
Ejemplos
El siguiente commando visuaiza los administradores de cola de este servidor:
dspmq o all 2. El siguiente commando visualiza informacin de reserve para administradores de cola en este servidor que han finalizado inmediatamente: dspmq o standby 3. El siguiente commando visualize informacin de reserve e informacin de instancia para administradores de cola en este servidor: dspmq o standby -x
2.14
dspmqaut
dspmqaut visualiza las autorizaciones de un objeto especfico WebSphere MQ object.
2.14.1
Propsito
Use el commando dspmqaut para visualizar las autorizaciones de un objeto especificado.
Si un ID de usuario es miembro de ms de un grupo, este commando visualiza las autorizaciones combinadas de todos los grupos. Slo puede ser especificado un grupo o principal. Para ms informacin sobre autoriazacin de componentes de servicio, consulta Installable services, Service components, y Authorization service interface.
2.14.2
Sintaxis
>>-dspmqaut--+----------------+-- -n --Profile------------------> '- -m --QMgrName-' >-- -t --ObjectType--+- -g --GroupName-----+--------------------> '- -p --PrincipalName-' >--+------------------------+---------------------------------->< '- -s --ServiceComponent-'
2.14.3
Parmetro
-n Profile
Descripcin
El nombre del perfil para el que visualizar autorizaciones. Las autorizaciones se aplican a todos los objetos WebSphere MQ con nombres que igualan al nombre especificado del perfil. El nombre del perfil puede ser generico, usando caracteres comodin para especificar un rango de nombres segn explicado en Using OAM generic profiles on UNIX or Linux systems and Windows. Este parmetro es necesario, a menos que visualices las autorizaciones de un administrador de cola. En este caso no debes incluirlo y en su lugar especificar el administrador de cola usando el parmetro m. El tipo de objeto para el cual se realiza la investigacin. Los posibles valores son:
-t ObjectType
Valor
authinfo channel chl clntconn clcn listener lstr namelist nl process prcs queue q qmgr rqmname rqmn service srvc
Descripcin
Un objeto de informacin de autenticacin, para usar con un canal seguro en Capa de Sockets Seguros (SSL) Un Canal Un canal de conexin cliente Un Listener Un nombre-de-lista Un proceso Una cola o colas que igualan al parmetro nombre de objeto Un administrador de cola Un nombre administrador de cola remota Un Servicio
topic top
Un Tema
2.14.4
-m QMgrName -g GroupName
Descripcin
The name of the queue manager on which to make the inquiry. This parameter is optional if you are displaying the authorizations of your default queue manager. The name of the user group on which to make the inquiry. You can specify only one name, which must be the name of an existing user group. For WebSphere MQ for Windows only, the GroupName can optionally include a domain name, specified in the following formats:
Parmetro
GroupName@domain domain\GroupName
-p PrincipalName The name of a user for whom to display authorizations to the specified object. For WebSphere MQ for Windows only, the name of the principal can optionally include a domain name, specified in the following format:
userid@domain
-s ServiceComponent For more information about including domain names on the name of a principal, see Principals and groups. If installable authorization services are supported, specifies the name of the authorization service to which the authorizations apply. This parameter is optional; if you omit it, the authorization inquiry is made to the first installable component for the service.
2.14.5
Parmetros retornados
Devuelve una lista de autorizacin, que puede contener ninguno, uno, o ms valores de autorizacin. Cada valor de autorizacin retornado significa que cualquier ID de usuario en el grupo especificado o principal tiene la autoridad de realizar la operacin definida por este valor. de objeto La siguiente tabla muestra las autoridades que pueden ser dadas para los diferentes tipos Tabla 1. Especificacin de autoridades para diferentes tipos de objetos
Autoridad Cola Proc. Admin. de cola Yes Yes Yes Yes Yes No Yes No Yes Yes No No Yes Yes No No No Yes No No No Yes Yes Yes No Yes Admin. de cola remota Yes No Yes Yes No No No No No No No No No No No No Yes No No No No No No No No No Nomb re-delista Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No No No No No No Tema Info Autor Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No No No No No No Clntcon n Yes Yes No Yes No No Yes No No Yes No No Yes Yes No No No No No No No No No No No No Canal Listener Servicio
all alladm allmqi none altusr browse chg clr connect crt ctrl ctrlx dlt dsp get pub put inq passall passid resume set setall setid sub system
Yes Yes Yes Yes No Yes Yes Yes No Yes No No Yes Yes Yes No Yes Yes Yes Yes No Yes Yes Yes No No
Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No Yes No No No No
Yes Yes Yes Yes No No Yes Yes No Yes Yes No Yes Yes No Yes Yes No Yes Yes Yes No Yes Yes Yes No
Yes Yes No Yes No No Yes No No Yes Yes Yes Yes Yes No No No No No No No No No No No No
Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No
Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No
La siguiente lista define las autorizaciones asociadas con cada valor: Autorizacin
all
Descripcin
Use all operations relevant to the object. all authority is equivalent to the union of the authorities alladm, allmqi, and system appropriate to the object type. Perform all administration operations relevant to the object Use all MQI calls relevant to the object Specify an alternative user ID on an MQI call Retrieve a message from a queue by issuing an MQGET call with the BROWSE option Change the attributes of the specified object, using the appropriate command set
alladm allmqi altusr browse chg
clr ctrl ctrlx connect crt dlt dsp get inq passall passid
Clear a queue (PCF command Clear queue only) or a topic Start, and stop the specified channel, listener, or service, and ping the specified channel. Reset or resolve the specified channel Connect the application to the specified queue manager by issuing an MQCONN call Create objects of the specified type using the appropriate command set Delete the specified object using the appropriate command set Display the attributes of the specified object using the appropriate command set Retrieve a message from a queue by issuing an MQGET call Make an inquiry on a specific queue by issuing an MQINQ call Pass all context Pass the identity context
pub
put
Publish a message on a topic using the MQPUT call.

Put a message on a specific queue by issuing an MQPUT call
resume
set setall setid
Resume a subscription using the MQSUB call.

Set attributes on a queue from the MQI by issuing an MQSET call Set all context Set the identity context
sub
system
Create, alter, or resume a subscription to a topic using the MQSUB call.

Use queue manager for internal system operations
Las autorizaciones para operaciones de administracin, donde estn soportadas, se aplican a este grupo de comandos: Comandos de Control Comandos MQSC Comandos PCF
2.14.6
Cd. Ret.
0 26 36 40 49 58 69 71 72 133 145 146 147 148 149
Cdigos de retorno
Descripcin
Operacin exitosa Queue manager running as a standby instance. Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Storage not available Error inexperado Error en nombre de administrador de cola Unknown object name Unexpected object name Object name missing Object type missing Invalid object type Entity name missing
2.14.7
Ejemplos
El siguiente ejemplo muestra un comando que visualiza las autorizaciones en el administrador de cola saturn.queue.manager asociado con el grupo de usuarios staff: dspmqaut -m saturn.queue.manager -t qmgr -g staff Los resultados de este commando son: Entity staff has the following authorizations for object: get browse put inq set connect altusr passid passall setid El siguiente ejemplo visualiza las autoridades user1 que tiene la cola a.b.c: dspmqaut -m qmgr1 -n a.b.c -t q -p user1 Los resultados de este comando son: Entity user1 has the following authorizations for object: get put
2.15
dspmqcsv
Es visualizado el estado del servidor de commandos
2.15.1
Propsito
Use el commando dspmqcsv para visualizar el estado del servidor de commando para el administrador de cola especificado. El estado puede ser uno de los siguientes: Iniciado
Ejecutado Ejecutado con SYSTEM.ADMIN.COMMAND.QUEUE sin actividad para gets Finalizado Parado
Debe usar el commando dspmqcsv desde la instalacin asociada al administrador de cola con el que ests trabajando. Puedes encontrar con que la instalacin de un administrador de cola est asociada a el usando el commando dspmq -o installation.
2.15.2
Sintaxis
>>-dspmqcsv--+----------+-------------------------------------->< '-QMgrName-'
2.15.3
Ninguno
2.15.4
Parmetro
QMgrName
Descripcin
The name of the local queue manager for which the command server status is being requested.
2.15.5
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
Comando completado normalmente Comando completado con resultados inexperados Ha ocurrido un error durante el proceso
2.15.6
Ejemplos
El siguiente comando visualize el estado del seervidor de comandos asociado con venus.q.mgr: dspmqcsv venus.q.mgr
2.15.7
Descripcin
Start a command server End a command server
Command
strmqcsv endmqcsv
2.16
dspmqfls
Visualiza los nombres de fichero correspondientes a objetos WebSphere MQ.
2.16.1
Propsito
Use el comando dspmqfls para visualizar el nombre del sistema de ficheros real de todos los objetos WebSphere MQ objects que igualan a un criterio especificado. Puedes usar este commando para identificar los ficheros asociados con un objeto en particular. Este comando es usado para realizar copia de seguridad de objetos especficos. Consulta Understanding WebSphere MQ file names para informacin sobre transformacin de nombre.
2.16.2
Syntax
>>-dspmqfls--+----------------+--+---------------+--------------> '- -m --QMgrName-' '- -t --ObjType-' >--GenericObjName----------------------------------------------><
2.16.3
Parmetro
Required parameters
Descripcin
The name of the object. The name is a string with no flag and is a required parameter. Omitting the name returns an error. This parameter supports an asterisk (*) as a wildcard at the end of the string.
GenericObjName
2.16.4
Parmetro
-m QMgrName -t ObjType
Optional parameters
Descripcin
El nombre del administrador de cola para el cual examiner ficheros. Si omites este nombre, el comando opera en el administrador de cola por defecto. El tipo-de-objeto. La lista siguiente muestra los tipos de objeto vlidos. El nombre abreviado es mostrado en primer lugar seguido por el nombre completo.
Valor
* o all authinfo channel o chl clntconn o clcn catalog o ctlg namelist o nl listener o lstr process o prcs queue o q qalias o qa qlocal o ql qmodel o qm qremote o qr qmgr service o srvc
Significado
Todos los tipos de objeto; este parmetro es por defecto. Authentication information object, for use with Secure Sockets Layer (SSL) channel security A channel A client connection channel An object catalog A namelist A listener A process A queue or queues matching the object name parameter An alias queue A local queue A model queue A remote queue A queue manager object A service
Notas: The dspmqfls command displays the name of the directory containing the queue, not the name of the queue itself. In WebSphere MQ for UNIX systems, you must prevent the shell from interpreting the meaning of special characters, for example, an asterisk (*). The way you do this depends on the shell you are using. It may involve the use of single quotation marks, double quotation marks, or a backslash.
2.16.5
Return codes
Cd. Ret.
0 10 20 Command completed normally Command completed but not entirely as expected An error occurred during processing
Descripcin
2.16.6
1.
Examples
El commando siguiente visualiza los detalles de todos los objetos con nombres que comienzan con SYSTEM.ADMIN definido en el administrador de cola por defecto.
dspmqfls SYSTEM.ADMIN* 2. El siguiente commando visualiza detalles de fichero para todos los procesos con nombres que comienzan con PROC definidos en el administrador de cola RADIUS. dspmqfls -m RADIUS -t prcs PROC*
2.17
UNIX).
dspmqinf
Visualiza informacin de configuracin WebSphere MQ (solo plataformas Windows y
2.17.1
Propsito
Use el comando dspmqinf para visualizar la informacin de configuracin WebSphere MQ.
2.17.2
Sintaxis
.- -s -QueueManager-. .- -o -stanza--. >>-dspmqinf -+-------------------+--+--------------+--StanzaName->< '- -s -StanzaType---' '- -o -command-'
2.17.3
Parmetro
StanzaName
Descripcin
The name of the stanza. That is, the value of the key attribute that distinguishes between multiple stanzas of the same type.
2.17.4
Parmetro
-s StanzaType -o stanza
Descripcin
The type of stanza to display. If omitted, the QueueManager stanza is displayed. The only supported value of StanzaType is QueueManager. Displays the configuration information in stanza format as it is shown in the .ini files. This format is the default output format. Use this format to display stanza information in a format that is easy to read. Displays the configuration information as an addmqinf command. Information about the installation associated with the queue manager is not displayed using this parameter. The addmqinf command does not require information about the installation. Use this format to paste into a command shell.
-o command
2.17.5
Cd. Ret.
0 39 44 58 69 71 72
Cdigos de retorno
Descripcin
Operacin exitosa Parmetros de lnea-de-comandos malos Stanza does not exist Inconsistencia de uso de instalaciones detectadas. Storage not available Error inexperado Error en nombre de administrador de cola
2.17.6
Ejemplos
dspmqinf QM.NAME El comando por defecto busca una estrofa QueueManager denominada QM.NAME y la visualize en format estrofa: QueueManager: Name=QM.NAME Prefix=/var/mqm Directory=QM!NAME DataPath=/MQHA/qmgrs/QM!NAME InstallationName=Installation1 El siguiente comando da el mismo resultado: dspmqinf s QueueManager o stanza QM.NAME El siguiente ejemplo visualize la salida en formato addmqinf. dspmqinf o command QM.NAME La salida est en esta lnea: addmqinf s QueueManager v Name=QM.NAME v Prefix=/var/mqm v Directory=QM!NAME v DataPath=/MQHA/qmgrs/QM!NAME
2.17.7
Notas de Uso
Use dspmqinf con addmqinf para definer una instancia de un administrador de cola multiinstancia en un servidor diferente. Para usar este comando debe ser administrador de WebSphere MQ administrator y un miembro del grupo mqm.
2.17.8
Descripcin
Add queue manager configuration information Remove queue manager configuration information
Command
addmqinf rmvmqinf
2.18
dspmqinst
Visualiza entradas de instalacin para mqinst.ini en UNIX, Linux, y Windows.
2.18.1
Propsito
El fichero mqinst.ini contiene informacin sobre todas las instalaciones de WebSphere MQ en un sistema. Para ms informacin sobre mqinst.ini, consultar Installation configuration file, mqinst.ini.
2.18.2
Sintaxis
>>-dspmqinst----+- -p -InstallationPath----------------------------+--->< +- -n -InstallationName----------------------------+ | (1) | +- -p -InstallationPath-- -n -InstallationName-----+ | (1) | '- -n -InstallationName-- -p -InstallationPath-----' Notas: Cuando se especifica conjuntamente, el nombre de instalacin y ruta de instalacin debe referirse a la misma instalacin.
2.18.3
Parmetros
Descripcin
El nombre de la instalacin. La ruta de la instalacin. Visualiza informacin de uso.
Parmetro
-n InstallationName -p InstallationPath ?
2.18.4
Cd. Ret.
0 36 44 59 71 89 96 131
Cdigos de retorno
Descripcin
Entry displayed without error Argumentos suplidos no validos La entrada no existe Instalacin especificada no vlida Error inexperado .Error en fichero INI Could not lock .ini file Resource problem
2.18.5
Ejemplos
Display details of all WebSphere MQ installations on the system:
dspmqinst Query the entry for the installation named Installation3: dspmqinst -n Installation3 Query the entry with an installation path of /opt/mqm: dspmqinst -p /opt/mqm Query the entry for the installation named Installation3. Its expected installation path is /opt/mqm: dspmqinst -n Installation3 -p /opt/mqm
2.19
dspmqrte
Determina la ruta que toma un mensaje en la red del gestor de colas.
2.19.1
Finalidad
La aplicacin de visualizacin de ruta de WebSphere MQ (dspmqrte) puede ejecutarse en todas las plataformas salvo en z/OS. Puede ejecutar la aplicacin de visualizacin de ruta de WebSphere MQ como un cliente para un gestor de colas de WebSphere MQ para z/OS, especificando el parmetro -c al emitir el mandato dspmqrte. Nota: Para ejecutar una aplicacin cliente para un gestor de colas de WebSphere MQ para z/OS, la caracterstica de conexin de clientes debe estar instalada. La aplicacin de visualizacin de ruta de WebSphere MQ genera y enva un mensaje de rastreo de ruta a una red de gestores de colas. Mientras el mensaje de rastreo de ruta se desplaza por la red de gestores de colas, se registra informacin sobre su actividad. Cuando el mensaje de rastreo de ruta llega a su cola de destino, la aplicacin de visualizacin de ruta de WebSphere MQ recopila la informacin de actividad y la muestra. Para obtener ms informacin y ejemplos del uso de la aplicacin de visualizacin de ruta de WebSphere MQ, consulte Aplicacin de visualizacin de ruta de WebSphere MQ.
2.19.2
Sintaxis
>>-dspmqrte--+------+-------------------------------------------> '- -c -' .-| Opciones de generacin |--------------------. >--+-----------------------------------------------+------------> '- -i --CorrelId--| Opciones de visualizacin |-' >-- -q --TargetQName--+----------------+----------------------->< '- -m --QMgrName-'
2.19.2.1
OPCIONES DE GENERACIN
|--+------------------+--+---------------+--+---------------+---> '- -ac --+-------+-' '- -d --Deliver-' '- -f --Forward-' '- -ar -' >--+-----------------------+--+------+--+----------------+------> | (1) | '- -o -' '- -p --Priority-' '- -l --Persistence-----' >--+-----------------------+--+-----------------------------+---> '- -qm --TargetQMgrName-' '- -ro --+- none -----------+-' | .-,------------. | | V | | '---ReportOption-+-' >--+------------------------------------------+-----------------> '- -rq --ReplyToQ--+---------------------+-' '- -rqm --ReplyToQMgr-' >--+------------------+--+--------------+-----------------------> '- -s --Activities-' '- -t --Detail-' >--+------------------+--+-------------------+------------------> '- -ts --SerieTema-' '- -xp --PassExpiry-' .-| Opciones de visualizacin |-. >--+---------------+--+-------------------------------+---------| '- -xs --Expiry-' | (2) | '--- -n ------------------------'
2.19.2.2
OPCIONES DE VISUALIZACIN
.- -v summary --------------------------------. |--+------+--+----------------------------------------------+---> '- -b -' '- -v --+- all ------------------------------+-' +- none -----------------------------+ '- outline --+---------------------+-' | .-,---------------. | | V | | '--- DisplayOption -+-' >--+----------------+-------------------------------------------| '- -w --WaitTime-' Notas: Si el parmetro Persistence se especifica como yes, y va acompaado de una solicitud de un mensaje de respuesta de rastreo de ruta (-ar), o de cualquier opcin de generacin de informe (-ro ReportOption), debe especificar el parmetro -rq ReplyToQ. La cola de respuestas no debe resolverse en una cola dinmica temporal. Si este parmetro va acompaado de una solicitud de un mensaje de respuesta de rastreo de ruta (-ar), o de cualquiera de las opciones de generacin de informe (ro ReportOption), debe especificarse una cola de respuestas (no modelo) especfica utilizando -rq ReplyToQ. De forma predeterminada, se solicitan mensajes de informe de actividad.
2.19.3
Parmetro
Descripcin
Si la aplicacin de visualizacin de ruta de WebSphere MQ se est utilizando para enviar un mensaje de rastreo de ruta a una red de gestores de colas, TargetQName especifica el nombre de la cola de destino. Si la aplicacin de visualizacin de ruta de WebSphere MQ se est utilizando para ver informacin de actividad recopilada anteriormente, TargetQName especifica el nombre de la cola donde est almacenada la informacin de actividad.
-q TargetQName
2.19.4
Parmetro
-c
Descripcin
Especifica que la aplicacin de visualizacin de ruta de WebSphere MQ se conecta como una aplicacin cliente. Para obtener ms informacin sobre cmo configurar mquinas cliente, consulte Instalacin de un cliente WebSphere MQ. Si no especifica este parmetro, la aplicacin de visualizacin de ruta de WebSphere no se conecta como una aplicacin cliente. Este parmetro se utiliza cuando la aplicacin de visualizacin de ruta de WebSphere MQ se utiliza solamente para visualizar informacin de actividad acumulada previamente. Puede haber muchos informes de actividad y mensajes de respuesta de rastreo de ruta en la cola especificada en -q TargetQName. IDCorrel se utiliza para identificar los informes de actividad, o un mensaje de respuesta de rastreo de ruta, relacionados con un mensaje de rastreo de ruta. Especifique el identificador de mensaje del mensaje de rastreo de ruta original en CorrelId. El formato de CorrelId es una serie hexadecimal de 48 caracteres. El nombre del gestor de colas al que se conecta la aplicacin de visualizacin de ruta de WebSphere MQ. El nombre puede tener hasta 48 caracteres como mximo. Si no especifica este parmetro, se utiliza el gestor de colas predeterminado. Los parmetros siguientes se utilizan cuando la aplicacin de visualizacin de ruta de WebSphere MQ se utiliza para enviar un mensaje de rastreo de ruta a una red de gestores de colas. Especifica que la informacin de actividad se debe acumular en el mensaje de rastreo de ruta. Si no especifica este parmetro, la informacin de actividad no se acumula en el mensaje de rastreo de ruta. Solicita que se genere un mensaje de respuesta de rastreo de ruta que contenga toda la informacin de actividad acumulada, en las siguientes situaciones: Un gestor de colas de WebSphere MQ Versin 7.0 descarta el mensaje de rastreo de ruta. Un gestor de colas de WebSphere MQ Versin 7.0 coloca el mensaje de rastreo de ruta en una cola local (cola de destino o cola de mensajes no entregados). El nmero de actividades realizadas en el mensaje de rastreo de ruta es superior al valor especificado en -s Activities. Para obtener ms informacin sobre los mensajes de respuesta de rastreo de ruta, consulte Referencia de mensaje de respuesta de ruta de rastreo. Si no especifica este parmetro, no se solicita un mensaje de respuesta de rastreo de ruta. Especifica si el mensaje de rastreo de ruta se ha de entregar en la cola de destino al llegar. Los posibles valores para Deliver son: yes Al llegar, el mensaje de rastreo de ruta se coloca en la cola de destino, aunque el gestor de colas no admita la mensajera de rastreo de ruta. no Al llegar, el mensaje de rastreo de ruta no se coloca en la cola de destino.
-i CorrelId
-m QMgrName
Opciones de generacin: -ac
-ar
-d Deliver
-f Forward
Si no especifica este parmetro, el mensaje de rastreo de ruta no se coloca en la cola de destino. Especifica el tipo de gestor de colas al que se puede reenviar el mensaje de rastreo de ruta. Los gestores de colas utilizan un algoritmo al decidir si van a enviar un mensaje a un gestor de colas remoto. Para obtener informacin detallada sobre este algoritmo, consulte El algoritmo de gestin de carga de trabajo del clster. Los valores posibles para Reenviar son: all El mensaje de rastreo de ruta se reenva a cualquier gestor de colas. Aviso: Si se reenva a un gestor de colas de WebSphere MQ anterior a la versin 6.0, el mensaje de rastreo de ruta no se
reconoce y puede entregarse en una cola local, a pesar del valor del parmetro -d Entregar. supported El mensaje de rastreo de ruta slo se reenva a un gestor de colas que acepte el parmetro Deliver del grupo PCF TraceRoute.
-l Persistence
-o
-p Priority
-qm TargetQMgrName
-ro none | ReportOption
Si no especifica este parmetro, el mensaje de rastreo de ruta slo se reenva a un gestor de colas que acepte el parmetro Deliver. Especifica la persistencia del mensaje de rastreo de ruta generado. Los posibles valores para Persistence son: Valor Descripcin yes El mensaje de rastreo de ruta generado es persistente. (MQPER_PERSISTENT). no El mensaje de rastreo de ruta generado no es persistente. (MQPER_NOT_PERSISTENT). q El mensaje de rastreo de ruta generado hereda su valor de persistencia de la cola especificada en -q NombColaDestino. (MQPER_PERSISTENCE_AS_Q_DEF). Un mensaje de respuesta de rastreo de ruta, o cualquier mensaje de informe, devuelto comparte el mismo valor de persistencia que el mensaje de rastreo de ruta original. Si Persistencia se especifica como yes, debe especificar el parmetro -rq ReplyToQ. La cola de respuestas no debe resolverse en una cola dinmica temporal. Si no especifica este parmetro, el mensaje de rastreo de ruta generado no es persistente. Indica que la cola de destino no est enlazada a un destino especfico. Por lo general, este parmetro se utiliza cuando el mensaje de rastreo de ruta debe transferirse a travs de un clster. La cola de destino se abre con la opcin MQOO_BIND_NOT_FIXED. Si no especifica este parmetro, la cola de destino se enlaza a un destino especfico. Especifica la prioridad del mensaje de rastreo de ruta. El valor de Priority es mayor que o igual a 0, o MQPRI_PRIORITY_AS_Q_DEF. MQPRI_PRIORITY_AS_Q_DEF indica que el valor de prioridad se toma de la cola especificada en -q TargetQMgrName. Si no especifica este parmetro, el valor de prioridad se toma de la cola especificada en -q NombColaDestino. Califica el nombre de la cola de destino; entonces se aplica la resolucin de nombres de gestor de colas normal. La cola de destino se especifica con -q TargetQMgrName. Si no especifica este parmetro, el gestor de colas al que est conectada la aplicacin de visualizacin de ruta de WebSphere MQ se utiliza como el gestor de colas de respuestas. La siguiente tabla muestra la descripcin de las opciones: Descripcin Especifica que no se ha establecido ninguna opcin de informe. Especifica las opciones de informe para el mensaje de rastreo de ruta. Se pueden especificar varias opciones de informe utilizando la coma como separador. Los valores posibles para OpcinInforme son: Activity Se establece la opcin de informe MQRO_ACTIVITY. coa Se establece la opcin de informe MQRO_COA_WITH_FULL_DATA. cod Se establece la opcin de informe MQRO_COD_WITH_FULL_DATA. exception Se establece la opcin de informe MQRO_EXCEPTION_WITH_FULL_DATA. expiration Se establece la opcin de informe MQRO_EXPIRATION_WITH_FULL_DATA. discard Se establece la opcin de informe MQRO_DISCARD_MSG. Si no se especifica -ro ReportOption ni -ro none, se especifican las opciones de informe MQRO_ACTIVITY y MQRO_DISCARD_MSG. Especifica el nombre de cola de respuestas a la que se envan todas las respuestas al mensaje de rastreo de ruta. Si el mensaje de rastreo de ruta es persistente, o si se especifica el parmetro -n, debe especificarse una cola de respuestas que no sea una cola dinmica temporal. Si no especifica este parmetro, la cola modelo predeterminada del sistema, SYSTEM.DEFAULT.MODEL.QUEUE, se utiliza como la cola de respuestas. La utilizacin de esta cola modelo provoca la creacin de una cola dinmica temporal para la aplicacin de visualizacin de ruta de WebSphere MQ. Especifica el nombre del gestor de colas donde est ubicada la cola de respuestas. El nombre puede tener hasta 48 caracteres como mximo. Si no especifica este parmetro, el gestor de colas al que est conectada la aplicacin de visualizacin de ruta de WebSphere MQ se utiliza como el gestor de colas de respuestas Especifica el nmero mximo de actividades registradas que se pueden realizar en nombre del mensaje de rastreo de ruta antes de que sea descartado. Este parmetro Valor none OpcinInforme
-rq ReplyToQ
-rqm ReplyToQMgr
-s Activities
impide que el mensaje de rastreo de ruta se reenve indefinidamente si cae en un bucle infinito. El valor de Activities es mayor que o igual a 1, o MQROUTE_UNLIMITED_ACTIVITIES. MQROUTE_UNLIMITED_ACTIVITIES especifica que se puede realizar un nmero ilimitado de actividades en nombre del mensaje de rastreo de ruta.
Si no especifica este parmetro, se puede realizar un nmero ilimitado de actividades en nombre del mensaje de rastreo de ruta.
-t Detail
Especifica las actividades que se registran. Los valores posibles para Detalle son: Valor Descripcin low Slo se registran las actividades realizadas por una aplicacin definida por el usuario. medium Se registran las actividades especificadas en low. Adems, se registran las actividades realizadas por los MCA. high Se registran las actividades especificadas en low y medium. Los MCA no exponen ninguna otra informacin de actividad en este nivel de detalle. Esta opcin est disponible para aplicaciones definidas por el usuario que slo van a exponer informacin de actividad adicional. Por ejemplo, si una aplicacin definida por el usuario determina la ruta que toma un mensaje considerando ciertas caractersticas del mensaje, la lgica de direccionamiento puede incluirse en este nivel de detalle. Si no especifica este parmetro, se registran las actividades de nivel medio. Especifica una serie de tema en la que la aplicacin de visualizacin de ruta de WebSphere MQ va a publicar un mensaje de rastreo de ruta, y coloca esta aplicacin en modalidad de tema. En esta modalidad, la aplicacin realiza un rastreo de todos los mensajes resultantes de la solicitud de publicacin. Especifica si la opcin de informe MQRO_DISCARD_MSG y el tiempo de caducidad restante del mensaje de rastreo de ruta se pasan al mensaje de respuesta de rastreo de ruta. Los posibles valores para PassExpiry son: Valor Descripcin yes La opcin de informe MQRO_PASS_DISCARD_AND_EXPIRY se especifica en el descriptor de mensaje del mensaje de rastreo de ruta. Si se genera un mensaje de respuesta de rastreo de ruta, o informes de actividad, para el mensaje de rastreo de ruta, la opcin de informe MQRO_DISCARD_MSG (si se especifica) y el tiempo de caducidad restante se pasan en el mensaje. Este parmetro es el valor predeterminado. no La opcin de informe MQRO_PASS_DISCARD_AND_EXPIRY no se especifica. Si se genera un mensaje de respuesta de rastreo de ruta para el mensaje de rastreo de ruta, la opcin discard y el tiempo de caducidad restante del mensaje de rastreo de ruta no se pasan en el mensaje. Si no especifica este parmetro, la opcin de informe MQRO_PASS_DISCARD_AND_EXPIRY no se especifica en el mensaje de rastreo de ruta. Especifica el tiempo de caducidad, en segundos, del mensaje de rastreo de ruta. Si no especifica este parmetro, el tiempo de caducidad se establece en 60 segundos. Especifica que la informacin de actividad devuelta para el mensaje de rastreo de ruta no se debe mostrar. Si este parmetro va acompaado de una solicitud de un mensaje de respuesta de rastreo de ruta, (-ar), o de cualquiera de las opciones de generacin de informe (-ro ReportOption), debe especificarse una cola de respuestas (no modelo) especfica utilizando -rq ReplyToQ. De forma predeterminada, se solicitan mensajes de informe de actividad. Cuando el mensaje de rastreo de ruta se ha colocado en la cola de destino especificada, se devuelve una serie hexadecimal de 48 caracteres que contiene el identificador de mensaje del mensaje de rastreo de ruta. La aplicacin de visualizacin de ruta de WebSphere MQ puede utilizar el identificador de mensaje para mostrar posteriormente la informacin de actividad para el mensaje de rastreo de ruta. Esto se puede efectuar mediante el parmetro -i IDCorrel. Si no especifica este parmetro, la informacin de actividad devuelta para el mensaje de rastreo de ruta se visualiza en el formato especificado en el parmetro -v.
-ts TopicString
-xp PassExpiry
-xs Expiry -n
2.19.4.1
OPCIONES DE VISUALIZACIN
Los parmetros siguientes se utilizan cuando la aplicacin de visualizacin de ruta de WebSphere MQ se utiliza para mostrar la informacin de actividad recopilada. Parmetro
-b
Descripcin
Especifica que la aplicacin de visualizacin de ruta de WebSphere MQ slo examina informes de actividad o un mensaje de respuesta de rastreo de ruta relacionado con un
-v summary | all | none | outline OpcinVisualizacin
-w TiempoEspera
mensaje. Este parmetro permite que la informacin de actividad se vuelva a visualizar ms adelante. Si no especifica este parmetro, la aplicacin de visualizacin de ruta de WebSphere MQ obtiene informes de actividad y los suprime, o bien un mensaje de respuesta de rastreo de ruta relacionado con un mensaje. Valor Descripcin summary Se visualizan las colas a travs de las cuales se ha direccionado el mensaje de rastreo de ruta. all Se visualiza toda la informacin disponible. none No se visualiza ninguna informacin. outline Especifica las opciones de visualizacin para el mensaje de OpcinVisualizacin rastreo de ruta. Se pueden especificar varias opciones de visualizacin utilizando la coma como separador. Si no se proporciona ningn valor, se visualiza la informacin siguiente: El nombre de la aplicacin El tipo de cada operacin Cualquier parmetro especficos de operacin Los valores posibles para OpcinVisualizacin son: activity: Se visualizan todos los parmetros de grupo no PCF en los grupos PCF Actividad. identifiers: Se visualizan los valores que tienen los identificadores de parmetro MQBACF_MSG_ID o MQBACF_CORREL_ID. Este valor prevalece sobre msgdelta. message: Se visualizan todos los parmetros de grupo no PCF en los grupos PCF Mensaje. Cuando se especifica este valor, no se puede especificar msgdelta. msgdelta: Se visualizan todos los parmetros de grupo no PCF en los grupos PCF Mensaje que han cambiado desde la ltima operacin. Cuando se especifica este valor, no se puede especificar mensaje. operation: Se visualizan todos los parmetros de grupo no PCF en los grupos PCF de Operacin. traceroute: Se visualizan todos los parmetros de grupo no PCF en los grupos PCF TraceRoute. Si no especifica este parmetro, se visualiza un resumen de la ruta de mensajes. Especifica el tiempo, en segundos, que la aplicacin de visualizacin de ruta de WebSphere MQ espera a que los informes de actividad, o un mensaje de rastreo de ruta, vuelvan a la cola de respuestas especificada. Si no especifica este parmetro, el tiempo de espera se especifica como el tiempo de caducidad del mensaje de rastreo de ruta, ms 60 segundos.
2.19.5
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
Mandato completado con normalidad Se han suministrado argumentos no vlidos Se ha producido un error durante el proceso
2.19.6
Ejemplos
El mandato siguiente enva un mensaje de rastreo de ruta a una red de gestores de colas con la cola de destino especificada como TARGET.Q. Siempre que los gestores de colas de la ruta estn habilitados para el registro de actividad, se generan informes de actividad. En funcin del atributo del gestor de colas, ACTIVREC, los informes de actividad se entregan a la cola de respuestas ACT.REPORT.REPLY.Q o a una cola del sistema. El mensaje de rastreo de ruta se descarta cuando llega a la cola de destino. dspmqrte -q TARGET.Q -rq ACT.REPORT.REPLY.Q Siempre que se entregue uno o ms informes de actividad a la cola de respuestas, ACT.REPORT.REPLY.Q, la aplicacin de visualizacin de ruta de WebSphere MQ ordena y muestra la informacin de actividad.
El mandato siguiente enva un mensaje de rastreo de ruta a una red de gestores de colas con la cola de destino especificada como TARGET.Q. Se acumula informacin sobre la actividad dentro del mensaje de ruta de rastreo, pero no se generan informes de actividad. El mensaje de rastreo de ruta se descarta cuando llega a la cola de destino. En funcin del valor del atributo del gestor de colas de destino, ROUTEREC, se puede generar y entregar un mensaje de respuesta de rastreo de ruta a la cola de respuestas TRR.REPLY.TO.Q o a una cola del sistema. dspmqrte -ac -ar -ro discard -rq TRR.REPLY.TO.Q -q TARGET.Q Siempre que se genere un mensaje de respuesta de rastreo de ruta, y se entregue a la cola de respuestas TRR.REPLY.TO.Q, la aplicacin de visualizacin de ruta de WebSphere MQ ordena y muestra la informacin de actividad que estaba acumulada en el mensaje de rastreo de ruta. Para obtener ms ejemplos del uso de la aplicacin de visualizacin de ruta de WebSphere MQ y su salida, consulte Ejemplos de la aplicacin de visualizacin de ruta de WebSphere MQ.
2.20
dspmqspl
Use el commando dspmqspl para visualizar una lista de todas las polticas y detalles de una poltica determinada.
2.20.1
Sintaxis
>>-dspmqspl-- -m -QMgrName--+-----------------+--+----------+-->< '- -p -PolicyName-' '- -export-' Table 1. dspmqspl command flags.
Seal de Comando -m -p -export Nombre de Poltica. Aadir esta seal genera salida que puede ser aplicada a un administrador de cola diferente. Explicacin Nombre del administrador de Cola (mandato).
2.21
dspmqtrc
Formatea y visualiza el trazado de WebSphere MQ (solo plataformas Unix).
2.21.1
Propsito
El commando dspmqtrc est soportado en sistemas UNIX solamente. Usa el comando dspmqtrc para visualizar salida de traza formateada WebSphere MQ. Los ficheros de traza SSL ejecutables tienen los nombres AMQ.SSL.TRC y AMQ.SSL.TRC.1. No puedes formatear cualquiera de los ficheros de traza SSL. Los ficheros de traza SSL son ficheros binaries y, si estn transferidos para IBM suportados por FTP, deben ser transferidos en modo de transferencia binarios.
2.21.2
Sintaxis
>>-dspmqtrc--+----------------------+--+-----+--+-----+---------> '- -t --FormatTemplate-' '- -h-' '- -s-' >--+----------------------+--InputFileName--------------------->< '- -o --OutputFilename-'
2.21.3
Parmetro
InputFileName
Descripcin
El nombre del fichero conteniendo la traza no formateada, por ejemplo: /var/mqm/trace/AMQ12345.01.TRC If you provide one input file, dspmqtrc formats it either to stdout or to the output file you name. If you provide more than one input file, any output file you name is ignored, and formatted files are named AMQyyyyy.zz.FMT, based on the PID of the trace file.
2.21.4
Parmetro
Descripcin
The name of the template file containing details of how to display the trace. If this parameter is not supplied, the default template file location is used: For AIX systems, the default value is as follows:
-t FormatTemplate
MQ_INSTALLATION_PATH/lib/amqtrc2.fmt
For all UNIX systems other than AIX systems, the default value is as follows:
MQ_INSTALLATION_PATH/lib/amqtrc.fmt
-h -s -o output_filename MQ_INSTALLATION_PATH represents the high-level directory in which WebSphere MQ is installed. Omit header information from the report. Extract trace header and put to stdout. The name of the file into which to write formatted data.
2.21.5
Descripcin
End trace Start trace
Comando
endmqtrc strmqtrc
2.22
dspmqtrn
Visualiza transacciones completas en byte-doble y heursticamente.
2.22.1
Propsito
Use el commando dspmqtrn para visualizar detalles de transacciones. Este commando incluye transacciones coordinadas por WebSphere MQ y por administrador de transaccin externo.
2.22.2
Sintaxis
>>-dspmqtrn--+-----+--+-----+--+-----+--+-----+--+-----+--------> '- -e-' '- -h-' '- -i-' '- -a-' '- -q-' >--+--------------+-------------------------------------------->< '- -m QMgrName-'
2.23 Parmetros opcionales

Parmetro
-e
Descripcin
Requests details of externally coordinated, in-doubt transactions. Such transactions are those for which WebSphere MQ has been asked to prepare to commit, but has not yet been informed of the transaction outcome. Requests details of externally coordinated transactions that were resolved by the command, and the external transaction coordinator has yet to acknowledge with an
-h
rsvmqtrn xa-
forget command. This transaction state is termed heuristically completed by X/Open.

Note: If you do not specify -e, -h, or i, details of both internally and externally coordinated
-i
-a
in-doubt transactions are displayed, but details of externally coordinated, heuristically completed transactions are not displayed. Requests details of internally coordinated, in-doubt transactions. Such transactions are those for which each resource manager has been asked to prepare to commit, but WebSphere MQ has yet to inform the resource managers of the transaction outcome. Information about the state of the transaction in each of its participating resource managers is displayed. This information can help you assess the affects of failure in a particular resource manager. Note: If you do not specify -e or -i, details of both internally and externally coordinated indoubt transactions are displayed. Requests a list of all transactions known to the queue manager. The returned data includes transaction details for all transactions known to the queue manager. If a transaction is currently associated with a WebSphere MQ application connection, information related to that WebSphere MQ application connection is also returned. The data returned by this command might typically be correlated with the output of a runmqsc DISPLAY CONN command, and the output fields have the same meaning as in that command. Not all of the fields are appropriate for all transactions. When the fields are not meaningful, they are displayed as blank. For example: The UOWLOG value when the command is issued against a circular logging queue manager. Specifying this parameter on its own is the same as specifying
-q
-a -q.
-mQMgrName
Displays all the data from the -a parameter and a list of up to 100 unique objects updated within the transaction. If more than 100 objects are updated in the same transaction, only the first 100 distinct objects are listed for each transaction. The name of the queue manager for which to display transactions. If you omit the name, the transaction of the default queue manager are displayed.
2.23.1
Cd. Ret.
0 26 36 40 49 58 69 71 72 102
Cdigos de retorno
Descripcin
Operacin exitosa Queue manager running as a standby instance. Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Storage not available Error inexperado Error en nombre de administrador de cola No transactions found
2.23.2
Descripcin
Resolve transaction
Command
rsvmqtrn
2.24
dspmqver
Visualiza versin e informacin de construccin WebSphere MQ.
2.24.1
Propsito
Use el commando dspmqver para visualizar la version e informacin de construccin de WebSphere MQ. Por defecto, el comando dspmqver visualize detalles de instalacin desde donde es llamado. Si existen otras instalaciones es visualizada una nota; usa el parmetro i para visualizar sus detalles.
2.24.2
Sintaxis
>>-dspmqver-----------------------------------------------------> >--+-+------+--+------------------+--+--------------+--+-----+--+-----+-+->< | '- -a -' '- -p --components-' '- -f --fields-' '- -b-' '- -v-' | '- -i----------------------------------------------------------------'
2.24.3
Parmetro
-a -p Components
Descripcin
Display information about all fields and components. Display information for the components specified by component. Either a single component or multiple components can be specified. Enter either the value of a single component or the sum of the values of all the required components. Available components and related values follow: Valor 1 2 4 8 161 32 Descripcin WebSphere MQ server, o cliente. Clases WebSphere MQ para Java. Clases WebSphere MQ para Servicio de Mensaje Java WebScale Distribution Hub IBM WebSphere MQ custom channel for Windows Communication Foundation IBM Message Service Client for .NET (XMS .NET) - this component is only available on Windows GSKit WebSphere MQ Advanced Message Security
-f Campos
64 128 Notas: Supported by WebSphere MQ for Windows only. If you have not installed Microsoft .NET 3 or later, the following error message is displayed: Title: WMQWCFCustomChannelLevel.exe - Application Error The application failed to initialize properly (0x0000135). The default value is 1. Visualiza informacin para los campos especificados por campo. O bien especifica un campo simple o multiples campos. O bien introduce el valor de un campo simple o la suma de los valores de todos los campos necesarios. Los campos disponibles y valores detallados on los siguientes: Valor Descripcin 1 Nombre 2 Versin, en el formato V.R.M.F: Donde V=Versin, R=Revisin, M=Modificacin, y F=Pack de Fijado 4 Nivel 8 Tipo de Construccin 16 Plataforma 32 Modo de direccionamiento 64 Sistema operative 128 Ruta de instalacin 256 Descripcin de instalacin 512 Nombre de Instalacin 1024 Mximo nivel de comando 2048 Instalacin primaria 4096 Ruta de dato
-b -v -i
Information for each selected field is displayed on a separate line when the dspmqver command is run. The default value is 8191. This displays information for all fields. Omit header information from the report. Display verbose output. Display information about all installations. You cannot use this option with other options. The installation from which the dspmqver command was issued is displayed first. For any other installations, only the following fields are displayed: Name, Version, Installation name, Installation description, Installation path, and Primary installation.
2.24.4
Cd. Ret.
0
Cdigos de retorno
Descripcin
Comando completado normalmente.
Cd. Ret.
10 20
Descripcin
Comando completado con resultados inexperados. Ha ocurrido un error durante el proceso.
2.24.5
Ejemplos
The following command displays WebSphere MQ version and build information, using the default settings for -p and -f : dspmqver The following command displays information about all fields and components and is the equivalent of specifying dspmqver -p 63 -f 4095: dspmqver -a The following command displays version and build information for the WebSphere MQ classes for Java: dspmqver -p 2 The following command displays the Common Services for Java Platform Standard Edition, IBM WebSphere MQ, Java Message Service Client, and WebSphere MQ classes for Java Message Service: dspmqver -p 4 The following command displays the build level of the WebScale Distribution Hub: dspmqver -p 8 -f 4 El siguiente commando visualize el nombre y tipo de contruccin para canal personalidado IBM WebSphere MQ de Windows Communication Foundation: dspmqver -p 16 -f 9 The following command displays information about installations of WebSphere MQ. dspmqver -i
2.24.6
Fallo de Comando
The dspmqver command can fail if you try to view version or build information for the WebSphere MQ classes for Java, and you have not correctly configured your environment. For example, you might see the following message: [root@blade883 ~]# dspmqver -p2 AMQ8351: WebSphere MQ Java environment has not been configured correctly. To resolve this problem, ensure that the path is configured to include the JRE, and that the correct environment variables are set; for example, by using setjmsenv or setjmsenv64. For example: export PATH=$PATH:/opt/mqm/java/jre/bin cd /opt/mqm/java/bin/ . ./setjmsenv64 [root@blade883 bin]# dspmqver -p2 Name: WebSphere MQ classes for Java Version: 7.1.0.0 Level: k000-L110908 Build Type: Production
2.25
endmqcsv
Detiene el servidor de commando para un administrador de cola.
2.25.1
Propsito
Use el comando endmqscv para parar el servidor de comando en un administrador de cola especificado.
Debe usar el comando endmqscv desde la instalacin asociada con el administrador de cola con el que est trabajando. Puede buscar que instalacin del administrador de cola est asociado con el usando el comando dspmq -o installation. Si el atributo administrador de cola, SCMDSERV, es especificado como QMGR entonces cambiar el estado del servidor de comando usando endmqscv no tiene efecto segn actual el administrador de cola hasta que el atributo SCMDSERV se restaura la siguiente vez.
2.25.2
Sintaxis
.- -c -. >>-endmqcsv--+------+--QMgrName-------------------------------->< '- -i -'
2.25.3
Parmetro
QMgrName
Descripcin
The name of the queue manager for which to end the command server.
2.25.4
Parmetro
-c
Descripcin
Para el servidor de commando en una forma controlada. El servidor de commando puede completer el proceso de cualquier mensaje de commando que ya est iniciado. No se leen nuevos mensajes en la cola de comandos. Es el parmetro por defecto Para el servidor de commando inmediatamente. Las acciones asociadas con un mensaje de commando en proceso actual no se completarn.
-i
2.25.5
Cdigos de retorno
Descripcin
Cd. Ret.
0 10 20
2.25.6
Ejemplos
command stops the command server on queue manager
The following saturn.queue.manager:
endmqcsv -c saturn.queue.manager The command server can complete processing any command it has already started before it stops. Any new commands received remain unprocessed in the command queue until the command server is restarted. The following command stops the command server on queue manager pluto immediately: endmqcsv -i pluto
2.25.7
Command
strmqcsv dspmqcsv Start a command server Display the status of a command server
Descripcin
2.26
endmqlsr
Finaliza todos los procesos listener para un administrador de cola.
2.26.1
Propsito
El comando endmqlsr finalize todos los procesos listener para un administrador de cola especificado. Debe usar el commando endmqlsr desde la instalacin asociada con el administrador de cola que est trabajando. Puede buscar qu administrador de cola est asociada a la instalacin usando el comando dspmq -o installation. You do nothave to stop the queue manager before issuing the endmqlsr command. If any of the listeners are configured to have inbound channels running within the runmqlsr listener process, rather than within a pool process, the request to end that listener might fail if channels are still active. In this case a message is written indicating how many listeners were successfully ended and how many listeners are still running. If the listener attribute, CONTROL, is specified as QMGR then changing the state of the listener using endmqlsr does not effect how the queue manager acts upon the CONTROL attribute at the next restart.
2.26.2
Sintaxis
>>-endmqlsr--+------+--+----------------+---------------------->< '- -w -' '- -m --QMgrName-'
2.26.3
Parmetro
-m QMgrName -w
Descripcin
The name of the queue manager. If you omit this parameter, the command operates on the default queue manager. Wait before returning control. Control is returned to you only after all listeners for the specified queue manager have stopped.
2.26.4
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
2.27
endmqdnm
Para el monitor .NET para una cola (solo Windows).
2.27.1
Propsito
Nota: El commando endmqdnm se aplica solo a WebSphere MQ para Windows. Use el commando de control endmqdnm para parar un monitor .NET.
2.27.2
Sintaxis
>>-endmqdnm-- -q --QueueName--+----------------+---------------><
'- -m --QMgrName-'
2.27.3
Parmetro
-q QueueName
Descripcin
El nombre de la aplicacin de cola que el monitor .NET est monitorizando.
2.27.4
Parmetro
-m QMgrName
Descripcin
The name of the queue manager that hosts the application queue. If omitted, the default queue manager is used.
2.27.5
Cd. Ret.
0 36 40 58 71 72 133
Cdigos de retorno
Descripcin
Operacin exitosa Argumentos suplidos no validos Queue manager not available Inconsistencia de uso de instalaciones detectadas. Error inexperado Error en nombre de administrador de cola Unknown object name error
2.28
endmqm
Para el administrador de cola o cambia a un administrador de cola de reserva.
2.28.1
Propsito
Use el comando endmqm para finalizar (parar) un administrador de cola especificado. Este comando para un administrador de cola en uno de estos tres modos: Controlled or quiesced shutdown Immediate shutdown Pre-emptive shut down
El comando endmqm para todas las instancias de un administrador de cola multi-instancia en la misma forma que para un instancia simple del administrador de cola. Puedes emitir el commando endmqm bien en la instancia active, o una de las instancias de reserve listas de un administrador de cola multi-instancia. Debes emitir endmqm en la instancia activa para finalizar el administrador de cola. If you issue the endmqm command on the active instance of a multi-instance queue manager, you can permit a standby instance to switch over to being the new active instance when the current active instance completes its shutdown. If you issue the endmqm command on a standby instance of a multi-instance queue manager, you can end the standby instance by adding the -x option, and leave the active instance running. The queue manager reports an error if you issue endmqm on the standby instance without the -x option. Issuing the endmqm command will affect any client application connected through a server-connection channel. The effect varies depending on the parameter used, but it is as though a STOP CHANNEL command was issued in one of the three possible modes. See Stopping channels, for information about the effects of STOP CHANNEL modes on server-connection channels. The endmqm optional parameter descriptions state which STOP CHANNEL mode they will be equivalent to.
If you issue endmqm to stop a queue manager, reconnectable clients do not try to reconnect. To override this behavior, specify either the -r or -s option to enable clients to start trying to reconnect. Nota: If a queue manager or a channel ends unexpectedly, reconnectable clients start trying to reconnect. Nota: The client might not reconnect to this queue manager. Depending on the MQCONNX reconnect option the client has used, and the definition of the queue manager group in the client connection table, the client might reconnect to a different queue manager. You can configure the client to force it to reconnect to the same queue manager. You must use the endmqm command from the installation associated with the queue manager that you are working with. You can find out which installation a queue manager is associated with using the dspmq -o installation command. The attributes of the queue manager and the objects associated with it are not affected by the endmqm command. You can restart the queue manager using the strmqm (Start queue manager) command. To delete a queue manager, stop it and then use the dltmqm (Delete queue manager) command.
2.28.2
Sintaxis
.- -c -. >>-endmqm--+------+--+-+------+--+------+-+--QMgrName---------->< '- -z -' | +- -w -+ +- -s -+ | | +- -i -+ '- -r -' | | '- -p -' | '- -x ---------------'
2.28.3
Parmetro
QMgrName
Descripcin
El nombre del administrador de cola de mensaje a ser parado.
2.28.4
Parmetro
-c
Descripcin
Controlled (or quiesced) shutdown. This parameter is the default. The queue manager stops, but only after all applications have disconnected. Any MQI calls currently being processed are completed. In the unlikely event that a dspmq command is issued in the small timeframe between the applications disconnecting and the queue manager actually stopping, the dspmq command might transiently report the status as Ending immediately, even though a controlled shutdown was requested. Control is returned to you immediately and you are not notified of when the queue manager has stopped. The effect on any client applications connected through a server-connection channel is equivalent to a STOP CHANNEL command issued in QUIESCE mode. Immediate shutdown. The queue manager stops after it has completed all the MQI calls currently being processed. Any MQI requests issued after the command has been issued fail. Any incomplete units of work are rolled back when the queue manager is next started. Control is returned after the queue manager has ended. The effect on any client applications connected through a server-connection channel is equivalent to a STOP CHANNEL command issued in FORCE mode. Pre-emptive shutdown. Use this type of shutdown only in exceptional circumstances. For example, when a queue manager does not stop as a result of a normal endmqm command. The queue manager might stop without waiting for applications to disconnect or for MQI calls to complete. This can give unpredictable results for WebSphere MQ applications. The shutdown mode is set to immediate shutdown. If the queue manager has not stopped after a few seconds, the shutdown mode is escalated, and all remaining queue manager processes are stopped.
-i
-p
The effect on any client applications connected through a server-connection channel is equivalent to a STOP CHANNEL command issued in TERMINATE mode. -r Start trying to reconnect reconnectable clients. This parameter has the effect of reestablishing the connectivity of clients to other queue managers in their queue manager group. Switch over to a standby queue manager instance after shutting down. The command checks that there is a standby instance running before ending the active instance. It does not wait for the standby instance to start before ending. Connections to the queue manager are broken by the active instance shutting down. Reconnectable clients start trying to reconnect. You can configure the reconnection options of a client to reconnect only to another instance of the same queue manager, or to reconnect to other queue managers in the queue manager group. Wait shutdown. This type of shutdown is equivalent to a controlled shutdown except that control is returned to you only after the queue manager has stopped. You receive the message Waiting for queue manager qmName to end while shutdown progresses. In the unlikely event that a dspmq command is issued in the small timeframe between the applications disconnecting and the queue manager actually stopping, the dspmq command might transiently report the status as Ending immediately, even though a controlled shutdown was requested. The effect on any client applications connected through a server-connection channel is equivalent to a STOP CHANNEL command issued in QUIESCE mode. End a standby instance of the queue manager, without ending the active instance of the queue manager. Suppresses error messages on the command.
-s
-w
-x
-z
2.28.5
Cd. Ret.
0 3 16 40 49 58 62 69 71 72 77 79 90 119
Cdigos de retorno
Descripcin
Queue manager ended Queue manager being created Queue manager does not exist Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. The queue manager is associated with a different installation Storage not available Error inexperado Error en nombre de administrador de cola WebSphere MQ queue manager cannot switch over Active instance of WebSphere MQ queue manager QmgrName not ended Standby instance of WebSphere MQ queue manager QmgrName not ended Permission denied
2.28.6
Ejemplos
ejemplo muestra comandos que paran los administradores de cola
El siguiente especificados.
This command ends the queue manager named mercury.queue.manager in a controlled way. All applications currently connected are allowed to disconnect. endmqm mercury.queue.manager This command ends the queue manager named saturn.queue.manager immediately. All current MQI calls complete, but no new ones are allowed. endmqm -i saturn.queue.manager
Los resultados de emitir el commando endmqm en la instancia local de un administrador de cola multi-instancia son mostrados en la table siguiente. The results of the command depend on whether the -s or -x switch is used, and the running status of local and remote instances of the queue manager. Tabla 1. acciones de endmqm
Opcin endmqm Ordenador Local Activa Ordenador Remoto Ninguna Reserva Reserva -s Activa Activa Ninguna Reserva Reserva -x Activa Reserva Activa Ninguna Reserva Activa 0 90 77 0 90 79 AMQ8368 AMQ7276 AMQ8368 AMQ8367 0 RC Mensaje Resultado Finalizado administrador de cola. Finalizado administrador de cola, incluido la instancia de reserva. Standby instance of WebSphere MQ queue manager QmgrName not ended. WebSphere MQ queue manager cannot switch over. Queue manager QMNAME ended, permitting switchover to a standby instance. Standby instance of WebSphere MQ queue manager QmgrName not ended. Active instance of WebSphere MQ queue manager QmgrName not ended. Standby instance of queue manager QMNAME ended.
2.28.7
Comando
crtmqm endmqm dltmqm
Descripcin
Define un administrador de cola End queue manager Delete queue manager
2.29
endmqsvc (finalizar servicio IBM WebSphere MQ)
El comando endmqsvc finaliza el servicio IBM WebSphere MQ en Windows. (Slo Windows).
2.29.1
Propsito
El comando finaliza el servicio IBM WebSphere MQ en Windows. Ejecutar el comando para finalizar el servicio, si el servicio est ejecutndose.
Restaurar el servicio para WebSphere MQ procesa recogida de un Nuevo entorno, incluido nuevas definiciones de seguridad
2.29.2
endmqsvc
Sintaxis
2.29.3
Parmetros
El comando endmqsvc no tiene parmetros.
Debes seleccionar la ruta de instalacin que contiene el servicio. Bien fabricando la instalacin primaria, ejecutando el comando setmqenv, o ejecutando el commando desde el directorio que contiene el fichero binario endmqsvc.
2.29.4
strmqsvc (Start IBM WebSphere MQ service)
2.30
endmqtrc
Finaliza el trazado para alguna o todas las entidades que estn en trazado.
2.30.1
Propsito
Use el comando endmqtrc para finalizar el trazad de la entidad especificada o todas las entidades. El comando endmqtrc finalize solo el trazado que est descrito por sus parmetros. Usar endmqtrc sin parmetros finaliza rpidamente el trazado para todos los procesos.
2.30.2
Sintaxis
La sintxis de este comando es la siguiente:
>>-endmqtrc--+----------------+--+---------------+--------------> '- -m --QMgrName-' '- -i --PidTids-' >--+------------+--+------+--+------+-------------------------->< '- -p --Apps-' '- -e -' '- -a -'
2.30.3
Parmetro
-m QMgrName
Descripcin
The name of the queue manager for which to end tracing. The QMgrName supplied must match exactly the QMgrName supplied on the strmqtrc command. If the strmqtrc command used wildcards, the endmqtrc command must use the same wildcard specification including the escaping of any wildcard characters to prevent them being processed by the command environment. A maximum of one -m flag and associated queue manager name can be supplied on the command. Process identifier (PID) and thread identifier (TID) for which to end tracing. You cannot use the -i flag with the -e flag. If you try to use the -i flag with the -e flag, then an error message is issued. This parameter must only be used under the guidance of IBM Service personnel The named processes for which to end tracing. Apps is a comma-separated list. You must specify each name in the list exactly as the program name would be displayed in the "Program Name" FDC header. Asterisk (*) or question mark (?) wildcards are allowed. You cannot use the -p flag with the -e flag. If you try to use the -p flag with the -e flag, then an error message is issued. Ends early tracing of all processes. Using endmqtrc with no parameters has the same effect as endmqtrc -e. You cannot specify the -e flag with the -m flag, the -i flag, or the -p flag. Ends all tracing. This flag must be specified alone.
-i PidTids
-p Apps
-e
-a
2.30.4
Cd. Ret.
AMQ5611 58
Cdigos de retorno
Descripcin
This message is issued if you supply invalid arguments to the command. Inconsistencia de uso de instalaciones detectadas.
2.30.5
Ejemplos
Este commando finalize el trazado de datos para un administrador de cola llamado QM1.
endmqtrc -m QM1
Los ejemplos siguientes son una secuencia que muestra como el commando endmqtrc finalize solo el trazado que est descrito por sus parmetros. El siguiente commando active la traza para el administrador de cola QM1 y proceso amqxxx.exe: strmqtrc -m QM1 -p amqxxx.exe El siguiente commando active la traza para el administrador de cola QM2: strmqtrc -m QM2 El siguiente commando finalize la traza para el administrador de cola QM2 solamente. El trazado de administrador de cola QM1 y proceso amqxxx.exe contina: endmqtrc -m QM2
2.30.6
Command Descripcin
Visualiza salida del trazado formatado Inicia el trazado
dspmqtrc strmqtrc
2.31
migmbbrk
The migmbbrk command migrates publish/subscribe configuration data from WebSphere Event Broker Version 6.0 or WebSphere Message Broker Version 6.0 or 6.1 to WebSphere MQ Version 7.0.1 or later versions.
2.31.1
Propsito
The migmbbrk command is not supported on all of the platforms that WebSphere MQ supports. See Supported operating systems for details. To use the migmbbrk command you must be using at least WebSphere Message Broker Version 6.0, Fix Pack 9, or WebSphere Message Broker Version 6.1, Fix Pack 4. Use the migmbbrk command to migrate the publish/subscribe configuration data from a WebSphere Event Broker Version 6.0 or a WebSphere Message Broker Version 6.0 or Version 6.1 broker to a WebSphere MQ Version 7.0.1 or later queue manager. The command runs a migration process that migrates the following publish/subscribe configuration data to the queue manager that is associated with the named broker: Subscriptions Subscription points. (Subscription points are supported only when RFH2 messages are used.) Streams Retained publications
The migmbbrk command does not migrate the Access Control List (ACL). Instead, running the migration with the -t or -r parameters produces a file containing suggested setmqaut commands to set up a security environment in the queue manager that is equivalent to the security environment that existed in the broker. You must review and modify the security command file as needed and run the commands to set up a security environment in the queue manager, equivalent to the one that existed in the broker, before you run the migration with the -c parameter to complete the migration. Note: On UNIX systems, all authorities are held by user groups internally, not by principals. This has the following implications: If you use the setmqaut command to grant an authority to a principal, the authority is granted to the primary user group of the principal. This means that the authority is effectively granted to all members of that user group.
If you use the setmqaut command to revoke an authority from a principal, the authority is revoked from the primary user group of the principal. This means that the authority is effectively revoked from all members of that user group.
You must issue the migmbbrk command from a command window that can execute both WebSphere MQ and WebSphere Message Broker commands successfully. Typically this is true if the command is issued from a WebSphere Message Broker command console. The WebSphere Event Broker Version 6.0 or WebSphere Message Broker Version 6.0 or 6.1 publish/subscribe configuration data, which is stored in the subscription database tables, is not deleted by the migration process. This configuration data is therefore available to use until you explicitly delete it.
2.31.2
Sintaxis
.----------. V | >>-migmbbrk--+- -c -+----+------+-+-- -b --BrokerName---------->< +- -r -+ +- -l -+ '- -t -' +- -o -+ +- -s -+ '- -z -'
2.31.3
Parmetro
-b BrokerName
Descripcin
The name of the broker that is the source of the publish/subscribe configuration data that is to be migrated. The queue manager to which the publish/subscribe configuration data is migrated is the queue manager that is associated with the named broker. Complete the migration of the publish/subscribe configuration data. The completion phase of the migration uses the topic objects that are created in the initial -t phase. It is possible that the broker state has changed since the initial phase was run and that new additional topic objects are now required. If so, the completion phase creates new topic objects as necessary. The completion phase does not delete any topic objects that have become unnecessary; you might need to delete any topic objects that you do not require. Before you complete the migration you must review and modify the security command file produced in the -r or -t phase as required and execute the commands to set up a security environment in the queue manager, equivalent to the one that existed in the broker. Before you run this completion phase, you must run the initial -t phase. You cannot use the c parameter with the -r parameter or the -t parameter. This phase also creates a migration log. Rehearse the migration process but do not change anything. You can use this parameter before running the migration with the -t parameter, to create a migration log, including any errors, so that you can observe what the result of the migration process would be, but without changing the current configurations. Rehearsing the migration also produces a file containing suggested setmqaut commands to set up a security environment in the queue manager that is equivalent to the security environment that existed in the broker. Before you complete the migration with the -c parameter you must review and modify the security command file as required and execute the commands to set up a security environment in the queue manager, equivalent to the one that existed in the broker. You cannot use the -r parameter with the -c parameter or the -t parameter. Create topic objects that might be needed in the queue manager, based on the ACL entries that are defined in the broker. Use of the -t parameter also produces a file containing suggested setmqaut commands to set up a security environment in the queue manager that is equivalent to the security environment that existed in the broker. The topic objects are created in anticipation of you executing the security commands to create ACLs for the topic objects. Before you complete the migration with the -c parameter you must review and modify the security command file as required and execute the commands to set up a security environment in the queue manager, equivalent to the one that existed in the broker. You must run this phase before you run the completion phase with the -c parameter. You cannot use the -t parameter with the -c parameter or the -r parameter. This phase also creates a migration log.
-c
-r
-t
2.31.4
Parmetro
-l -o
Descripcin
Leave the broker running. If you do not specify this parameter, the broker is shut down by default at the end of the migration process. Overwrite any subscription or retained publication that exists in the queue manager and that has the same name as a subscription or retained publication that is being migrated from the broker, with the publish/subscribe configuration data that was retrieved from the broker. The -o parameter has no effect if you use it with the -r parameter. Discard any intermediate configuration data that was retained from a previous instance of the migration process that failed or was interrupted. The migration process populates private queues with temporary data. If the migration process completes successfully, the temporary data is deleted. If you do not specify this parameter and the migration process fails or is interrupted, the temporary data is retained and is used by the migration process if you restart it, so that the process resumes at the point where it previously failed or was interrupted. Run the migration process, regardless of whether it has previously run to a successful completion. If you do not specify this parameter and the migration process has previously run to a successful completion, the process recognizes this fact and exits. You can use the -o parameter with the -z parameter, but this is not mandatory. A previous rehearsal of the migration using the -r parameter does not count as a successful completion
-s
-z
2.31.5
Cd. Ret.
0 20
Cdigos de retorno
Explanation
Migration completed successfully Ha ocurrido un error durante el proceso
2.31.6
Output files
The migration process writes two output files to the current directory:
amqmigrateacl.txt A file containing a list of setmqaut commands, created in the current directory for you to review, change, and run if appropriate, to help you to reproduce your ACLs. amqmigmbbrk.log A log file containing a record of the details of the migration.
2.31.7
Ejemplos
This command migrates the publish/subscribe configuration data of broker BRK1 into its associated queue manager and specifies that the migration process runs regardless of whether it has previously run to a successful completion. It also specifies that any subscription or retained publication that exists in the queue manager, that has the same name as a subscription or retained publication that is being migrated from the broker, must be overwritten. migmbbrk -z -o -b BRK1
2.31.8
Supported operating systems
The migmbbrk command is supported only on the following platforms that support WebSphere Event Broker Version 6.0 or WebSphere Message Broker Version 6.0: Microsoft Windows XP Professional with SP2, 32bit versions only Solaris x86-64 platform: Solaris 10 Solaris SPARC platform: Sun Solaris 9 (64bit) AIX Version 5.2 or later, 64bit only HP-UX Itanium platform: HP-UX 11i Linux zSeries (64-bit) Linux PowerPC (64bit) Linux Intel x86 Linux Intel x8664
On z/OS, the equivalent function to the migmbbrk command is provided by the CSQUMGMB utility.
2.32
mqrc (MQ Cd. Ret.)

Visualiza informacin sobre Cdigos de Retorno.
2.32.1
Propsito
Puedes usar el comando mqrc para visualizar informacin sobre smbolos, cdigos de retorno, y mensajes AMQ. Puedes especificar un rango de cdigos de retorno o mensajes AMQ, as as como cdigos de retorno o mensajes AMQ especficos. Los argumentos numricos son tenterpretados como decimal si comienzan con un dgito 1 9, o hexadecimal si est prefijado con 0x.
2.32.2
Sintaxis
>>-+-+-----+--+-----+--+-returnCode-------------------------+-+->< | '- -a ' '- -b ' +- -r -returnCode--------------------+ | | +-AMQmessage-------------------------+ | | +- -m -AMQmessage--------------------+ | | +- -R -+---------------------------+-+ | | | | (1) | | | | | '- -f -first-- -l -last-----' | | | | (1) | | | '- -M - -f -first-- -l -last---------' | '-+-----+--symbol------------------------------------------' '- -s-' Notas: If there is a problem with a message within a range, an indication is displayed before the message text. ? is displayed if there are no matching return codes for the message. ! is displayed if the message severity is different to the return code severity.
2.32.3
Parmetro
Parmetros
Descripcin
El cdigo de retorno a visualizar El mensaje AMQ a visualizar El smbolo a visualizar Prueba todas las veveridades para encontrar texto de mensaje Visualiza mensajes son informacin extendida Primer nmero en un rango ltimo nmero en un rango El mensaje AMQ a listar Visualiza mensajes AMQ en un rango El cdigo de retorno a visualizar Visualiza todos los cdigos de retorno. Si es usado con lo parmetros f y l, -R visualize los cdigo de retorno en un Rango. The symbol to display
returnCode AMQmessage symbol -a -b -f first -l last -m AMQmessage -M -r returnCode -R -s symbol
2.32.4
Ejemplos
El comando visualiza mensaje AMQ 5005:
mqrc AMQ5005 Este comando visualiza cdigos de retorno en el rango 2505 - 2530: mqrc -R -f 2505 -l 2530
2.33
rcrmqobj
Re-define un objeto, o grupo de objetos, desde sus imgenes contenidas en el Log.
2.33.1
Propsito
Use this command to re-create an object, or group of objects, from their images contained in the log. This command can only be used when using linear logging. Use the associated command, rcdmqimg, to record the object images to the log. Use this command on a running queue manager. All activity on the queue manager after the image was recorded is logged. To re-create an object, replay the log to re-create events that occurred after the object image was captured.
2.33.2
Sintaxis
>>-rcrmqobj--+----------------+--+------+-- -t ObjectType-------> '- -m --QMgrName-' '- -z -' >--GenericObjName----------------------------------------------><
2.33.3
Parmetro
Descripcin
The name of the object to re-create. This parameter can have a trailing asterisk to recreate any objects with names matching the portion of the name before the asterisk. This parameter is required unless the object type is the channel synchronization file; any object name supplied for this object type is ignored. The types of object to re-create. Valid object types are: * o all authinfo Todos los tipos de objetos. Authentication information object, for use with Secure Sockets Layer (SSL) channel security channel o chl Canales clntconn o clcn Canales conexin cliente clchltab Tabla de canal cliente listener o lstr Listener namelist o nl Namelists process o prcs Procesos queue o q Todos los tipos de cola qalias o qa Alias de colas qlocal o ql Colas locales qmodel o qm Colas modelo qremote o qr Colas remotas service o srvc Servicio syncfile Channel synchronization file. You can use this option when circular logs are configured but thesyncfile fails if the channel scratchpad files, which are used to rebuild syncfile, are damaged or missing. topic o top Temas Note: When using WebSphere MQ for UNIX systems, you must prevent the shell from interpreting the meaning of special characters, for example, an asterisk (*). How you do this depends on the shell you are using, but might involve the use of single quotation marks ('), double quotation marks ("), or a backslash (\).
GenericObjName
-t ObjectType
2.33.4
Parmetro
-m QMgrName -z
Descripcin
The name of the queue manager for which to re-create objects. If omitted, the command operates on the default queue manager. Suppresses error messages.
2.33.5
Cdigos de retorno
Cd. Ret.
0 26 36 40 49 58 66 68 69 71 72 119 128 135 136 Operacin exitosa Queue manager running as a standby instance. Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Media image not available Media recovery not supported Storage not available Error inexperado Error en nombre de administrador de cola User not authorized No objects processed Temporary object cannot be recovered Object in use
Descripcin
2.33.6
defecto:
Ejemplos
El siguiente commando recrea todas las colas locales para el administrador de cola por
rcrmqobj -t ql * El siguiente commando recrea todas las colas remotas asociadas con el administrador de cola almacen: rcrmqobj -m almacen -t qr *
2.33.7
Descripcin
Record an object in the log
Comando
rcdmqimg
2.34
rmvmqinf
Retira informacin de configuracin WebSphere MQ (solo plataforma Windows y UNIX).
2.34.1
Propsito
Use el comando rmvmqinf para retirar informacin de configuracin WebSphere MQ.
Debe usar el comando rmvmqinf desde la instalacin asociada con el administrador de cola que ests trabajando. Puedes buscar que admnistrador de cola est asociado a la instalacin usando el comando dspmq -o installation.
2.34.2
Sintaxis
.- -s -QueueManager-. >>-rmvmqinf -+-------------------+--StanzaName----------------->< '- -s -StanzaType---'
2.34.3
Parmetro
StanzaName
Descripcin
The name of the stanza. That is, the value of the key attribute that distinguishes between multiple stanzas of the same type.
2.34.4
Parmetro
-s StanzaType
Descripcin
The type of stanza to remove. If omitted, a QueueManager stanza is removed. The only supported value of StanzaType is QueueManager.
2.34.5
Cd. Ret.
0 5 26 39 44 49 58 69 71 72
Cdigos de retorno
Descripcin
Operacin exitosa Queue manager is running Queue manager is running as a standby instance Bad command line parameters Stanza does not exist Queue manager is stopping Inconsistencia de uso de instalaciones detectadas. Almacenamiento no disponible Error inexperado Error en nombre de administrador de cola
2.34.6
Ejemplo
rmvmqinf QM.NAME
2.34.7
Notas de Uso
Use rmvmqinf to remove an instance of a multi-instance queue manager.
To use this command you must be a WebSphere MQ administrator and a member of the mqm group.
2.34.8
Command
addmqinf dspmqinf
Descripcin
Add queue manager configuration information Display queue manager configuration information
2.35
rsvmqtrn
Resolve in-doubt and heuristically completed transactions
2.35.1
Propsito
El comando rsvmqtrn es usado para resolver dos estados de transaccin.
2.35.1.1
IN-DOUBT TRANSACTIONS
Use the rsvmqtrn command to commit or back out internally or externally coordinated indoubt transactions. Note: Use this command only when you are certain that transactions cannot be resolved by the normal protocols. Issuing this command might result in the loss of transactional integrity between resource managers for a distributed transaction.
2.35.1.2
HEURISTICALLY COMPLETED TRANSACTIONS
Use the rsvmqtrn command with the -f option for WebSphere MQ to remove all information about externally coordinated transactions that were previously resolved manually using the rsvmqtrn command, but the resolution has not been acknowledged by the transaction coordinator using the xa-forget command. Transactions that are manually resolved by a resource manager and unacknowledged by the transaction manager, are known as heuristically completed transactions by X/Open. Note: Only use the -f option if the external transaction coordinator is permanently unavailable. The queue manager, as a resource manager, remembers the transactions that are committed or backed out manually by the rsvmqtrn command.
2.35.2
Sintaxis
>>-rsvmqtrn--+- -a -------------------------+-- -m --QMgrName-->< '-+- -b --------+--Transaction-' +- -c --------+ +- -f --------+ '- -r --RMID -'
2.35.3
Parmetro
-m QMgrName
Descripcin
The name of the queue manager.
2.35.4
Parmetro
-a -b -c -f
Descripcin
The queue manager resolves all internally coordinated, in-doubt transactions (that is, all global units of work). Backs out the named transaction. This flag is valid for externally coordinated transactions (that is, for external units of work) only. Commits the named transaction. This flag is valid for externally coordinated transactions (that is, external units of work) only. Forgets the named heuristically completed transaction. This flag is valid only for externally coordinated transactions (that is, external units of work) that are resolved, but unacknowledged by the transaction coordinator. Note: Use only if the external transaction coordinator is never going to be able to acknowledge the heuristically completed transaction. For example, if the transaction coordinator has been deleted. The participation of the resource manager in the in-doubt transaction can be ignored. This flag is valid for internally coordinated transactions only, and for resource managers that have had their resource manager configuration entries removed from the queue manager configuration information. Note: The queue manager does not call the resource manager. Instead, it marks the participation of the resource manager in the transaction as being complete. The transaction number of the transaction being committed or backed out. Use the dspmqtrn command to find the relevant transaction number. This parameter is required with the -b, -c, and -r RMID parameters.
-r RMID
Transaction
2.35.5
Cdigos de retorno
Descripcin
Cd. Ret.
Cd. Ret.
0 26 32 34 35 36 40 49 58 69 71 72 85 Operacin exitosa
Descripcin
Queue manager running as a standby instance. Transactions could not be resolved Resource manager not recognized Resource manager not permanently unavailable Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Storage not available Error inexperado Error en nombre de administrador de cola Transactions not known
2.35.6
Command Descripcin
Display list of prepared transactions
dspmqtrn
2.36
runmqchi
Ejecuta un canal iniciador de proceso para automatizar canals iniciados.
2.36.1
Propsito
Use el comando runmqchi para ejecutar un proceso iniciador de canal.
Debe usar el comando runmqchi desde la instalacin asociada con el administrador de cola con el que ests trabajando. Puedes encontrar que la instalacin de un administrador de cola est asociado con el usando el comando dspmq -o installation. El iniciador de canal comienza por defecto como parte del administrador de cola.
2.36.2
Sintaxis
>>-runmqchi--+-----------------------+--+----------------+----->< '- -q --InitiationQName-' '- -m --QMgrName-'
2.36.3
Descripcin
El nombre de iniciacin de cola a ser procesado por este canal iniciador. Si se omite es usado SYSTEM.CHANNEL.INITQ. El nombre del administrador de cola en que la cola de iniciacin existe. Si omites el nombre, es usado el administrador de cola por defecto.
Parmetro
-q InitiationQName -m QMgrName
2.36.4
Cdigos de retorno
Descripcin
Cd. Ret.
0 10 20
If errors occur that result in return codes of either 10 or 20, review the queue manager error log that the channel is associated with for the error messages, and the system error log for records of problems that occur before the channel is associated with the queue manager. For more information about error logs, see Error log directories.
2.37
runmqchl
Inicia un emisor o canal peticionario.
2.37.1
Propsito
Use el comando runmqchl para ejecutar bien un canal emisor (SDR) o peticionario (RQSTR). El cana se ejecuta sincronicamente. Para parar el canal, emitir el comando MQSC STOP CHANNEL.
2.37.2
Sintaxis
>>-runmqchl-- -c --ChannelName--+----------------+------------->< '- -m --QMgrName-'
2.37.3
Parmetro
Descripcin
El nombre del canal a ejecutarse.
-c ChannelName
2.37.4
Parmetro
-m QMgrName
Descripcin
The name of the queue manager with which this channel is associated. If you omit the name, the default queue manager is used.
2.37.5
Cdigos de retorno
Descripcin
Cd. Ret.
0 10 20
Si son generados los cdigos de retorno 10 20, revisar el log de error del administrador de cola asociado para los mensajes de error, y el log error de sistema para registro de problemas que ocurren antes de que el canal est asociado con el administrador de cola.
2.38
queue.
runmqdlq
Start the dead-letter queue handler to monitor and process messages on the dead-letter
2.38.1
Propsito
Use the runmqdlq command to start the dead-letter queue (DLQ) handler, which monitors and handles messages on a dead-letter queue.
2.38.2
Sintaxis
>>-runmqdlq--+-------------------------+----------------------->< '- QName --+------------+-' '- QMgrName -'
2.38.3
Description
Use the dead-letter queue handler to perform various actions on selected messages by specifying a set of rules that can both select a message and define the action to be performed on that message. The runmqdlq command takes its input from stdin. When the command is processed, the results and a summary are put into a report that is sent to stdout. By taking stdin from the keyboard, you can enter runmqdlq rules interactively. By redirecting the input from a file, you can apply a rules table to the specified queue. The rules table must contain at least one rule. If you use the DLQ handler without redirecting stdin from a file (the rules table), the DLQ handler reads its input from the keyboard. In WebSphere MQ for AIX, Solaris, HP-UX, and Linux, the DLQ handler does not start to process the named queue until it receives an end_of_file (Ctrl+D) character. In WebSphere MQ for Windows, it does not start to process the named queue until you press the following sequence of keys: Ctrl+Z, Enter, Ctrl+Z, Enter. For more information about rules tables and how to construct them, see La Tabla de reglas del canalizador DLQ.
2.38.4
The MQSC command rules for comment lines and for joining lines also apply to the DLQ handler input parameters. Parmetro
QName
Descripcin
The name of the queue to be processed. If you omit the name, the dead-letter queue defined for the local queue manager is used. If you enter one or more blanks (' '), the dead-letter queue of the local queue manager is explicitly assigned. The name of the queue manager that owns the queue to be processed. If you omit the name, the default queue manager for the installation is used. If you enter one or more blanks (' '), the default queue manager for this installation is explicitly assigned.
QMgrName
2.39
runmqdnm
Inicia el proceso de mensajes en una cola usando el monitor .NET (slo Windows).
2.39.1
Propsito
Note: The runmqdnm command applies to WebSphere MQ for Windows only. runmqdnm can be run from the command line, or as a triggered application.
Use the runmqdnm control command to start processing messages on an application queue with a .NET monitor.
2.39.2
Sintaxis
>>-runmqdnm-- -q --QueueName-- -a --AssemblyName----------------> >--+----------------+--+-----------------+----------------------> '- -m --QMgrName-' '- -c --ClassName-'
>--+---------------------+--+-----------------+-----------------> '- -u --UserParameter-' '- -s --Syncpoint-' >--+------------------+--+------------------+-------------------> '- -d --Conversion-' '- -n --MaxThreads-' >--+---------------+--+------------------------+----------------> '- -t --Timeout-' '- -b --BackoutThreshold-' >--+-----------------+--+---------------------+---------------->< '- -r --QueueName-' '- -p --ContextOption-'
2.39.3
Parmetro
Descripcin
The name of the application queue to monitor. The name of the .NET assembly.
-q QueueName -a AssemblyName
2.39.4
Parmetro
-m QMgrName -c ClassName
Descripcin
The name of the queue manager that hosts the application queue. If omitted, the default queue manager is used. The name of the .NET class that implements the IMQObjectTrigger interface. This class must reside in the specified assembly. If omitted, the specified assembly is searched to identify classes that implement the IMQObjectTrigger interface: If one class is found, then ClassName takes the name of this class. If no classes or multiple classes are found, then the .NET monitor is not started and a message is written to the console. User-defined data. This data is passed to the Execute method when the .NET monitor calls it. User data must contain ASCII characters only, with no double quotation marks, NULLs, or carriage returns If omitted, null is passed to the Execute method Specifies whether sync point control is required when messages are retrieved from the application queue. Possible values are: Messages are retrieved under sync point control (MQGMO_SYNCPOINT). NO Messages are not retrieved under sync point control (MQGMO_NO_SYNCPOINT). PERSISTENT Persistent messages are retrieved under sync point control (MQGMO_SYNCPOINT_IF_PERSISTENT). If omitted, the value of Syncpoint is dependent on your transactional model: If distributed transaction coordination (DTC) is being used, then Syncpoint is specified as YES. If distributed transaction coordination (DTC) is not being used, then Syncpoint is specified as PERSISTENT. Specifies whether data conversion is required when messages are retrieved from the application queue. Possible values are: YES Data conversion is required (MQGMO_CONVERT). NO Data conversion is not required (no get message option specified). If omitted, Conversion is specified as NO. The maximum number of active worker threads. If omitted, MaxThreads is specified as 20. The time, in seconds, that the .NET monitor waits for further messages to arrive on the application queue. If you specify -1, the .NET monitor waits indefinitely. If omitted when run from the command line, the .NET monitor waits indefinitely. If omitted when run as a triggered application, the .NET monitor waits for 10 seconds. Specifies the backout threshold for messages retrieved from the application queue. Possible values are: -1 0 The backout threshold is taken from the application queue attribute, BOTHRESH. The backout threshold is not set. YES
-u UserData
-s Syncpoint
-d Conversion
-n MaxThreads -t Timeout
-b BackoutThreshold
1 o ms Explicitly sets the backout threshold. If omitted, BackoutThreshold is specified as -1. -r QueueName The queue to which messages, with a backout count exceeding the backout threshold, are put. If omitted, the value of QueueName is dependent on the value of the BOQNAME attribute from the application queue: If BOQNAME is non-blank, then QueueName takes the value of BOQNAME. If BOQNAME is blank, then QueueName is specified as the queue manager dead letter queue. If a dead letter queue has not been assigned to the queue manager, then backout processing is not available. Specifies whether context information from a message that is being backed out is passed to the backed out message. Possible values are: NONE No context information is passed. DENTITY Identity context information is passed only. ALL All context information is passed. If omitted, ContextOption is specified as ALL.
-p ContextOption
2.39.5
Cd. Ret.
0 36 40 49 58 71 72 133
Cdigos de retorno
Descripcin
Operacin exitosa Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Error inexperado Error en nombre de administrador de cola Unknown object name error
2.40
runmqlsr
Ejecuta un proceo listener para listen for remote requests on various communication protocols.
2.40.1
Propsito
Use the runmqlsr command to start a listener process.
This command is run synchronously and waits until the listener process has finished before returning to the caller.
2.40.2
Sintaxis
>>-runmqlsr-- -t -----------------------------------------------> >--+- tcp --+------------+--+--------------+--+---------------+-+--> | '- -p --Port-' '- -i --IPAddr-' '- -b --Backlog-' | +- lu62 -- -n --TpName---------------------------------------+ | .---------------------. | | V | | +- netbios ----+-----------------+-+-------------------------+ | +- -a --Adapter---+ | | +- -l --LocalName-+ | | +- -e --Names-----+ | | +- -s --Sessions--+ | | '- -o --Commands--' | | .-------------------. |
| V | | '- spx ----+---------------+-+-------------------------------' +- -x --Socket--+ '- -b --Backlog-' >--+----------------+------------------------------------------>< '- -m --QMgrName-'
2.40.3
Parmetro
-t
Descripcin
The transmission protocol to be used: tcp lu62 netbios spx Transmission Control Protocol / Internet Protocol (TCP/IP) SNA LU 6.2 (Windows only) NetBIOS (Windows only) SPX (Windows only)
2.40.4
Parmetro
-p Port
Descripcin
The port number for TCP/IP. This flag is valid for TCP only. If you omit the port number, it is taken from the queue manager configuration information, or from defaults in the program. The default value is 1414. It must not exceed 65535. The IP address for the listener, specified in one of the following formats: IPv4 dotted decimal IPv6 hexadecimal notation Alphanumeric format This flag is valid for TCP/IP only. On systems that are both IPv4 and IPv6 capable you can split the traffic by running two separate listeners. One listening on all IPv4 addresses and one listening on all IPv6 addresses. If you omit this parameter, the listener listens on all configured IPv4 and IPv6 addresses. The LU 6.2 transaction program name. This flag is valid only for the LU 6.2 transmission protocol. If you omit the name, it is taken from the queue manager configuration information. The adapter number on which NetBIOS listens. By default the listener uses adapter 0. The NetBIOS local name that the listener uses. The default is specified in the queue manager configuration information. The number of names that the listener can use. The default value is specified in the queue manager configuration information. The number of sessions that the listener can use. The default value is specified in the queue manager configuration information. The number of commands that the listener can use. The default value is specified in the queue manager configuration information. The SPX socket on which SPX listens. The default value is hexadecimal 5E86. The name of the queue manager. By default the command operates on the default queue manager. The number of concurrent connection requests that the listener supports. See TCP, LU62, NETBIOS, and SPX for a list of default values and further information.
-i IPAddr
-n TpName
-a Adapter -l LocalName -e Names -s Sessions -o Commands -x Socket -m QMgrName -b Backlog
2.40.5
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
Comando completado normalmente Comando completado con resultados inexperados Ha ocurrido un error durante el proceso: the AMQMSVRN process did not start.
2.40.6
Ejemplos
The following command runs a listener on the default queue manager using the NetBIOS protocol. The listener can use a maximum of five names, five commands, and five sessions. These resources must be within the limits set in the queue manager configuration information.
runmqlsr -t netbios -e 5 -s 5 -o 5
2.41
runmqsc
Ejecuta comandos WebSphere MQ en un administrador de cola.
2.41.1
Propsito
Use the runmqsc command to issue MQSC commands to a queue manager. MQSC commands enable you to perform administration tasks, for example defining, altering, or deleting a local queue object. MQSC commands and their syntax are described in the WebSphere MQ Script (MQSC) Command Reference. You must use the runmqsc command from the installation associated with the queue manager that you are working with. You can find out which installation a queue manager is associated with using the dspmq -o installation command.
2.41.2
Sintaxis
>>-runmqsc--+------+--+------+----------------------------------> '- -e -' '- -v -' >--+----------------------------------------------------+-------> | .- -m -DefaultQMgrName-. | '- -w --WaitTime--+------+--+----------------------+-' '- -x -' '- -m -LocalQMgrName---' >--+----------+------------------------------------------------>< '-QMgrName-'
2.41.3
Description
You can start the runmqsc command in three ways:
2.41.3.1
VERIFY COMMAND
Verify MQSC commands but do not run them. An output report is generated indicating the success or failure of each command. This mode is available on a local queue manager only.
2.41.3.2
RUN COMMAND DIRECTLY

Send MQSC commands directly to a local queue manager.
2.41.3.3
RUN COMMAND INDIRECTLY
Run MQSC commands on a remote queue manager. These commands are put on the command queue on a remote queue manager and run in the order in which they were queued. Reports from the commands are returned to the local queue manager. The runmqsc command takes its input from stdin. When the commands are processed, the results and a summary are put into a report that is sent to stdout. By taking stdin from the keyboard, you can enter MQSC commands interactively. By redirecting the input from a file, you can run a sequence of frequently used commands contained in the file. You can also redirect the output report to a file.
2.41.4
Parmetro
-e
Descripcin
Prevents source text for the MQSC commands from being copied into a report. This
-m LocalQMgrName -v -w WaitTime
WaitTime
-x
QMgrName
parameter is useful when you enter commands interactively. The local queue manager that you want to use to submit commands to the remote queue manager. If you omit this parameter the local default queue manager is used to submit commands to the remote queue manager. Verifies the specified commands without performing the actions. This mode is only available locally. The -w and -x flags are ignored if they are specified at the same time. Run the MQSC commands on another queue manager. You must have the required channel and transmission queues set up for this. See Preparing channels and transmission queues for remote administration for more information. The time, in seconds, that runmqsc waits for replies. Any replies received after this are discarded, but the MQSC commands still run. Specify a time in the range 1 through 999 999 seconds. Each command is sent as an Escape PCF to the command queue (SYSTEM.ADMIN.COMMAND.QUEUE) of the target queue manager. The replies are received on queue SYSTEM.MQSC.REPLY.QUEUE and the outcome is added to the report. This can be defined as either a local queue or a model queue. Esta seal es ignorada si es especificada la seal -v. The target queue manager is running under z/OS. This flag applies only in indirect mode. The -w flag must also be specified. In indirect mode, the MQSC commands are written in a form suitable for the WebSphere MQ for z/OS command queue. The name of the target queue manager on which to run the MQSC commands, by default, the default queue manager.
2.41.5
Cd. Ret.
00 10 20
Cdigos de retorno
Descripcin
MQSC command file processed successfully MQSC command file processed with errors; report contains reasons for failing commands Error; MQSC command file not run
2.41.6
Ejemplos
Introducir este comando en la ventana de comandos:
runmqsc Ahora puedes introducer comandos MQSC directamente en la ventana de comandos. No se especifica ningn administrador de cola, as que los comandos MQSC son procesados en el administrador de cola por defecto. Use uno de estos comandos, segn sea apropiado para su entorno, para especificar que que comando MQSC van a ser verificados solamente: runmqsc -v BANK < "/u/users/commfile.in" runmqsc -v BANK < "c:\users\commfile.in" Este comando verifica los comandos MQSC en el fichero commfile.in. El administrador de cola es BANK. La salida es visualizada en la ventana actual. Estos comandos ejecutan el fichero de comandos mqscfile.in nuevamente para el administrador de cola por defecto. runmqsc < "/var/mqm/mqsc/mqscfile.in" > "/var/mqm/mqsc/mqscfile.out" runmqsc < "c:\Program Files\IBM\WebSphere MQ\mqsc\mqscfile.in" > "c:\Program Files\IBM\WebSphere MQ\mqsc\mqscfile.out" In this example, the output is directed to file mqscfile.out. Este comando propone comandos al administrador de cola QMREMOTE, usando QMLOCAL para proponer los comandos. runmqsc w 30 m QMLOCAL QMREMOTE
2.42
runmqtmc
Inicia el monitor de disparador en un cliente.
2.42.1
Propsito
Use the runmqtmc command to start a trigger monitor for a client. For further information about using trigger monitors, see Trigger monitors. When a trigger monitor starts, it continuously monitors the specified initiation queue. The trigger monitor does not stop until the queue manager ends, see endmqm. While the client trigger monitor is running it keeps the dead letter queue open.
2.42.2
Sintaxis
>>-runmqtmc--+----------------+--+-----------------------+------> '- -m --QMgrName-' '- -q --InitiationQName-' >--+-----+----------------------------------------------------->< '- -r '
2.42.3
Parmetro
-m QMgrName
Descripcin
The name of the queue manager on which the client trigger monitor operates, by default the default queue manager. The name of the initiation queue to be processed, by default
-q InitiationQName -r
SYSTEM.DEFAULT.INITIATION.QUEUE.
Specifies that the client trigger monitor automatically reconnects.
2.42.4
Cdigos de retorno
Cd. Ret.
0 10 20
Descripcin
Not used. The client trigger monitor is designed to run continuously and therefore not to end. The value is reserved. Client trigger monitor interrupted by an error. Error; client trigger monitor not run.
2.42.5
Ejemplos
For examples of using this command, see The Triggering sample programs.
2.43
runmqtrm
Start the trigger monitor on a server.
2.43.1
Propsito
Use the runmqtrm command to start a trigger monitor. For further information about using trigger monitors, see Trigger monitors. When a trigger monitor starts, it continuously monitors the specified initiation queue. The trigger monitor does not stop until the queue manager ends, see endmqm. While the trigger monitor is running it keeps the dead letter queue open.
2.43.2
Sintaxis
>>-runmqtrm--+----------------+--+-----------------------+----->< '- -m --QMgrName-' '- -q --InitiationQName-'
2.43.3
-m QMgrName
Descripcin
The name of the queue manager on which the trigger monitor operates, by default the default queue manager. Specifies the name of the initiation queue to be processed, by default
Parmetro
-q InitiationQName
SYSTEM.DEFAULT.INITIATION.QUEUE.
2.43.4
Cdigos de retorno
Descripcin
Not used. The trigger monitor is designed to run continuously and therefore not to end. Hence a value of 0 would not be seen. The value is reserved. Trigger monitor interrupted by an error. Error; trigger monitor not run.
Cd. Ret.
0 10 20
2.44
runswchl
runswchl (switch cluster channel) on UNIX, Linux, and Windows.
2.44.1
Propsito
The command switches or queries the cluster transmission queues associated with clustersender channels.
2.44.2
Notas de Uso
You must log on as an Administrator to run this command.
The command switches all the stopped or inactive cluster-sender channels that match the c parameter, require switching, and can be switched. The command reports back on the channels that are switched, the channels that do not require switching, and the channels it cannot switch because they are not stopped or inactive. If you set the -q parameter, the command does not perform the switch, but it provides the list of channels that would be switched.
2.44.3
Sintaxis
>>-runswchl-- -m-- -QmgrName--+- -c-- -*------------------+--+-----+->< +- -c-- -GenericChannelName-+ +- -q-+ '- -c-- -ChannelName--------' '- -n-'
2.44.4
-m QmgrName
Descripcin
The queue manager to run the command against. The queue manager must be started. All the cluster-sender channels All matching cluster-sender channels Single cluster-sender channel.
Parmetro
-c * -c GenericChannelName -c ChannelName
2.44.5
-q -n
Display the state of one or more channels. If you omit this parameter, the commands switches any stopped or inactive channels that require switching. When switching transmission queues, do not transfer messages from the old queue to the new transmission queue. Note: Take care with the -n option: messages on the old transmission queue are not transferred unless you associate the transmission queue with another cluster-sender channel.
2.44.6
Cod. Ret
0 10 20
Cdigos de retorno
Descripcin
The command completed successfully The command completed with warnings. The command completed with errors.
2.44.7
Ejemplos
To display the configuration state of cluster-sender channel TO.QM2:
RUNSWCHL -m QM1 -c TO.QM2 -q To switch the transmission queue for cluster-sender channel TO.QM3 without moving the messages on it: RUNSWCHL -m QM1 -c TO.QM3 -n To switch the transmission queue for cluster-sender channel TO.QM3 and move the messages on it: RUNSWCHL -m QM1 -c TO.QM3 To display the configuration state of all cluster-sender channels on QM1: RUNSWCHL -m QM1 -c * -q To display the configuration state of all cluster-sender channels with a generic name of TO.*: RUNSWCHL -m QM1 -c TO.* -q
2.44.8
Clustering: Switching cluster transmission queues
2.45
setmqaut
Change the authorizations to a profile, object, or class of objects. Authorizations can be granted to, or revoked from, any number of principals or groups. For more information about authorization service components, see Installable services, Service components, and Authorization service interface. For more information about how authorizations work, see How authorizations work.
2.45.1
Sintaxis
>>-setmqaut--+----------------+-- -n --Profile------------------> '- -m --QMgrName-' >-- -t --ObjectType--+------------------------+-----------------> '- -s --ServiceComponent-' .-------------------------. V | >----+- -p --PrincipalName-+-+----------------------------------> '- -g --GroupName-----' .---------------------------------------.
V | >----+-| MQI authorizations |------------+-+------------------->< +-| Context authorizations |--------+ +-| Administration authorizations |-+ +-| Generic authorizations |--------+ +- +remove -------------------------+ '- -remove -------------------------'
2.45.1.1
MQI AUTHORIZATIONS
.--------------------. V | |------+- +altusr --+---+---------------------------------------| +- -altusr --+ +- +browse --+ +- -browse --+ +- +connect -+ +- -connect -+ +- +get -----+ +- -get -----+ +- +inq -----+ +- -inq -----+ +- +pub -----+ +- -pub -----+ +- +put -----+ +- -put -----+ +- +resume --+ +- -resume---+ +- +set -----+ +- -set -----+ +- +sub -----+ '- -sub -----'
2.45.1.2
CONTEXT AUTHORIZATIONS
.--------------------. V | |------+- +passall -+---+---------------------------------------| +- -passall -+ +- +passid --+ +- -passid --+ +- +setall --+ +- -setall --+ +- +setid ---+ '- -setid ---'
2.45.1.3
ADMINISTRATION AUTHORIZATIONS
.------------------. V | |------+- +chg ---+---+-----------------------------------------| +- -chg ---+ +- +clr ---+ +- -clr ---+ +- +crt ---+ +- -crt ---+ +- +dlt ---+ +- -dlt ---+ +- +dsp ---+ +- -dsp ---+ +- +ctrl --+ +- -ctrl --+ +- +ctrlx -+ '- -ctrlx -'
2.45.1.4
GENERIC AUTHORIZATIONS
.-------------------.
V |------++++++++'-
| +all ----+---+----------------------------------------| -all ----+ +alladm -+ -alladm -+ +allmqi -+ -allmqi -+ +none ---+ +system -+ -system -'
2.45.2
Description
Use setmqaut both to grant an authorization, that is, give a principal or user group permission to perform an operation, and to revoke an authorization, that is, remove the permission to perform an operation. You can specify a number of parameters: Queue manager name Principals and user groups Object type Profile name Service component
The authorizations that can be given are categorized as follows: Authorizations for issuing MQI calls Authorizations for MQI context Authorizations for issuing commands for administration tasks Generic authorizations
Each authorization to be changed is specified in an authorization list as part of the command. Each item in the list is a string prefixed by a plus sign (+) or a minus sign (-). For example, if you include +put in the authorization list, you grant authority to issue MQPUT calls against a queue. Alternatively, if you include -put in the authorization list, you revoke the authority to issue MQPUT calls. You can specify any number of principals, user groups, and authorizations in a single command, but you must specify at least one principal or user group. If a principal is a member of more than one user group, the principal effectively has the combined authorities of all those user groups. On Windows systems, the principal also has all the authorities that have been granted to it explicitly using the setmqaut command. On UNIX systems, all authorities are held by user groups internally, not by principals. Granting authorities to groups has the following implications: If you use the setmqaut command to grant an authority to a principal, the authority is granted to the primary user group of the principal. This means that the authority is effectively granted to all members of that user group. If you use the setmqaut command to revoke an authority from a principal, the authority is revoked from the primary user group of the principal. This means that the authority is effectively revoked from all members of that user group.
To alter authorizations for a cluster sender channel that has been automatically generated by a repository, see Channel definition commands.
2.45.3
Parmetro
-t ObjectType
Descripcin
El tipo de objeto para el que cambiar autorizaciones. Los valores posibles son los siguientes:
-n Profile
authinfo Un objeto informacin de autenticacin channel o chl Un canal clntconn o clcn Un canal conexin cliente comminfo Un objeto informacin de comunicacin listener o lstr Un listener namelist o nl Una lista-de-nombre process o prcs Un proceso queue o q Una cola qmgr Un administrador de cola rqmname o rqmn Un nombre de administrador de cola remoto service o srvc Un servicio topic o top Un tema The name of the profile for which to change authorizations. The authorizations apply to all WebSphere MQ objects with names that match the profile name specified. The profile name can be generic, using wildcard characters to specify a range of names as explained in Using OAM generic profiles on UNIX or Linux systems and Windows. This parameter is required, unless you are changing the authorizations of a queue manager, in which case you must not include it. To change the authorizations of a queue manager use the queue manager name, for example
setmqaut -m QMGR -t qmgr -p user1 +connect

where QMGR is the name of the queue manager and user1 is the user requesting the change. Each class of object has authority records for each group or principal. These records have the profile name @CLASS and track the crt (create) authority common to all objects of that class. If the crt authority for any object of that class is changed then this record is updated. For example:
profile: object type: entity: entity type: authority:
@class queue test principal crt
This shows that members of the group test have crt authority to the class queue.
2.45.4
Parmetro
-m QMgrName
Descripcin
The name of the queue manager of the object for which to change authorizations. The name can contain up to 48 characters. This parameter is optional if you are changing the authorizations of your default queue manager. The name of the principal for which to change authorizations. For WebSphere MQ for Windows only, the name of the principal can optionally include a domain name, specified in the following format:
-p PrincipalName
userid@domain
For more information about including domain names on the name of a principal, see Principals and groups. You must have at least one principal or group. The name of the user group for which to change authorizations. You can specify more than one group name, but each name must be prefixed by the -g flag. For WebSphere MQ for Windows only, the GroupName can optionally include a domain name, specified in the following formats:
-g GroupName
GroupName@domain domain\GroupName
-s ServiceComponent +remove o remove Authorizations The name of the authorization service to which the authorizations apply (if your system supports installable authorization services). This parameter is optional; if you omit it, the authorization update is made to the first installable component for the service. Remove all the authorities from WebSphere MQ objects that match the specified profile. This option cannot be used with the option -t qmgr. The authorizations to be granted or revoked. Each item in the list is prefixed by a plus sign (+) or a minus sign (-). The plus sign indicates that authority is to be granted. The minus sign indicates that authority is to be revoked. For example, to grant authority to issue MQPUT calls, specify +put in the list. To revoke the authority to issue MQPUT calls, specify -put.
objetos.
La siguiente tala muestra las autoridades que pueden ser dadas a los diferentes tipos de
Table 1. Autoridades Especificas para diferentes tipos de objetos.

Autori dad all1 alladm
2
Col Pro a c. Yes Yes Yes Yes No Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No Yes No No No No
Nom. Adm. ListaAdm. Cola Cola Nombre Remota Yes Yes Yes Yes Yes No Yes No Yes Yes No No Yes Yes No No No Yes No No No Yes Yes Yes No Yes Yes No Yes Yes No No No No No No No No No No No No Yes No No No No No No No No No Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No No No No No No
Tema Yes Yes Yes No No No Yes Yes No Yes Yes No Yes Yes No Yes No No No No Yes No No No Yes No
Auten. info Yes Yes Yes Yes No No Yes No No Yes No No Yes Yes No No No Yes No No No No No No No No
Clntconn Yes Yes No Yes No No Yes No No Yes No No Yes Yes No No No No No No No No No No No No
Canal Yes Yes No Yes No No Yes No No Yes Yes Yes Yes Yes No No No No No No No No No No No No
Listener Servicio Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No
Comminfo Yes Yes No Yes No No Yes No No Yes No No Yes Yes No No No No No No No No No No No No
allmqi3 none altusr
browse Yes chg clr connec t crt ctrl ctrlx dlt dsp get pub put inq passall passid resum e set setall setid sub Yes Yes No Yes No No Yes Yes Yes No Yes Yes Yes Yes No Yes Yes Yes No
system No
Note: all authority is equivalent to the union of the authorities alladm, allmqi, and system appropriate to the object type. alladm authority is equivalent to the union of the individual authorities chg, clr, dlt, dsp, ctrl, and ctrlx appropriate to the object type. crt authority is not included in the subset alladm. allmqi authority is equivalent to the union of the individual authorities altusr, browse, connect, get, inq, pub, put, resume, set, and sub appropriate to the object type.
2.45.5
Cdigos de retorno
Cd. Ret.
0 26 36 40 49 58 69 71 72 133 145 146 147 148 149 150 151 Operacin exitosa Queue manager running as a standby instance. Argumentos suplidos no validos Queue manager not available Queue manager stopping Inconsistencia de uso de instalaciones detectadas. Storage not available Error inexperado Error en nombre de administrador de cola Unknown object name Unexpected object name Object name missing Object type missing Invalid object type Entity name missing Authorization specification missing Invalid authorization specification
Explanation
2.45.6
Ejemplos
This example shows a command that specifies that the object on which authorizations are being given is the queue orange.queue on queue manager saturn.queue.manager. setmqaut -m saturn.queue.manager -n orange.queue -t queue -g tango +inq +alladm The authorizations are given to a user group called tango, and the associated authorization list specifies that the user group can: Issue MQINQ calls Perform all administration operations on that object
In this example, the authorization list specifies that a user group called foxy: Cannot issue any MQI calls to the specified queue Can perform all administration operations on the specified queue
setmqaut -m saturn.queue.manager -n orange.queue -t queue -g foxy -allmqi +alladm This example gives user1 full access to all queues with names beginning a.b. on queue manager qmgr1. The profile is persistent and applies to any object with a name that matches the profile. setmqaut -m qmgr1 -n a.b.* -t q -p user1 +all This example deletes the specified profile. setmqaut -m qmgr1 -n a.b.* -t q -p user1 -remove This example creates a profile with no authority. setmqaut -m qmgr1 -n a.b.* -t q -p user1 +none
2.45.7
Autorizacin altusr browse
Autorizaciones
Para llamadas MQI
Descripcin Use another users authority for the queue manager. Retrieve a message from a queue using an MQGET call with the BROWSE option.
connect get inq pub put resume set sub
Connect the application to the specified queue manager using an MQCONN call. Retrieve a message from a queue using an MQGET call. Make an inquiry on a specific queue using an MQINQ call. Publish a message on a topic using the MQPUT call. Put a message on a specific queue using an MQPUT call. Resume a subscription using the MQSUB call. Set attributes on a queue from the MQI using an MQSET call. Create, alter or resume a subscription to a topic using the MQSUB call.
Note: If you open a queue for multiple options, you must be authorized for each option.
Para contexto
Autorizacin passall passid setall setid Descripcin Pass all context on the specified queue. All the context fields are copied from the original request. Pass identity context on the specified queue. The identity context is the same as that of the request. Set all context on the specified queue. This is used by special system utilities. Set identity context on the specified queue. This is used by special system utilities.
Note: To use setid or setall authority authorizations must be granted on both the appropriate queue object and also on the queue manager object.
2.45.8
chg clr crt dlt dsp ctrl
Authorizations for commands

Change the attributes of the specified object. Clear the specified queue or a topic. Create objects of the specified type. Delete the specified object. Display the attributes of the specified object. For listeners and services, start and stop the specified channel, listener, or service. For channels, start, stop, and ping the specified channel. For topics, define, alter, or delete subscriptions. Reset or resolve the specified channel.
ctrlx
2.45.9
all alladm allmqi none
Authorizations for generic operations

Use all operations applicable to the object. all authority is equivalent to the union of the authorities alladm, allmqi, and system appropriate to the object type. Use all administration operations applicable to the object. Use all MQI calls applicable to the object. No authority. Use this authorization to create profiles without authority. When an authority is given to an object or group that was previously showing "none", then the authorization changes to the authority just applied. However, when the "none" authorization is added to an object or group with an existing alternative authority, the authority does not change. Use queue manager for internal system operations.
system
2.46
setmqcrl
Administrar las definiciones LDAP de la CRL (lista de revocacin de certificados) en un Active Directory (slo en Windows).
2.46.1
Finalidad
Nota: El mandato setmqcrl se aplica a WebSphere MQ para Windows nicamente.
Utilice el mandato setmqcrl para configurar y administrar el soporte para publicar definiciones LDAP de CRL (lista de revocacin de certificados) en un Active Directory. Un administrador del dominio debe utilizar inicialmente este mandato, o setmqscp, para preparar Active Directory para que utilice WebSphere MQ y para otorgar a los usuarios y administradores de WebSphere MQ las autorizaciones pertinentes para acceder y actualizar los objetos Active Directory de WebSphere MQ. Tambin puede utilizar el mandato setmqcrl para visualizar todas las definiciones de servidor de CRL configuradas actualmente que estn disponibles en Active Directory, es decir, aquellas definiciones a las que hace referencia la Lista de nombres CRL del gestor de colas. Los nicos tipos de servidores de CRL soportados son los servidores LDAP.
2.46.2
Sintaxis
>>-setmqcrl--+-----------------------------------+--------------> '- -a --+-------------------------+-' '- -m --NombreGestorColas-' >--+-----------------------------------+--+------+------------->< '- -r --+-------------------------+-' '- -d -' '- -m --NombreGestorColas-'
2.46.3
Debe especificar uno de estos tres: -a (aadir), -r (eliminar) o -d (visualizar).
Parmetro
-a
Descripcin
Aade el contenedor Active Directory de conexiones de cliente MQI de WebSphere MQ, si todava no existe. Debe ser un usuario con los privilegios adecuados para crear subcontenedores en el contenedor Sistema del dominio. La carpeta de WebSphere MQ se llama CN=IBMMQClientConnections. No suprima esta carpeta de ningn otro modo que no sea mediante el mandato setmqscp. Visualiza las definiciones de servidor de CRL de WebSphere MQ. Elimina las definiciones de servidor de CRL de WebSphere MQ. -m [ * | qmgr ] Modifica el parmetro especificado (-a o -r) de modo que slo resulte afectado el gestor de colas especificado. Debe incluir esta opcin con el parmetro -a. * | qmgr * especifica que todos los gestores de colas se ven afectados. Esto le permite migrar un archivo de definiciones de servidor de CRL de WebSphere MQ especfico desde un solo gestor de colas.
-d -r
2.46.4
Ejemplos
El mandato siguiente crea la carpeta IBM-MQClientConnections y asigna los permisos necesarios a los administradores de WebSphere MQ para la carpeta y para los objetos hijo que se creen posteriormente. En este caso, es funcionalmente equivalente a setmqscp -a. setmqcrl -a El mandato siguiente migra las definiciones de servidor de CRL existentes de un gestor de colas local, Paint.queue.manager, a Active Directory, para lo que antes suprime cualquier otra definicin de CRL de Active Directory: setmqcrl -a -m Paint.queue.manager
2.47
setmqenv
Ajusta el entorno de WebSphere MQ, en UNIX, Linux, y Windows.
2.47.1
Propsito
Puedes usar el script setmqenv para ajustar automticamente el entono para uso con una instalacin de WebSphere MQ. Alternativamente, puedes usar el commando crtmqenv para definer una lista de variables de entorno y valores para ajustar manualmente cada variable de entorno de tu sistema. You can specify which installation the environment is set up for by specifying a queue manager name, an installation name, or an installation path. You can also set up the environment for the installation that issues the setmqenv command by issuing the command with the -s parameter. This command sets the following environment variables, appropriate to your system: CLASSPATH INCLUDE LIB MANPATH MQ_DATA_PATH MQ_ENV_MODE MQ_FILE_PATH MQ_JAVA_INSTALL_PATH MQ_JAVA_DATA_PATH MQ_JAVA_LIB_PATH MQ_JAVA_JVM_FLAG MQ_JRE_PATH PATH
On UNIX and Linux systems, if the -l or -k flag is specified, the LIBPATH environment variable is set on AIX, and the LD_LIBRARY_PATH environment variable is set on HP-UX, Linux, and Solaris.
2.47.2
Notas de Uso
The setmqenv command removes all directories for all WebSphere MQ installations from the environment variables before adding new references to the installation you are setting up the environment for. Therefore, if you want to set any additional environment variables that reference WebSphere MQ, set the variables after issuing the setmqenv command. For example, if you want to add MQ_INSTALLATION_PATH/java/lib to LD_LIBRARY_PATH, you must do so after running setmqenv. In some shells, command-line parameters cannot be used with setmqenv and any setmqenv command issued is assumed to be a setmqenv -s command. The command produces an informational message that the command has been executed as if a setmqenv -s command had been issued. Therefore, in these shells you must ensure that you issue the command from the installation you want to set the environment for. In these shells, you must set the LD_LIBRARY_PATH variable manually. Use the crtmqenv command with the -l or -k parameter to list the LD_LIBRARY_PATH variable and value. Then use this value to set the LD_LIBRARY_PATH.
2.47.3
Sintaxis
-m -n -p -r -s -QMgrName---------+--+-----+--+-----------+->< -InstallationName-+ +- -k + '- -x -Mode-' -InstallationPath-+ '- -l ' ------------------+ ------------------'
>>-setmqenv--++++'-
2.47.4
-m QMgrName
Descripcin
Set up the environment for the installation associated with the queue manager
Parmetro
-n InstallationName -p InstallationPath -r -s -k
-l
-x Mode
QMgrName. Set up the environment for the installation named InstallationName. Set up the environment for the installation in the path InstallationPath. Remove all installations from the environment. Set up the environment for the installation that issued the setmqenv command. UNIX and Linux only. Include the LD_LIBRARY_PATH, or LIBPATH, environment variable in the environment, adding the path to the WebSphere MQ libraries at the start of the current LD_LIBRARY_PATH, or LIBPATH, variable. UNIX and Linux only. Include the LD_LIBRARY_PATH, or LIBPATH, environment variable in the environment, adding the path to the WebSphere MQ libraries at the end of the current LD_LIBRARY_PATH, or LIBPATH, variable. Mode can take the value 32, or 64. Create a 32-bit or 64-bit environment. If this parameter is not specified, the environment matches that of the queue manager or installation specified in the command. Any attempt to display a 64-bit environment with a 32-bit installation fails.
2.47.5
Cd. Ret.
0 10 20
Cdigos de retorno
Descripcin
Comando completado normalmente. Comando completado con resultados inexperados. Ha ocurrido un error durante el proceso.
2.47.6
Ejemplos
The following examples assume that a copy of WebSphere MQ is installed in /opt/mqm on a UNIX or Linux system. Note: The . character used at the beginning of each command makes the setmqenv script run in the current shell. Therefore, the environment changes made by the setmqenv script are applied to the current shell. Without the . character, the environment variables are changed in another shell, and the changes are not applied to the shell from which the command is issued. This command sets up the environment for an installation installed in /opt/mqm: . /opt/mqm/bin/setmqenv -s This command sets up the environment for an installation installed in /opt/mqm2, and includes the path to the installation at the end of the current value of the LD_LIBRARY_PATH variable: . /opt/mqm/bin/setmqenv -p /opt/mqm2 -l This command sets up the environment for the queue manager QM1, in a 32-bit environment: . /opt/mqm/bin/setmqenv -m QM1 -x 32 The following example assumes that a copy of WebSphere MQ is installed in C:\Program Files\IBM\WebSphere MQ on a Windows system. This command sets up the environment for an installation called Installation1: "C:\Program Files\IBM\WebSphere MQ\bin\setmqenv.cmd" -n Installation1
2.47.7
crtmqenv
2.47.8
Informacin relacionada
Choosing a primary installation Multiple installations
2.48
setmqinst
Set WebSphere MQ installations, on UNIX, Linux, and Windows.
2.48.1
Propsito
You can use the setmqinst command to change the installation description of an installation, or to set or unset an installation as the primary installation. To change the primary installation, you must unset the current primary installation before you can set a new primary installation. This command updates information contained in the mqinst.ini file. After unsetting the primary installation, the setmqinst command will not be available unless you specify the full path or have an appropriate installation directory on your PATH (or equivalent). The default path in a system standard location will have been deleted. File mqinst.ini contains information about all WebSphere MQ installations on a system. For more information about mqinst.ini, see Installation configuration file, mqinst.ini. On UNIX or Linux systems, you must run this command as root. On Windows systems, you must run this command as a member of the Administrators group. The command does not have to be run from the installation you are modifying.
2.48.2
Sintaxis
>>-setmqinst--| Action |--| Installation |---------------------><
2.48.2.1
ACTION
|--+- -i------------------+-------------------------------------| +- -x------------------+ '- -d--DescriptiveText-'
2.48.2.2
|--++| +| '-
INSTALLATION
-p -InstallationPath----------------------------+---------| -n -InstallationName----------------------------+ (1) | -p -InstallationPath-- -n--InstallationName-----+ (1) | -n -InstallationName-- -p -InstallationPath-----' Notas: When specified together, the installation name and installation path must refer to the same installation.
2.48.3
Parmetros
Descripcin
Text that describes the installation. The text can be up to 64 single-byte characters, or 32 double-byte characters. The default value is all blanks. You must use double quotation marks around the text if it contains spaces. Set this installation as the primary installation. Unset this installation as the primary installation. The name of the installation to modify. The path of the installation to modify. You must use double quotation marks around the path if it contains spaces
Parmetro
-d DescriptiveText
-i -x -n InstallationName -p InstallationPath
2.48.4
Cd. Ret.
0 36
Cdigos de retorno
Descripcin
Entry set without error Argumentos suplidos no validos
Cd. Ret.
37 44 59 71 89 96 98 131 El texto descriptivo est en error La entrada no existe Instalacin especificada no vlida Error inexperado Error en fichero INI No puede bloquear fichero INI
Descripcin
Autoridad insuficiente para acceder a fichero INI Resource problem
2.48.5
Ejemplos
This command sets the installation with the name of myInstallation as the primary installation: setmqinst -i -n myInstallation This command sets the installation with an installation path of /opt/myInstallation as the primary installation: setmqinst -i -p /opt/myInstallation This command unsets the installation named myInstallation as the primary installation: setmqinst -x -n myInstallation This command unsets the installation with an installation path of /opt/myInstallation as the primary installation: setmqinst -x -p /opt/myInstallation This command sets the descriptive text for the installation named myInstallation: setmqinst -d "My installation" -n myInstallation The descriptive text is enclosed in quotation marks as it contains spaces.
2.48.6
Related concepts:
Choosing a primary installation
2.48.7
Changing the primary installation
2.49
setmqm
Selecciona la instalacin asociada de un administrador de cola.
2.49.1
Propsito
Use el comando setmqm para seleccionar la instalacin asociada de WebSphere MQ de un administrador de cola. El administrador de cola puede posteriormente ser administrado usando solo los commandos de la instalacin asocidada. Por ejemplo, cuando un administrador de cola es iniciado con strmqm, debe ser el comando strmqm de la instalacin que ha sido especificado por el comando setmqm. Para ms informacin sobre uso de este comando, include informacin sobre su uso, consultar Associating a queue manager with an installation. Este comando solo es applicable a UNIX, Linux y Windows.
2.49.2

Notas de Uso
You must use the setmqm command from the installation you want to associate the queue manager with. The installation name specified by the setmqm command must match the installation from which the setmqm command is issued. You must stop the queue manager before executing the setmqm command. The command fails if the queue manager is still running. Once you have set the associated installation of a queue manager using the setmqm command, migration of the queue manager's data occurs when you start the queue manager using the strmqm command. Once you have started the queue manager on an installation, you cannot then use setmqm to set the associated installation to an earlier version of WebSphere MQ, as it is not possible to migrate back to earlier versions of WebSphere MQ. You can find out which installation is associated with a queue manager by using the dspmq command. See dspmq for more information.
2.49.3
Sintaxis
>>-setmqm-- -m--QMgrName-- -n--InstallationName----------------><
2.49.4
Descripcin
El nombre del administrador de cola a seleccionar asociado a la instalacin. The name of the installation that the queue manager is to be associated with. The installation name is not case-sensitive.
Parmetro
-m QMgrName -n InstallationName
2.49.5
Cdigos de retorno
Descripcin
Queue manager set to an installation without error Queue manager running Argumentos suplidos no validos Instalacin especificada no vlida Command not executed from the installation named by the -n parameter Invalid installation name for this queue manager Resource problem Error inexperado Error en nombre de administrador de cola User not authorized
Cd. Ret.
0 5 36 59 60 61 69 71 72 119
2.49.6
Ejemplos
Este comando asocia un administrador de cola QMGR1, de una instalacin con e nombre de instalacin miInstalacion. MQ_INSTALLATION_PATH/bin/setmqm -m QMGR1 -n miInstalacion
2.50
setmqspl
Use the setmqspl command to define a new security policy, alter an already existing one, or remove an existing policy.
2.50.1
Sintaxis
>>-setmqspl-- -m -QMgrName--------------------------------------> >-- -p -PolicyName--+-| Policy definition |-+------------------>< '- -remove--------------'
2.50.1.1
POLICY DEFINITION
.----------------------. .-NONE----. V | |-- -e -+---------+----+------------------+-+-------------------> | (1) | '- -r -RecipientDN-' +-RC2-----+ +-DES-----+ +-3DES----+ +-AES128--+ '-AES256--' .-----------------------. V | .-NONE---. .-0-. >----+-------------------+-+-- -s -+--------+-- -t -+---+-------| | (2) | +-MD5----+ '-1-' '- -a -AuthorDN-----' +-SHA1---+ +-SHA256-+ +-SHA384-+ '-SHA512-' Notas: If an encryption algorithm is selected, a recipient DN must also be provided. If an author DN is provided, a signing algorithm must also be selected.
Tabla 1. Seales de comando de setmqspl.

Seal de Comando -m -p -s Explicacin Queue manager name. This flag is mandatory for all actions on security policies. Policy name. Set the policy name to the name of the queue you wish the policy to apply to. Digital signature algorithm. WebSphere MQ Advanced Message Security supports the following values: MD5, SHA1, SHA256, SHA384, and SHA512. All must be in uppercase. The default value is NONE Important: For the SHA384 and SHA512 cryptographic hash functions, keys used for signing must be longer than 768 bits. Encryption algorithms name must be in uppercase Digital encryption algorithm. WebSphere MQ Advanced Message Security supports the following encryption algorithms: RC2, DES, 3DES, AES128, AES256. The default value is NONE. Important: Encryption algorithms name must be in uppercase Message recipients distinguished name (DN) (certificate of a DN provided is used to encrypt a given message). Recipients can be specified only if encryption algorithm is different from NONE. Multiple recipients can be included for a message. Each DN must be provided with a separate -r flag. Important: DN attribute names must be in uppercase. Commas must be used as a name separators. To avoid command interpreter errors, place quotation marks around the DNs. For example: -r "CN=alice, O=ibm, C=US" Signature DN that is validated during message retrieval. Only messages signed by a user with a DN provided are accepted during the retrieval. Signature DNs can be specified only if the signature algorithm is different from NONE. Multiple authors can be included. Each author needs to have a separate -a flag. Important: DN attribute name must be in uppercase. Toleration flag that indicates whether a policy that is associated with a queue can be ignored when an attempt to retrieve a message from the queue involves a message with no security
-e
-r
-a
-t
Tabla 1. Seales de comando de setmqspl.

Seal de Comando Explicacin policy set. Valid values include: 0 (default) Toleration flag off. 1 Toleration flag on. Toleration is optional and facilitates staged roll-out, where policies were applied to queues but those queues may already contain messages that have no policy, or still receive messages from remote systems that do not have the security policy set. -remove Delete policy. If specified, only the -p flag remains valid.
2.51
setmqprd
Enroll a WebSphere MQ production license. A license is normally enrolled as part of the installation process.
Note: You must have the appropriate privileges to run this command on your system. UNIX requires root access, and Windows with UAC (User Account Control) requires Administrator access to run this command.
2.51.1
Sintaxis
>>-setmqprd--LicenseFile---------------------------------------><
2.51.2
Parmetro
LicenseFile
Descripcin
Specifies the fully-qualified name of the production license certificate file. The full license file is amqpcert.lic. On UNIX and Linux, it is in the /MediaRoot/licences directory on the installation media. On Windows it is in the \MediaRoot\licences directory on the installation media. It is installed into the bin directory on the WebSphere MQ installation path.
2.51.3
Conversin de licencia Trial
A trial license installation is identical to a production license installation, except for the "count-down" message that is displayed when you start a queue manager on an installation with a trial license. Parts of WebSphere MQ that are not installed on the server, such as the WebSphere MQ MQI client, continue to work after the expiry of the trial license. You do not need to run setmqprd to enroll them with a production license. When a trial license expires, you can still uninstall WebSphere MQ. You can also reinstall WebSphere MQ with a full production license. Run setmqprd to enroll a production license after installing and using a installation with a trial license.
2.51.4
Converting a trial license on UNIX, Linux, and Windows
2.52
setmqscp
Publish client connection channel definitions in an Active Directory (Windows only).
2.52.1
Propsito
Note: The setmqscp command applies to WebSphere MQ for Windows only.
Use the setmqscp command to configure and administer support for publishing client connection channel definitions in an Active Directory. Initially, this command is used by a domain administrator to: Prepare the Active Directory for WebSphere MQ use Grant WebSphere MQ users and administrators the relevant authorities to access and update the WebSphere MQ Active Directory objects
You can also use the setmqscp command to display all the currently configured client connection channel definitions available on the Active Directory.
2.52.2
Sintaxis
>>-setmqscp--+--------------------------+-----------------------> '- -a --+----------------+-' '- -m --QMgrName-' >--+--------------------------+--+------+---------------------->< '- -r --+----------------+-' '- -d -' '- -m --QMgrName-'
2.52.3
You must specify one of -a (add), -r (remove) or -d (display).
Parmetro
-a
Descripcin
Adds the WebSphere MQ MQI client connections Active Directory container, if it does not already exist. You must be a user with the appropriate privileges to create subcontainers in the System container of your domain. The WebSphere MQ folder is called CN=IBM-MQClientConnections. Do not delete this folder in any other way than by using the setmqscp -r command. Displays the service connection points. Removes the service connection points. If you omit -m, and no client connection definitions exist in the IBM-MQClientConnections folder, the folder itself is removed from the Active Directory. -m [ * | qmgr ] Modifies the specified parameter (-a or -r) so that only the specified queue manager is affected. * | qmgr * specifies that all queue managers are affected. This enables you to migrate a specific client connection table file from one queue manager alone, if required.
-d -r
2.52.4
Ejemplos
The following command creates the IBM-MQClientConnections folder and allocates the required permissions to WebSphere MQ administrators for the folder, and to child objects created subsequently: setmqscp -a The following command migrates existing client connection definitions from a local queue manager, Paint.queue.manager, to the Active Directory: setmqscp -a -m Paint.queue.manager The following command migrates all client connection definitions on the local server to the Active Directory: setmqscp -a -m *
2.53
strmqcfg
Inicia Explorador WebSphere MQ (solo plataformas Windows, Linux x86, y Linux x86-64).
2.53.1
Propsito
Para WebSphere MQ de Windows solamente, obseva que si usas runas para ejecutar este comando, debes definir la variable de entorno APPDATA. On Linux, to start WebSphere MQ Explorer successfully, you must be able to write a file to your houeme directory, and the home directory must exist. Nota: La forma preferida para iniciar el Explorador WebSphere MQ en sistemas Windows y Linux es usar el menu de sistema, o el fichero ejecutable MQExplorer.
2.53.2
Sintaxis
La sintxis de este comado es la siguiente:
>>-strmqcfg--+------+--+------+--+------+---------------------->< '- -c -' '- -i -' '- -x -'
2.53.3
Parmetro
-c -i -x
Descripcin
-clean is passed to Eclipse. This parameter causes Eclipse to delete any cached data used by the Eclipse runtime. -init is passed to Eclipse. This parameter causes Eclipse to discard configuration information used by the Eclipse runtime. Output debug messages to the console.
2.54
strmqcsv
Inicia el servidor de comando para un administrador de cola.
2.54.1
Propsito
Use the strmqcsv command to start the command server for the specified queue manager. This enables WebSphere MQ to process commands sent to the command queue. You must use the strmqcsv command from the installation associated with the queue manager that you are working with. You can find out which installation a queue manager is associated with using the dspmq -o installation command. If the queue manager attribute, SCMDSERV, is specified as QMGR then changing the state of the command server using strmqcsv does not effect how the queue manager acts upon the SCMDSERV attribute at the next restart.
2.54.2
Sintaxis
>>-strmqcsv--+-----+--+----------+----------------------------->< '- -a-' '-QMgrName-'
2.54.3
Ninguno
2.54.4
Parmetro
-a
Descripcin
Blocks the following PCF commands from modifying or displaying authority information: Inquire authority records (MQCMD_INQUIRE_AUTH_RECS) Inquire entity authority (MQCMD_INQUIRE_ENTITY_AUTH)
QMgrName
Set authority record (MQCMD_SET_AUTH_REC). Delete authority record (MQCMD_DELETE_AUTH_REC). El nombre del adminitrador de cola en el que iniciar el servidor de comando. Si es omitido, es usado el administrador de cola por defecto.
2.54.5
Cdigos de retorno
Descripcin
Cd. Ret.
0 10 20
2.54.6
Ejemplos
El comando siguiente inicia un servidor de comando para un administrador de cola earth:
strmqcsv earth
2.54.7
Comando Descripcin
End a command server Display the status of a command server
endmqcsv dspmqcsv
2.55
strmqsvc (Iniciar servicio IBM WebSphere MQ)
The strmqsvc command starts the IBM WebSphere MQ service on Windows. Run the command on Windows only.
2.55.1
Propsito
El comndo inicia el servicio IBM WebSphere MQ en Windows.
Ejecuta el comando para iniciar el servicio, si no ha sido iniciado automticamente, o si el servicio ha finalizado. Restaura el servicio WebSphere MQ para recoger un Nuevo entorno, incluido nuevas definiciones de seguridad.
2.55.2
Sintaxis
strmqsvc
2.55.3
Parmetros
El comando strmqsvc no tiene parmetros.
You must set the path to the installation that contains the service. Either make the installation primary, run the setmqenv command, or run the command from the directory containing the strmqsvc binary file.
2.55.4
endmqsvc (end IBM WebSphere MQ service)
2.56
strmqm
Inicia un administrador de cola lo adapta para operaciones de reserva.
2.56.1
Propsito
Use el comando strmqm para iniciar un administrador de cola.
Debe usar el comando strmqm desde la instalacin asociada con el administrador de cola con el que ests trabajando. Puedes encontrar que un administrador de cola est asociado a la instalacin usando el comando dspmq -o installation. If a queue manager has no associated installation and there is no installation of WebSphere MQ V7.0.1 on the system, the strmqm command will associate the queue manager with the installation that issued the strmqm command. If the queue manager startup takes more than a few seconds WebSphere MQ shows intermittent messages detailing the startup progress.
2.56.2
Sintaxis
>>-strmqm--+----------------------+--+-----+--+-------+---------> +- -c -----------------+ '- -f ' +- -si -+ +- -r -----------------+ '- -ss -' +- -a -----------------+ +- -x -----------------+ '- -e CMDLEVEL=--Level ' >--+------------------+--+------+--+------+--+-----------+----->< '- -d -Information ' '- -z -' '- -ns-' '- QMgrName '
2.56.3
Parmetro
-a
Descripcin
Activate the specified backup queue manager. The backup queue manager is not started. When activated, a backup queue manager can be started using the control command strmqm QMgrName. The requirement to activate a backup queue manager prevents accidental startup. When activated, a backup queue manager can no longer be updated. For more information about using backup queue managers, see Backing up and restoring WebSphere MQ queue manager data. Starts the queue manager, redefines the default and system objects, then stops the queue manager. Any existing system and default objects belonging to the queue manager are replaced if you specify this flag, and any non-default system object values are reset (for example, the value of MCAUSER is set to blank). Use the crtmqm command to create the default and system objects for a queue manager. Specifies whether information messages are displayed. Possible values for Information follow: Valor Descripcin all All information messages are displayed. This parameter is the default value. minimal The minimal number of information messages are displayed. none No information messages are displayed. This parameter is equivalent to -z. The -z parameter takes precedence over this parameter. Enables a command level for this queue manager, and then stops the queue manager. The queue manager is now able to use all functions provided by the specified command level. You can start the queue manager only with an installation that supports the new command level. This option is only valid if the current command level used by the queue manager is lower than the maximum command level supported by the installation. Specify a command level that is greater than the current command level of the queue manager and less than or equal to the maximum command level supported by the installation. Use exactly the command level as a value for Level that is associated with the function you want to enable.
-c
-d Information
-e CMDLEVEL=Level
-f
-ns
-r
-si
-ss
-x
-z
QMgrName
This flag cannot be specified with -a, -c, -r or -x. Use this option if you know a queue manager is not starting because its data directories are missing or corrupted. The strmqm -f qmname command attempts to re-create the queue manager data directory and reset file permissions. If it is successful, the queue manager starts, unless the queue manager configuration information is missing. If the queue manager fails to start because the configuration information is missing, re-create the configuration information, and restart the queue manager. In releases of WebSphere MQ earlier than 7.0.1, strmqm, with no -f option, automatically repaired missing data directories and then tried to start. This behavior has changed. From WebSphere MQ Version 7.0.1 onwards, the default behavior of strmqm, with no -f option, is not to recover missing or corrupted data directories automatically, but to report an error, such as AMQ6235 or AMQ7001, and not start the queue manager. You can think of the -f option as performing the recover actions that used to be performed automatically by strmqm. The reason for the change to the behavior of strmqm is that with the support for networked file storage in WebSphere MQ Version 7.0.1, the most likely cause of missing or corrupted queue manager data directories is a configuration error that can be rectified, rather than the data directories are corrupted or irretrievably unavailable. You must not use strmqm -f to re-create the queue manager data directories if you can restore the directories by correcting the configuration. Possible solutions to problems with strmqm are to make the networked file storage location accessible to the queue manager, or to ensure the gid and uid of the mqm group and user ID on the server hosting the queue manager match the gid and uid of the mqm group and user ID on the server hosting the queue manager data directory. From WebSphere MQ Version 7.0.1, if you are performing media recovery for a queue manager, then you must use the -f option to re-create the queue manager data directory. Prevents any of the following processes from starting automatically when the queue manager starts: The channel initiator The command server Listeners Services Updates the backup queue manager. The backup queue manager is not started. WebSphere MQ updates the objects of the backup queue manager by reading the queue manager log and replaying updates to the object files. For more information about using backup queue managers, see Backing up and restoring WebSphere MQ queue manager data. Interactive (manual) queue manager startup type. This option is available on WebSphere MQ for Windows only. The queue manager runs under the logged on (interactive) user. Queue managers configured with interactive startup end when the user who started them logs off. If you set this parameter, it overrides any startup type set previously by the crtmqm command, the amqmdain command, or the WebSphere MQ Explorer. If you do not specify a startup type of either -si or -ss, the queue manager startup type specified on the crtmqm command is used. Service (manual) queue manager startup type. This option is available on WebSphere MQ for Windows only. The queue manager runs as a service. Queue managers configured with service startup continue to run even after the interactive user has logged off. If you set this parameter, it overrides any startup type set previously by the crtmqm command, the amqmdain command, or the WebSphere MQ Explorer. Start an instance of a multi-instance queue manager on the local server, permitting it to be highly available. If an instance of the queue manager is not already running elsewhere, the queue manager starts and the instance becomes active. The active instance is ready to accept local and remote connections to the queue manager on the local server. If a multi-instance queue manager instance is already active on a different server the new instance becomes a standby, permitting it to takeover from the active queue manager instance. While it is in standby, it cannot accept local or remote connections. You must not start a second instance of a queue manager on the same server. The default behavior, omitting the -x optional parameter, is to start the instance as a single instance queue manager, forbidding standby instances from being started. Suppresses error messages. This flag is used within WebSphere MQ to suppress unwanted information messages. Because using this flag can result in loss of information, do not use it when entering commands on a command line. This parameter takes precedence over the -d parameter. The name of a local queue manager. If omitted, the default queue manager is used.
2.56.4
Cd. Ret.
0 3 5 16 23 24 30 31 39 43 47 49 58 62 69 71 72 74 91 92 100 119
Cdigos de retorno
Descripcin
Queue manager started Queue manager being created Queue manager running Queue manager does not exist Log not available A process that was using the previous instance of the queue manager has not yet disconnected. A standby instance of the queue manager started. The active instance is running elsewhere The queue manager already has an active instance. The queue manager permits standby instances. Invalid parameter specified The queue manager already has an active instance. The queue manager does not permit standby instances. The queue manager already has the maximum number of standby instances Queue manager stopping Inconsistencia de uso de instalaciones detectadas. The queue manager is associated with a different installation Storage not available Error inexperado Error en nombre de administrador de cola The WebSphere MQ service is not started. The command level is outside the range of acceptable values. The queue manager's command level is greater or equal to the specified value. Log location invalid User not authorized to start the queue manager
2.56.5
Ejemplos
El siguiente comando inicia la cuenta del administrador de cola:
strmqm account
2.56.6
Descripcin
Define un administrador de cola Borra un administrador de cola Visualiza informacin de version de MQ Finaliza un administrador de cola
Command
crtmqm dltmqm dspmqver endmqm
2.57
strmqtrc
Enable trace at a specified level of detail, or report the level of tracing in effect.
2.57.1
Propsito
Use the strmqtrc command to enable tracing.
You must use the strmqtrc command from the installation associated with the queue manager that you are working with. You can find out which installation a queue manager is associated with using the dspmq -o installation command.
2.57.2
Sintaxis
The syntax of this command is as follows:
>>-strmqtrc--+----------------+--+------+-----------------------> '- -m --QMgrName-' '- -e -' .---------------------. V | >----+-----------------+-+--+-----------------+-----------------> '- -t --TraceType-' '- -x --TraceType-' >--+---------------+--+----------------------+------------------> '- -l --MaxSize-' '- -d--+- 0----------+-' +- -1---------+ '- NumOfBytes-' >--+---------------+--+------------+--+------+------------------> '- -i --PidTids-' '- -p --Apps-' '- -s -' >--+--------------------+--+-------------------+--------------->< '- -b --StartTrigger-' '- -c --StopTrigger-'
2.57.3
Description
El comando strmqtrc active el trazado. Tiene parmetros opcionales que especifican el nivel de traza que deseas: Una o ms administradores de cola Niveles de detalle de traza Uno o ms procesos WebSphere MQ. El proceso o bien puede ser parte del product WebSphere MQ o aplicaciones personalidadas que usan la API WebSphere MQ Hilos especficos con aplicaciones personalizadas, bien por nmero de hilo WebSphere MQ o por nmero de hilo del sistema operativo Eventos. Estos pueden ser o bien la entrada o salida desde funciones internas de WebSphere MQ o la ocurrencia de una primera captura de datos fallida (FDC).
Cada combinacin de parmetros en una llamada individual del comando es interpretada por WebSphere MQ segn tenga un AND lgico entre ellos. Puedes iniciar el comando strmqtrc multiples veces, sin considerer si el trazado ya est activo. Si el trazado est active, las opciones de traza que estn en efecto son modificadas para aquellos que son especificados en la llamada ms reciente del comando. Multiples llamadas del comando, sin una intervencin del comando enqmqtrc, son interpretadas por WebSphere MQ como un lgico OR entre ellos. El mximo nmero de comandos strmqtrc concurrentes que pueden tener efecto a la vez es 16.
2.57.4
Parmetro
-m QMgrName
Descripcin
El nombre del administrador de cola a trazar. Son permitidos los siguientes comodines: asterisco (*), reemplaza 0 ms caracteres, y marca de interrogacin (?), reemplaza un carcter simple. En entornos de comando tales como el esquema UNIX, donde los caracteres asterisco (*) y marca de interrogacin (?) tienen significado especial, debes delimiter los caracteres comodin entre secuencia de escape o entrecomillarlo para prevenir el entorno de commando de la operacin en el carcter comodin. Requests early tracing of all processes, making it possible to trace the creation or startup of a queue manager. If you include this flag, any process belonging to any component of any queue manager traces its early processing. The default is not to perform early tracing.
-e
-t TraceType
-x TraceType
-l MaxSize
You cannot use the -e flag with the -m flag, -i flag, the -p flag, the -c flag, or the -b flag. If you try to use the -e flag with the -m flag, the -i flag, the -p flag, the -c flag, or the -b flag, then an error message is issued. The points to trace and the amount of trace detail to record. By default all trace points are enabled and a default-detail trace is generated. Alternatively, you can supply one or more of the options in the following list. For each tracetype value you specify, including -t all, specify either -t parms or -t detail to obtain the appropriate level of trace detail. If you do not specify either -t parms or -t detail for any particular trace type, only a default-detail trace is generated for that trace type. If you supply multiple trace types, each must have its own -t flag. You can include any number of -t flags, if each has a valid trace type associated with it. It is not an error to specify the same trace type on multiple -t flags. Valor Descripcin all Output data for every trace point in the system (the default). The all parameter activates tracing at default detail level. api Output data for trace points associated with the MQI and major queue manager components. commentary Output data for trace points associated with comments in the WebSphere MQ components. comms Output data for trace points associated with data flowing over communications networks. csdata Output data for trace points associated with internal data buffers in common services. csflows Output data for trace points associated with processing flow in common services. detail Activate tracing at high-detail level for flow processing trace points. Explorer Output data for trace points associated with the WebSphere MQ Explorer. java Output data for trace points associated with applications using the WebSphere MQ classes for Java API. lqmdata Output data for trace points associated with internal data buffers in the local queue manager. lqmflows Output data for trace points associated with processing flow in the local queue manager. otherdata Output data for trace points associated with internal data buffers in other components. otherflows Output data for trace points associated with processing flow in other components. parms Activate tracing at default-detail level for flow processing trace points. remotedata Output data for trace points associated with internal data buffers in the communications component. remoteflows Output data for trace points associated with processing flow in the communications component. servicedata Output data for trace points associated with internal data buffers in the service component. serviceflows Output data for trace points associated with processing flow in the service component. soap Output data for trace points associated with WebSphere MQ Transport for SOAP. ssl Output data associated with using GSKit to enable Secure Sockets Layer (SSL) channel security. versiondata Output data for trace points associated with the version of WebSphere MQ running. The points not to trace. By default all trace points are enabled and a default-detail trace is generated. The trace points you can specify are those listed for the -t flag. You can use the -x flag with tracetype values to exclude those entry points you do not want to record. This is useful in reducing the amount of trace produced. If you supply multiple trace types, each must have its own -x flag. You can include any number of -x flags, if each has a valid tracetype associated with it. The maximum size of a trace file (AMQppppp.qq.TRC) in megabytes (MB). For example, if you specify a MaxSize of 1, the size of the trace is limited to 1 MB. When a trace file reaches the specified maximum, it is renamed to AMQppppp.qq.TRS and a new AMQppppp.qq.TRC file is started. If a previous copy of an AMQppppp.qq.TRS file exists, it is deleted. The highest value that MaxSize can be set to is 2048 MB. Trace no user data. Trace all user data For a communication trace; trace the specified number of bytes of data including the
-d 0 -d -1 or all -d NumOfBytes
transmission segment header (TSH). For an MQPUT or MQGET call; trace the specified number of bytes of message data held in the message buffer. Values in the range 1 through 15 are not allowed. -i PidTids Process identifier (PID) and thread identifier (TID) to which the trace generation is restricted. You cannot use the -i flag with the -e flag. If you try to use the -i flag with the e flag, then an error message is issued. This parameter must only be used under the guidance of IBM Service personnel. This parameter is not supported for .NET clients if NMQ_MQ_LIB is set to managed, so that the client uses managed WebSphere MQ problem diagnostics. The named processes to which the trace generation is restricted. Apps is a commaseparated list. You must specify each name in the list exactly as the program name would be displayed in the "Program Name" FDC header. Asterisk (*) or question mark (?) wildcards are allowed. You cannot use the -p flag with the -e flag. If you try to use the -p flag with the -e flag, then an error message is issued. This parameter is not supported for .NET clients if NMQ_MQ_LIB is set to managed, so that the client uses managed WebSphere MQ problem diagnostics. Reports the tracing options that are currently in effect. You must use this parameter on its own with no other parameters. A limited number of slots are available for storing trace commands. When all slots are in use, then no more trace commands can be accepted unless they replace an existing slot. Slot numbers are not fixed, so if the command in slot number 0 is removed, for example by an endmqtrc command, then all the other slots move up, with slot 1 becoming slot 0, for example. An asterisk (*) in a field means that no value is defined, and is equivalent to the asterisk wildcard. An example of the output from this command is as follows:
-p Apps
-s
Listing Trace Control Array Used slots = 2 of 15 EarlyTrace TimedTrace TraceUserData MaxSize Trace Type [OFF] [OFF] [0] [0] [1]
Slot position 1 Untriggered Queue Manager [avocet] Application [*] PID.TID [*] TraceOptions [1f4ffff] TraceInterval [0] Trace Start Time [0] Trace Stop Time [0] Start Trigger [KN346050K] Start Trigger [KN346080] Slot position 2 Untriggered Queue Manager [*] Application [*] PID.TID [*] TraceOptions [1fcffff] TraceInterval [0] Trace Start Time [0] Trace Stop Time [0] Start Trigger [KN346050K] Start Trigger [KN346080]
Este parmetro no est soportado para clientes .NET si NMQ_MQ_LIB est seleccionado como administrado, de forma que los clientes usan diagnstico de problemas WebSphere MQ administrado.
-b Start_Trigger
FDC probe IDs for which tracing must be turned on. Start_Trigger is a comma-separated list of FDC probe IDs. You can use asterisk (*) and question mark (?) wildcards in the specification of probe IDs. You cannot use the -b flag with the -e flag. If you try to use the -b flag with the -e flag, then an error message is issued. This parameter must only be used under the guidance of IBM Service personnel. Start_Trigger Efecto FDC=comma-separated list of Turns on tracing when any FDCs with the specified FDC FDC probe IDs. probe IDs are generated. This parameter is not supported for .NET clients if NMQ_MQ_LIB is set to managed, so that the client uses managed WebSphere MQ problem diagnostics. FDC probe IDs for which tracing must be turned off, or interval in seconds after which tracing must be turned off. Stop_Trigger is a comma-separated list of FDC probe IDs. You can use asterisk (*) and question mark (?) wildcards in the specification of probe IDs. This parameter should be used only under the guidance of IBM Service personnel. Stop_Trigger Efecto FDC=comma-separated list of FDC Turns tracing off when any FDCs with the specified probe IDs. FDC probe IDs are generated. Turns tracing off n seconds after it starts or, if it interval=n where n is an unsigned tracing is already enabled, turns tracing off n seconds integer between 1 and after this instance of the command is issued. 32,000,000. This parameter is not supported for .NET clients if NMQ_MQ_LIB is set to that the client uses managed WebSphere MQ problem diagnostics.
-c Stop_Trigger
managed, so
2.57.5
Cd. Ret.
AMQ7024 AMQ8304 58
Cdigos de retorno
Descripcin
Non-valid arguments supplied to the command. Nine concurrent traces (the maximum) already running. Inconsistencia de uso de instalaciones detectadas.
2.57.6
Ejemplos
Este comando activa el trazado del flujo de proceso desde los servicios communes y el administrador de cola local para un administrador de cola llamado QM1 en WebSphere MQ para sistemas UNIX. El dato de la traza es generado en el nivel de detalle por defecto. strmqtrc -m QM1 -t csflows -t lqmflows -t parms Este comando desactiva el trazado de actividad SSL en un administrador de cola llamado QM1. Son generados otros datos de trazado en el nivel de parmetros de detalle. strmqtrc -m QM1 -x ssl -t parms Este comando active el trazado de alto-detalle de flujo de proceso para todos los componentesThis command enables high-detail tracing of the processing flow for all components: strmqtrc -t all -t detail Este comando active el trazado cuando ocurre FDC KN346050 FDC KN346080 en cualquier proceso que est usando el administrador de cola QM1: strmqtrc -m QM1 -b FDC=KN346050,KN346080 Este comando active el trazado cuando ocurre FDC KN34650, y para el trazado cuando ocurre FDC KN346080. En ambos casos el FDC debe ocurrir en un proceso que est usando el administrador de cola QM1: strmqtrc -m QM1 -b FDC=KN346050 -c FDC=KN346080 Los siguientes ejemplos usan las seales -p y -m para mostrar lo siguiente: Como una combinacin de parmetros en una llamada individual del comando son interpretados por WebSphere MQ segn un tengan un booleano entre ellos AND. Como multiples invocaciones del comando, sin una intervencin del comando enqmqtrc, son interpretadas por WebSphere MQ como un OR lgico entre ellos:
Este comando active el trazado para todos los hilos que resultan desde cualquier proceso en ejecucin llamado amqxxx.exe: strmqtrc -p amqxxx.exe
Si inicias el siguiente comando despus del paso 1, sin una intervencin de comando endmqtrc, entonces el trazado est limitado a todos los hilos que resultan desde cualquier proceso de ejecucin llamado amqxxx.exe y que estn usando el administrador de cola QM2:
strmqtrc -p amqxxx.exe -m QM2 Si inicias el siguiente comando despus del comando del paso 1, sin una intervencin del comando endmqtrc, entonces el trazado est limitado a todos los procesos e hilos que resultan de la ejecucin de amqxxx.exe o que estn usando el administrador de cola QM2: strmqtrc -m QM2
2.57.7
Comando Descripcin
Visualiza salida de traza formateada Finaliza la traza
dspmqtrc endmqtrc

Comandos de Control - MQ Series

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Comandos de Control - MQ Series

Hochgeladen von

Copyright:

Verfügbare Formate

endmqsvc: endmqtrc: migmbbrk:

.------------------------. .- -s -QueueManager-. V | >>-addmqinf -+-------------------+---- -v - Attribute= Value-+->< '- -s -StanzaType---'

Tabla 1. Atributos de grupo QueueManager

UNIX: Opcional Windows: Necesario

Es usado para configurar o controlar algunas tareas administrativas especficas de Windows.

Palabras clave y parmetros

qmgr end QMgrName

amqmdain qmgr alter QmgrName x set

amqmdain qmgr alter QmgrName x unset

regsec spn QMgrName set | unset reg QMgrName

amqmfsck (comprueba el sistema de ficheros)

-d DefaultTransmission Queue -g ApplicationGroup

-lc -ld LogPath

-ll -lp LogPrimaryFiles

>>-dltmqm--+------+--QMgrName---------------------------------->< '- -z -'

>>-dmpmqaut--+-------------------------+--+--------------+------> '- -m --NombreGestorColas-' +- -n --Perfil-+ +- -l ---------+ '- -a ---------' >--+------------------+--+--------------------------+----------->

>--+-----------------------+--+------+------------------------->< +- -p --NombrePrincipal-+ +- -e -+ '- -g --NombreGrupo-----' '- -x -'

-x [ all | object | authrec | chlauth | sub ] -a -sSeqNumber -z -n [ * | ObjectName ] -t

-o[ mqsc | 1line | setmqaut |

mqsc 1line setmqaut

Dump start point

Estados del Administrador de Cola

Yes Yes No Yes No No Yes No No Yes Yes Yes Yes Yes No No No No No No No No No No No No

Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No

Yes Yes No Yes No No Yes No No Yes Yes No Yes Yes No No No No No No No No No No No No

alladm allmqi altusr browse chg

Publish a message on a topic using the MQPUT call.

Resume a subscription using the MQSUB call.

Create, alter, or resume a subscription to a topic using the MQSUB call.

>>-dspmqfls--+----------------+--+---------------+--------------> '- -m --QMgrName-' '- -t --ObjType-' >--GenericObjName----------------------------------------------><

.- -s -QueueManager-. .- -o -stanza--. >>-dspmqinf -+-------------------+--+--------------+--StanzaName->< '- -s -StanzaType---' '- -o -command-'

Opciones de generacin: -ac

-ro none | ReportOption

-v summary | all | none | outline OpcinVisualizacin

2.23 Parmetros opcionales

forget command. This transaction state is termed heuristically completed by X/Open.

.- -c -. >>-endmqcsv--+------+--QMgrName-------------------------------->< '- -i -'

The following saturn.queue.manager:

>>-endmqlsr--+------+--+----------------+---------------------->< '- -w -' '- -m --QMgrName-'

.- -c -. >>-endmqm--+------+--+-+------+--+------+-+--QMgrName---------->< '- -z -' | +- -w -+ +- -s -+ | | +- -i -+ '- -r -' | | '- -p -' | '- -x ---------------'

endmqsvc (finalizar servicio IBM WebSphere MQ)

El comando endmqsvc finaliza el servicio IBM WebSphere MQ en Windows. (Slo Windows).

.----------. V | >>-migmbbrk--+- -c -+----+------+-+-- -b --BrokerName---------->< +- -r -+ +- -l -+ '- -t -' +- -o -+ +- -s -+ '- -z -'

Supported operating systems

mqrc (MQ Cd. Ret.)

returnCode AMQmessage symbol -a -b -f first -l last -m AMQmessage -M -r returnCode -R -s symbol

>>-rcrmqobj--+----------------+--+------+-- -t ObjectType-------> '- -m --QMgrName-' '- -z -' >--GenericObjName----------------------------------------------><

.- -s -QueueManager-. >>-rmvmqinf -+-------------------+--StanzaName----------------->< '- -s -StanzaType---'

HEURISTICALLY COMPLETED TRANSACTIONS

>>-runmqchi--+-----------------------+--+----------------+----->< '- -q --InitiationQName-' '- -m --QMgrName-'

>>-runmqchl-- -c --ChannelName--+----------------+------------->< '- -m --QMgrName-'

>>-runmqdlq--+-------------------------+----------------------->< '- QName --+------------+-' '- QMgrName -'

>>-runmqdnm-- -q --QueueName-- -a --AssemblyName----------------> >--+----------------+--+-----------------+----------------------> '- -m --QMgrName-' '- -c --ClassName-'

| V | | '- spx ----+---------------+-+-------------------------------' +- -x --Socket--+ '- -b --Backlog-' >--+----------------+------------------------------------------>< '- -m --QMgrName-'

-a Adapter -l LocalName -e Names -s Sessions -o Commands -x Socket -m QMgrName -b Backlog

RUN COMMAND DIRECTLY

RUN COMMAND INDIRECTLY

>>-runmqtmc--+----------------+--+-----------------------+------> '- -m --QMgrName-' '- -q --InitiationQName-' >--+-----+----------------------------------------------------->< '- -r '

>>-runmqtrm--+----------------+--+-----------------------+----->< '- -m --QMgrName-' '- -q --InitiationQName-'

setmqaut -m QMGR -t qmgr -p user1 +connect

profile: object type: entity: entity type: authority:

@class queue test principal crt