Comandos de Control

Comandos de Control
Comandos de Control
Cap. 1 Cap. 1 Lista de Comandos Lista de Comandos
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.
addmqinf: Aade informacin de configuracin MQ Webp!ere "olo plataformas Windo#s $
%&I'(.
amqmdain: Es usado para configurar o controlar algunas tareas administrati)as espec*ficas de
Windo#s.
amqmfsc+: "comprueba sistema de fic!eros(. amqmfsc+ comprueba si es compartido un sistema
de fic!eros en sistemas %&I' e I,M- i buscandos los requerimientos para
asignacin de los datos del administrador de colas de un administrador de colas
multi.instancia.
crtmqc)/: 0rea cdigo de con)ersin de datos desde estructuras de tipo dato.
crtmqen): 0rea una lista de )ariables de entorno para una instalacin de Webp!ere MQ1 en
%&I'1 2inu/1 $ Windo#s.
crtmqinst: 0rea entradas de instalacin en mqinst.ini de sistemas %&I' $ 2inu/.
crtmqm: 0rea un administrador de 0olas
dltmqinst: ,orra entradas de instalacin para mqinst.ini en sistemas %&I' $ 2inu/.
dltmqm: ,orra un administrador de colas.
dmpmqaut: 3uelca una lista de autori4aciones actuales para un rango de tipos de ob5eto $
perfiles Webp!ere MQ.
dmpmqcfg: %sa el dmpmqcfg para )olcar la configuracin de un administrador de colas
Webp!ere MQ.
dmpmqlog: 3isuali4a $ formatea una porcin del 2og de sistema Webp!ere MQ.
dspmq: 3isuali4a informacin sobre los administradores de cola.
dspmqaut: 3isuali4a las autori4aciones de un ob5eto espec*fico Webp!ere MQ.
dspmqcs): 3isuali4a el estado de un ser)idor de comando.
dspmqfls: 3isuali4a nombres de fic!ero correspondientes a ob5etos Webp!ere MQ.
dspmqinf: 3isuali4a informacin de configuracin Webp!ere MQ "lo 6lataformas .Windo#s $
%&I'(.
dspmqinst: 3isuali4a entradas de instalacin desde mqinst.ini en %&I'1 2inu/1 $ Windo#s.
dspmqrte: Determina la ruta que un mensa5e !a tomado a tra)s de una red de administrador
de cola.
dspmqspl: 3isuali4a una lista de todos los )ig*as $ detalles de un )ig*a nombrado.
dspmqtrc: 7ormatea $ )isuali4a tra4a de Webp!ere MQ "lo plataformas %ni/(.
dspmqtrn: 3isuali4a en.doubt $ !eur*sticamente transacciones completadas.
dspmq)er: 3isuali4a )ersin de Webp!ere MQ e informacin de construccin.
endmqcs): 6ara el ser)idor de comandos para un administrador de colas
endmqlsr: 7inali4a todos los procesos 2istener para un administrador de colas.
endmqdnm: 6ara el monitor .&E8 para una cola "lo Windo#s(.
endmqm: 6ara el administrador de colas o cambia a un estado dormido.
endmqs)c: 7inali4a el ser)icio Webp!ere MQ I,M en Windo#s. "E5ecuta el comando slo en
Windo#s(.
endmqtrc: 7inali4a la tra4a para algunos o todas las entidades que est9n con la tra4a iniciada.
migmbbr+: El comando migmbbr+ migra los datos de configuracin publis!:subscribe de
Webp!ere E)ent ,ro+er 3ersin ;.< Webp!ere Message ,ro+er 3ersin ;.< ;.=
a Webp!ere MQ 3ersin >.<.= )ersiones posteriores.
mqrc: "cdigo retorno MQ( 3isuali4a informacin sobre cdigos de retorno.
rcdmqimg: Escribe la imagen de un ob5eto o grupo de ob5etos al log para medio de recuperacin.
rcrmqob5: ?ecrea un ob5eto1 o grupo de ob5etos1 desde sus im9genes contenidas en el log.
rm)mqinf: ?etira informacin de configuracin Webp!ere MQ "slo plataformas Windo#s $
%&I'(.
rs)mqtrn: 0onfirma o retrocede una transaccin "0ommit or bac+ out(
runmqc!i: E5ecuta un proceso iniciador de canal para automati4ar inicio de canales.
runmqc!l: Inicia un canal emisor o peticionario.
runmqdlq: Iniciali4a el canal de cola muerta para monitori4ar $ procesar mensa5es en la cola
muerta.
runmqdnm: Inicia procesado de mensa5es en una cola usando el monitor .&E8 "slo Windo#s(.
runmqlsr: E5ecuta un proceso listener para listado de peticiones remotas en )arios protocolos
de comunicacin.
runmqsc: E5ecuta comandos Webp!ere MQ en un administrador de cola.
runmqtmc: Inicia el monitor de disparo en un cliente.
runmqtrm: Inicia el monitor de disparo en un ser)idor.
runs#c!l: 0ambia de cluster el canal en %&I'1 2inu/1 $ Windo#s.
setmqaut: 0ambia las autori4aciones a un perfil1 ob5eto1 o clase de ob5etos. 2as autori4aciones
pueden garanti4arse1 o re)ocarse1 cualquier n@mero de principales o grupos.
setmqcrl: Administrador 0?2 "lista de re)ocacin de certificado( definiciones 2DA6 en un
Directorio Acti)o "slo Windo#s(.
setmqen): elecciona el entorno Webp!ere MQ1 en %&I'1 2inu/1 $ Windo#s.
setmqinst: elecciona instalaciones Webp!ere MQ1 en %&I'1 2inu/1 $ Windo#s.
setmqm: elecciona la instalacin asociada de un administrador de cola.
setmqspl: Define una nue)a pol*tica de seguridad1 despus que $a e/iste una1 o retira una
e/istente.
setmqprd: Matricula una licencia de produccin Webp!ere MQ.
setmqscp: 6ublica definiciones de canal de cone/in cliente en un Directorio Acti)o "lo
Windo#s(.
strmqcfg: Inicia un E/plorador Webp!ere MQ "lo 6lataformas Windo#s1 2inu/ /A;1 $ 2inu/
/A;.;B(.
strmqcs): Inicia el ser)idor de comando para un administrador de cola.
trmqs)c: Inicia ser)icio I,M Webp!ere MQ "solo Windo#s(.
strmqm: Inicia un administrador de cola o lo !abilita para operaciones de reser)a.
strmqtrc: Acti)a 8ra4a en un ni)el de detalle especificado1 o informa del ni)el de tra4ado en
efecto.
Cap. 2 Cap. 2 Detalle de Comandos Detalle de Comandos
2.1 Addmqinf
Aade informacin de configuracin MQ Webp!ere "olo plataformas Windo#s $ %&I'(.
2.1.1Propsito
%se el comando addmqinf para aadir informacin a los datos de configuracin
Webp!ere MQ.
6or e5emplo1 usar dspmqinf $ addmqinf para copiar datos de configuracin desde el
sistema donde un administrador de cola !a sido definido1 a otro sistema donde el mismo
administrador de cola mult.instancia tambin est9 para ser iniciado.
2.1.2Sintaxis
.------------------------.
.- -s -QueueManager-. V |
>>-addmqinf -+-------------------+---- -v - Attribute= Value-+-><
'- -s -Stanza!"e---'
2.1.3Parmetros necesarios
Parmetro Descripcin
-v
Attribute=Value
El nombre $ )alor de los atributos de estrofa a ser colocados en la estrofa especificada en
el comando.
2a siguiente tabla lista los )alores de atributos de estrofa QueueManager. 2a estrofa
administrador de cola es la @nica estrofa que est9 soportada actualmente.
Tabla 1. Atributos de grupo ueue!anager
Atributo "alor #ecesario$%pcional
#ame El nombre del administrador de cola.
Debe suministrar un Cou must pro)ide a different
name from an$ ot!er queue manager stan4a on
t!e s$stem.
&ecesario
Prefi& 8!e director$ pat! under #!ic! t!is queue
manager data director$ is stored b$ default.
Cou can use 6refi/ to modif$ t!e location of t!e
queue manager data directories. 8!e )alue of
Director' is automaticall$ appended to t!is pat!.
&ecesario
Director' 8!e name of t!e queue manager data director$.
ometimes t!e name must be pro)ided "as in
E/ample(1 because it is different from t!e queue
manager name. 0op$ t!e director$ name from t!e
)alue returned b$ dspmqinf.
8!e rules for transforming queue manager names
into director$ names are described in
%nderstanding Webp!ere MQ file names.
&ecesario
DataPat( 8!e director$ pat! #!ere t!e queue manager data
files are placed. 8!e )alue of Director' is not
automaticall$ appended to t!is pat! . $ou must
pro)ide t!e transformed queue manager name as
part of Data6at!.
If t!e Data6at! attribute is omitted on %&I'1 t!e
queue manager data director$ pat! is defined as
Prefix:Directory.
%&I': Dpcional
Windo#s: &ecesario
2.1.4Parmetros opcionales
Parmetro Descripcin
-s StanzaType %n estrofa del tipo StanzaType es aadida a la configuracin de Webp!ere MQ.
El )alor por defecto de StanzaType es ueue!anager.
El @nico )alor soportado de StanzaType is ueue!anager.
2.1.5Cdigos de retorno
Cd. )et. Descripcin
< Dperacin e/itosa
= 2ocali4acin de administrador de cola no )9lida "bien 6refi5o o ?utaDatos(
EF 6ar9metros de l*nea.de.comandos malos
BG 2a estrofa $a e/iste
B; Est9 desaparecido atributo de configuracin necesario
GA Inconsistencia de uso de instalaciones detectadas.
;F Almacenamiento no disponible
>= Error inesperado
>H Error en nombre de administrador de cola
=<< 2ocali4acin de 2og no )9lida
2.1.6Ejemplo
addmqinf #v $ata%at&='MQ(A'qmgrs'QM)*AM+
-v %refi,='var'mqm
-v $ire-t.r!=QM)*AM+
-v *ame=QM.*AM+
Define la siguiente estancia en mqs.ini:
ueue!anager:
*ame=QM.*AM+
%refi,='var'mqm
$ire-t.r!=QM)*AM+
$ata%at&='MQ(A'qmgrs'QM)*AM+
2.1.7otas de !so
%sar dspmqinf con addmqinf para definir una instancia de un administrador de cola
multi.instancia en un ser)idor diferente.
6ara usar este comando debe ser un administrador de Webp!ere MQ $ un miembro del
grupo mqm.
2.1."Comandos relacionados
Command Descripcin
dspmqinf 3isuali4a informacin de configuracin de Webp!ere MQ
rm)mqinf ?etira informacin de configuracin Webp!ere MQ
2.2 amqmdain
Es usado para configurar o controlar algunas tareas administrati)as espec*ficas de
Windo#s.
2.2.1Propsito
Aplicable solo a Webp!ere- MQ para Windo#s.
%sado para reali4ar algunas tareas administrati)as espec*ficas de Windo#s. Inicia un
administrador de cola con amqmdain es equi)alente a usar el commando strmqm con la opcin
-ss. amqmdain reali4a la e5ecucin del administrador de colas en una sesin no.interacti)a ba5o
una cuenta de usuario diferente. in embargo1 para asegurar que todos los administradores de colas
que iniciaron la regeneraron se de)uel)e a la l*nea de comando1 usa el comando strmqm -ss me5or
que amqmdain.
Debe usarse el commando amqmdain desde la instalacin asociada con el administrador
de cola con el que est9s traba5ando. 6uedes buscar qu instalacin del administrador de cola est9
asociado con el usando el commando de instalacin dspmq -o.
6ara administrar $ definer el ser)icio $ ob5etos listener de Webp!ere MQ1 usar comandos
MQ01 comandos 6071 o el E/plorador Webp!ere MQ.
El comando amqmdain !a sido actuali4ado para modificar bien los fic!eros .ini o el registro
seg@n proceda.
2.2.2Sintaxis
>>-amqmdain----------------------------------------------------->
>--+- qmgr start --QMgrName--------------------------+---------><
| .- -- -. |
+- qmgr end --QMgrName--+-+------+--+------+-+----+
| | +- -/ -+ +- -s -+ | |
| | +- -i -+ '- -r -' | |
| | '- -" -' | |
| '- -, ---------------' |
+- qmgr alter --QMgrName--+---------------------+-+
| +- -i --Initiation----+ |
| '- -,--Multi-instance-' |
+- refres& ---------------------------------------+
+- aut. --QMgrName--------------------------------+
+- manual --QMgrName------------------------------+
+- status --+----------+--------------------------+
| +-QMgrName-+ |
| '-all------' |
+- regse- ----------------------------------------+
+- s"n --QMgrName--+-set---+----------------------+
| '-unset-' |
'- reg --+----------+--RegParams------------------'
+-QMgrName-+
'- 0 ------'
2.2.3Pala#ras cla$e % parmetros
on necesarios todos los par9metros a menos que la descripcin de estados All sean
opcionales.
En cualquier caso1 QMgrName es el nombre del administrador de cola para el que se
aplican los comandos.
Parmetro Descripcin
qmgr start
QMgrName
Inicia un administrador de cola.
Este par9metro puede tambin ser escrito en el formato start QMgrName.
i inicias el administrador de cola como un ser)icio $ necesitas que el administrador de
cola contin@e e5ecut9ndose despus de terminar la sesin1 usar el comando strmqm -ss
qmgr en lugar de amqmdain start qmgr.
qmgr end
QMgrName
7inali4a un administrador de cola.
Este par9metro puede tambin escribirse en el formato end !gr#ame.
6ara consistencia en plataformas cru4adas1 usar endmqm qmgr en lugar de amqmdain
end qmgr. 6ara una completa descripcin de las opciones1 consultar endmqm.
Parmetro Descripcin
-c Apagado controlado "o inacti)o(.
-* Apagado con espera.
-i Apagado inmediato.
-p Apagado pre)enti)o.
-r ?econectar clientes.
-s 0onmuta entre una instancia administrador de cola de reser)a.
-& 7inali4a la instancia de reser)e de una administrador de cola sin finali4ar la instancia acti)a.
qmgr alter
QMgrName
Altera un administrador de cola.
-i +nitiation Especifica el tipo de iniciacin. 2os )alores posibles son:
3alor Descripcin
auto ets t!e queue manager to automatic startup "#!en t!e mac!ine starts1 or
more precisel$ #!en t!e Webp!ere MQ ser)ice starts(. 8!e s$nta/ is:
amqmdain qmgr alter Qmgr&ame Ii auto
interactive ets t!e queue manager to manual startup t!at t!en runs under t!e logged
on "interacti)e( user. 8!e s$nta/ is:
amqmdain qmgr alter Qmgr&ame Ii interacti)e
service ets t!e queue manager to manual startup t!at t!en runs as a ser)ice. 8!e
s$nta/ is:
amqmdain qmgr alter Qmgr&ame Ii ser)ice
-& !ulti-instance pecifies if auto queue manager start b$ t!e Webp!ere MQ ser)ice permits multiple
instances. Equi)alent to t!e .sa/ option on t!e crtmqm command. Also specifies if t!e
amqmdain start qmgr command permits standb$ instances. 6ossible )alues are:
3alor Descripcin
set ets automatic queue manager startup to permit multiple instances. Issues
strmqm ./. 8!e set option is ignored for queue managers t!at are initiated
interacti)el$ or as a manual ser)ice startup. 8!e s$nta/ of t!e command is:
amqmdain qmgr alter Qmgr*ame #, set
unset elecciona autom9ticamente el inicio del administrador de cola a una
simple instancia. Emitir strmqm. 2a opcion unset es ignorada para
administradores de cola que son iniciados interacti)amente o como un
inicio de ser)icio manual. 2a sint9/is del commando es:
amqmdain qmgr alter Qmgr*ame #, unset
refres( ?efresca o c!equea el estado de un administrador de cola. &o )er9s ning@n retorno en la
pantalla despus de e5ecutar este commando.
auto !gr#ame ets a queue manager to automatic startup.
manual
!gr#ame
elecciona un administrador de cola para inicio manual.
status
!gr#ame , all
Este par9metro es opcional.
i no es suministrado par9metro: 3isuali4a el estado de los ser)icios Webp!ere MQ.
i es suministrado un
QMgr&ame:
3isuali4a estado del administrador de cola nombrado.
i es suministado el par9metro
all:
3isuali4a estado de los ser)icios Webp!ere MQ $
todos los administradores de cola.
regsec Ensures t!at t!e securit$ permissions assigned to t!e ?egistr$ +e$s containing installation
information are correct.
spn !gr#ame
set , unset
6uedes seleccionar agrupado o desagrupado el nombre de ser)icio principal para un
administrador de cola.
reg QMgrName ,
- RegParams
2os par9metros QMgrName1 $ - son opcionales.
i solo es especificado RegParams: Modifies queue manager configuration
information related to t!e default queue manager.
i son especificados QMgrName $
RegParams:
Modifies queue manager configuration
information related to t!e queue manager specified
b$ QMgr&ame.
i son especificados * $ RegParams: Modifies .eb/p(ere ! configuration
information.
El par9metro1 RegParams1 especifica la estrofa a cambiar1 $ los cambios a reali4ar.
RegParams toma uno de los formatos siguientes:
-c a!! -s stanza -" attribute#"alue
-c remo"e -s stanza -" $attribute%*&
-c !isplay -s stanza -" $attribute%*&
i !as especificado una informacin de configuracin del administrador de cola1 los )alores
)9lidos para la estrofa son :
1A2es.ur-eManager3name
A"i+,it4.-al3name
5&annels
+,it%at&
QueueManagerStartu"
5%
4678
S%1
QM+rr.r4.g
9r.:er
+,it%r."erties4.-al
Parmetro Descripcin
;nstan-e$ata
4.g
*et9i.s
5.nne-ti.n
SS4
i $a !as modificado informacin de configuracin Webp!ere MQ1 los )alres )9lidos para
la estrofa son:
A"i+,it5.mm.n3name
A"i+,item"late3name
A5%;
AllQueueManagers
5&annels
$efaultQueueManager
4.g$efaults
+,it%r."erties
8!e follo#ing are usage considerations:
amqmdain does not )alidate t!e )alues $ou specif$ for name1 attribute1 or )alue.
W!en $ou specif$ add1 and an attribute e/ists1 it is modified.
If a stan4a does not e/ist1 amqmdain creates it.
W!en $ou specif$ remo)e1 $ou can use t!e )alue J to remo)e all attributes.
W!en $ou specif$ displa$1 $ou can use t!e )alue J to displa$ all attributes #!ic!
!a)e been defined. 8!is )alue onl$ displa$s t!e attributes #!ic! !a)e been defined
and not t!e complete list of )alid attributes.
If $ou use remo)e to delete t!e onl$ attribute in a stan4a1 t!e stan4a itself is
deleted.
An$ modification $ou ma+e to t!e ?egistr$ re.secures all Webp!ere MQ ?egistr$ entries.
2.2.4Ejemplos
El e5emplo siguiente aade un 0A)esource!anager al 8est administrador de cola. 2os
comandos emitidos son:
amqmdain reg +S -- add -s 1A2es.ur-eManager3Sam"le -v S/it-&<ile=sf=
amqmdain reg +S -- add -s 1A2es.ur-eManager3Sam"le -v &read>f5.ntr.l=(2+A$
amqmdain reg +S -- add -s 1A2es.ur-eManager3Sam"le -v 1A>"enString=."enit
amqmdain reg +S -- add -s 1A2es.ur-eManager3Sam"le -v 1A5l.seString=-l.seit
. dis"la! t&e values set b! t&e -.mmands ab.ve? use@
amqmdain reg +S -- dis"la! -s 1A2es.ur-eManager3Sam"le -v 0
2a )isuali4acin deber*a aseme5arse a lo siguiente:
ABCDB87? E7FG-9DF H5I 5."!rig&t ;9M 5.r". =GGD? 8AA8. A44 2;J(S 2+S+2V+$.
$is"la!ing registr! value f.r Queue Manager '+S'
Attribute = *ame? Value = Sam"le
Attribute = S/it-&<ile? Value = sf=
Attribute = &read>f5.ntr.l? Value = (2+A$
Attribute = 1A>"enString? Value = ."enit
Attribute = 1A5l.seString? Value = -l.seit
6ara retirar el 0A)esource!anager del 8est administrador de cola1 usa:
amqmdain reg +S -- rem.ve -s 1A2es.ur-eManager3Sam"le -v 0
Cd. )et.
Descripcin
< 0omando completado normalmente
.H Error de sint9/is
.E Iniciali4acin fallida de M70
.; 7eature no longer supported
.> 0onfiguration failed
.F %ne/pected ?egistr$ error
.=; 7ailed to configure ser)ice principal name
.HF Inconsistencia de uso de instalaciones detectadas.
;H 8!e queue manager is associated #it! a different installation
>= Error ine/perado
==F 6ermission denied "Windo#s onl$(
Nota' Si es emitido el comando qmgr start !gr#ame( to!os los c)!igos !e
retorno *ue pue!en ser !e"ueltos con strmqm( tambin pueden ser devueltos+
Para una lista de cdigos de retorno, consultar strm*m+
Si es emitido el comando qmgr end !gr#ame( todos los cdigos que pueden
ser devueltos con en!m*m( pueden tambin ser retornados+ Para una lista de
estos cdigos de retorno, consultar en!m*m+
2.3 amqmfsck (comprueba el sistema de ficheros)
amqmfsc1 comprueba si un sistema de fic!eros compartido en sistemas %&I' e I,M-
reune los requerimientos para asignar datos de administrador de cola de un administrador de cola
multi.instancia.
2.3.1Propsito
El commando amqmfsc1 se aplica solo a sistemas %&I' e I,M- i. &o necesitas comprobar
la uniad de red en Windo#s. amqmfsc1 testea que un sistema de fic!ero canali4a correctamente
escrituras a un fic!ero $ la espera $ libera bloqueos.
2.3.2Sintaxis
>>-amqmfs-:--+-----+--+-----------------------------+--DirectoryName-><
'- -v-' +- -a ------------------------+
+- -- ------------------------+
+- -f -+--------------------+-+
| | .-878=DD----. | |
| '- -" -+-PageCount-+-' |
+- -i ------------------------+
+- -/ ------------------------+
'- - , -----------------------'
DirectoryName El nombre del directorio a comprobar.
Parmetro Descripcin
-a ?eali4a la segunda fase del test de integridad de datos. E5ecuta esto en dos m9quinas al mismo
tiempo. Debes tener formateado el fuc!ero de test usando la opcin 2f pre)iamente
-c 8est #riting to a file in t!e director$ concurrentl$.
-f 6erform t!e first p!ase of t!e data integrit$ test. 7ormats a file in t!e director$ in preparation for
data integrit$ testing.
-i 6erform t!e t!ird p!ase of t!e data integrit$ test.
0!ec+s t!e integrit$ of t!e file after t!e failure to disco)er #!et!er t!e test #or+ed.
-p pecifies t!e si4e of t!e test file used in t!e data integrit$ test in pages. .
8!e si4e is rounded up to t!e nearest multiple of =; pages. 8!e file is formatted #it! PageCount
pages of B K,.
8!e optimum si4e of t!e file depends on t!e speed of t!e files$stem and t!e nature of t!e test
$ou perform. If t!is parameter is omitted1 t!e test file is H;H=BB pages1 or = L,.
8!e si4e is automaticall$ reduced so t!at t!e formatting completes in about ;< seconds e)en on a
)er$ slo# files$stem.
-v 3erbose output.
-* 8estea esperando para liberar bloqueos.
-& Deletes an$ files created b$ amqmfsc+ during t!e testing of t!e director$.
Do not use t!is option until $ou !a)e completed t!e testing1 or if $ou need to c!ange t!e number
of pages used in t!e integrit$ test.
2.3.5!so
Debes ser un administrador Webp!ere MQ para e5ecutar el commando. Debes tener
acceso de lectura:escritura para el directorio que se !a de comprobar.
En I,M i1 usa QM para e5ecutar el programa. &o es un comando 02.
El commando de)uel)e un cdigo de salida de < si el test tiene /ito completo.
2a tarea1 3erif$ing s!ared file s$stem be!a)ior1 describe como usar amqmfsc1 para
comprobar si un fic!ero de sistema es con)eniente para administradores de cola multi.instancia.
2.3.6&nterpretacin de res'ltados
If t!e c!ec+ fails1 t!e file s$stem is not capable of being used b$ Webp!ere MQ queue
managers. If t!e tests fail1 c!oose )erbose mode to !elp $ou to interpret t!e errors. 8!e output from
t!e )erbose option !elps $ou understand #!$ t!e command failed1 and if t!e problem can be sol)ed
b$ reconfiguring t!e file s$stem.
ometimes t!e failure mig!t be an access control problem t!at can be fi/ed b$ c!anging
director$ o#ners!ip or permissions. ometimes t!e failure can be fi/ed b$ reconfiguring t!e file
s$stem to be!a)e in a different #a$. 7or e/ample1 some file s$stems !a)e performance options t!at
mig!t need to be c!anged. It is also possible t!at t!e file s$stem protocol does not support
concurrenc$ sufficientl$ robustl$1 and $ou must use a different file s$stem. 7or e/ample1 $ou must
use &7)B rat!er t!an &7)E.
If t!e c!ec+ succeeds1 t!e command reports 8!e tests on t!e director$ completed
successfull$. If $our en)ironment is not listed as supported in t!e testing and support statement1
t!is result does not necessaril$ mean t!at $ou can run Webp!ere MQ multi.instance queue
managers successfull$. Cou must plan and run a )ariet$ of tests to satisf$ $ourself t!at $ou !a)e
co)ered all foreseeable circumstances. ome failures are intermittent1 and t!ere is a better c!ance
of disco)ering t!em if $ou run t!e tests more t!an once.
2.3.7(areas relacionadas)
3erif$ing s!ared file s$stem be!a)ior
2.4 crtmqcvx
Define cdigo de con)ersion de datos desde estructuras de tipo dato.
2.4.1Propsito
%se el commando crtmqcv& para definer un fragment de cdigo que reali4e con)ersion de
datos en estructuras de tipo dato. El comando genera una function 0 que puede ser usada en una
salida a con)ertir estructuras 0.
El commando lee un fic!ero de entrada conteniento estructuras a ser con)ertidas1 $ escribe
un fic!ero de alida conteniendo fragmentos de aquellas estructuras a con)ertir.
6ara informacin sobre el uso de este commando1 consulta %tilit$ for creating con)ersion.
e/it code.
2.4.2Sintaxis
>>--rtmq-v,--SourceFile--TargetFile----------------------------><
Parmetro Descripcin
Source,ile El fic!ero conteniendo las estructuras 0 a con)ertir.
Target,ile El fic!ero de salida conteniendo los fragmentos de cdigo generados para con)ertir las
estructuras.
Cd. )et. Descripcin
=< 0omando completado con resultados ine/perados
H< Ma ocurrido un error durante el proceso
2.4.5Ejemplos
El siguiente e5emplo muestra los resultados de uso del commando de con)ersion de datos
nue)amente en una estructura fuente 0. El comando emitido es:
-rtmq-v, fuente.tm" destin..-
El fic!ero de entrada1 fuente.tmp1 se )er9 seme5ante a esto:
'0 +ste es una estru-tura 5 de test que "uede ser -.nvertida 0'
'0 ".r la utilidad -rtmq-v, 0'
stru-t miKestru-tura
L
int -.deM
MQ4>*J valueM
NM
El fic!ero de salida1 !estino+c. producido por el comando1 se aseme5ar9 a esto:
MQ4>*J 5.nvertm!Kstru-tureH
%MQ$1% "+,it%arms?
%MQ9O+ 0inK-urs.r?
%MQ9O+ 0.utK-urs.r?
%MQ9O+ inKlastb!te?
%MQ9O+ .utKlastb!te?
MQ(5>** &5.nn?
MQ4>*J ."ts?
MQ4>*J Msg+n-.ding?
MQ4>*J 2eq+n-.ding?
MQ4>*J Msg55S;$?
MQ4>*J 2eq55S;$?
MQ4>*J 5.m"5.de?
MQ4>*J 2eas.nI
L
MQ4>*J 2eturn5.de = MQ25K*>*+M

5.nvert4.ngH=IM '0 -.de 0'

Align4.ngHIM
5.nvert4.ngH=IM '0 value 0'

<ail@
returnH2eturn5.deIM
N
6uedes usar este fragmento de cdigo en tus aplicaciones para con)ertir estructuras de
datos. in embargo1 si lo !aces1 el fragmento usa macros suplidas en el fic!ero de cabecera
am*s"m-a+-.
2.5 crtmqenv
0rea una lista de )ariables de entorno para la instalacin de Webp!ere- MQ1 en %&I'1
2inu/1 $ Windo#s.
2.5.1Propsito
6uedes usar el commando crtmqenv para definer una lista de )ariables de entorno con los
)alores apropiados para una instalacin de Webp!ere MQ. 2a lista de )ariables de entorno son
)isuali4adas en la l*nea de commando1 $ cualquier )ariable que e/ista en el sistema tiene los )alores
Webp!ere MQ aadidos a ella. Este comando no selecciona )ariables de entorno1 pero guarda las
apropiadas cadenas para seleccionar las )ariables mismas1 por e5emplo1 con tus propios scripts.
i deseas seleccionar )ariables de entorno para tu capa de entorno1 puedes usar el
commando setmqen) en lugar de utili4ar el comando crtmqenv.
Cou can specif$ #!ic! installation t!e en)ironment is created for b$ specif$ing a queue
manager name1 an installation name1 or an installation pat!. Cou can also create t!e en)ironment
for t!e installation t!at issues t!e crtmqen) command b$ issuing t!e command #it! t!e .s
parameter.
Este commando lista las siguientes )ariables de entorno1 $ sus )alores1 apropiados para tu
sistema:
02A6A8M
I&02%DE
2I,
MA&6A8M
MQNDA8AN6A8M
MQNE&3NMDDE
MQN7I2EN6A8M
MQNOA3ANI&8A22N6A8M
MQNOA3ANDA8AN6A8M
MQNOA3AN2I,N6A8M
MQNOA3ANO3MN72AL
MQNO?EN6A8M
6A8M
En sistemas %&I' $ 2inu/1 si es especificada la seal -l o -11 la )ariable de entorno
!"P#T$ es seleccionada a AI'-1 $ la )ariable de entorno %&!"'#'(&P#T$ es seleccionada a M6.
%'1 2inu/1 $ olaris.
2.5.2otas de !so
El commando crtmqenv retira todos los directories para todas las instalaciones Webp!ere
MQ desde las )ariables de entorno antes de aadir nue)as referencias a la instalacin para la que
est9s a5ustando el entorno. 6or lo tanto1 si deseas seeccionar cualquier )ariable de entorno adicional
que referencie a Webp!ere MQ1 selecciona las )ariables despus de emitir el comando crtmqenv.
6or e5emplo1 si deseas aadir MQ&!NST##T!)N&P#T$:5a)a:lib a %&!"'#'(&P#T$1 debes !acerlo
despus de e5ecutar crtmqenv.
2.5.3Sintaxis
>>--rtmqenv--+- -m--QMgr*ame---------+--+-----+--+-----------+--+-----+-><
+- -n--;nstallati.n*ame-+ +- -:-+ '- -, -M.de-' '- -i-'
+- -"--;nstallati.n%at&-+ '- -l '
+- -r-------------------+
'- -s-------------------'
Parmetro Descripcin
-m QMgrName Define el entorno para la instalacin asociada con el administrador de cola QMgrName.
-n .nstallationName Define el entorno para la instalacin nombrada !nstallationName.
-p .nstallationPat- Define el entorno para la instalacin en la ruta !nstallationPat*.
-r ?etira todas las instalaciones para el entorno.
-s Define el entorno para la instalacin que !a emitido el comando.
Parmetro Descripcin
-1 %&I' and 2inu/ onl$.
Include t!e %&!"'#'(&P#T$ 1 or !"P#T$1 en)ironment )ariable in t!e en)ironment1 adding
t!e pat! to t!e Webp!ere MQ libraries at t!e start of t!e current %&!"'#'(&P#T$1 or
!"P#T$1 )ariable.
-l %&I' and 2inu/ onl$.
Include t!e %&!"'#'(&P#T$1 or !"P#T$1 en)ironment )ariable in t!e en)ironment1 adding
t!e pat! to t!e Webp!ere MQ libraries at t!e end of t!e current %&!"'#'(&P#T$1 or
!"P#T$1 )ariable.
-& Mo!e Mode can ta+e t!e )alue EH1 or ;B. 0reate a EH.bit or ;B.bit en)ironment.
If t!is parameter is not specified1 t!e en)ironment matc!es t!at of t!e queue manager or
installation specified in t!e command. An$ attempt to displa$ a ;B.bit en)ironment #it! a EH.
bit installation fails.
-+ 2ist onl$ t!e additions to t!e en)ironment.
W!en t!is parameter is specified1 t!e en)ironment )ariables set for pre)ious installations
remain in t!e en)ironment )ariable pat! and must be manuall$ remo)ed.
Cd. )et. Descripcin
< 0omando completado normalmente.
=< 0omando completado con resultados ine/perados.
H< Ma ocurrido un error durante el proceso.
2.5.7Ejemplos
2os siguientes e5emplos asumen que una copia de Webp!ere MQ est9 instalada en
$opt$mqm de un sistema %&I' o 2inu/.
=. Este comando define una lista de )ariables de entorno para una instalacin instalada en
/opt/m*m:
'."t'mqm'bin'-rtmqenv -s
H. Este commando define una lista de )ariables de entorno para una instalacin instalada
en :opt:mqmH1 e inclu$e la ruta de la instalacin al final del )alor actual de la )ariables
%&!"'#'(&P#T$:
'."t'mqm'bin'-rtmqenv -" '."t'mqm8 -l
E. Este commando define una lista de )ariables de entorno para el administrador de cola
QM=1 en un entorno de EH.bit:
'."t'mqm'bin'-rtmqenv -m QM= -, F8
B. El siguiente e5emplo assume que est9 instalada una copia de Webp!ere MQ en
c'0Program ,iles0.1M02ebSp-ere MQ de un sistema Windo#s. Este comando
define una lista de )ariables de entorno para una instalacin llamada instalacion3:
P-@3%r.gram <iles3;9M3QebS"&ere MQ3-rtmqenvP -n instala-i.n=
2.5."*e+erencia relacionada)
setmqen)
2.5.,&n+ormacin relacionada
0!oosing a primar$ installation
Multiple installations
2. crtmqinst
Define entradas de instalacin en m*inst+ini para sistemas %&I' $ 2inu/.
2.6.1Propsito
El fic!ero m*inst+ini contiene informacin sobre todas las instalaciones Webp!ere- MQ
en un sistema. 6ara m9s informacin sobre mqinst.ini1 see Installation configuration file1 mqinst.ini.
2a primera instalacin de Webp!ere MQ installation es guardada autom9ticamente en un
nombre de instalacin de Installation= $a que el comando crtmqinst no est9 disponible !asta que
una instalacin de Webp!ere MQ est9 en el sistema. Instalaciones siguientes pueden tener un
nombre de instalacin seleccionada antes de que ocurra la instalacin1 al usar el comando
crtmqinst. E2 nombre de instalacin no puede ser cambiado despus de la instalacin. 6ara m9s
informacin sobre nombres de instalacin1 consultar 0!oosing an installation name.
2.6.2Sintaxis
>>--rtmqinst----+- -" -InstallationPath----------------------------+--
+----------------------+---><
+- -n -InstallationName----------------------------+ '- -d
-DescriptiveText-'
| H=I |
+- -" -InstallationPath-- -n -InstallationName-----+
| H=I |
'- -n--InstallationName-- -" -InstallationPath-----'
Notas' Cuando se especi+ica con,untamente, el nombre de instalacin y la ruta de
instalacin deben re+erirse a la misma instalacin-
2.6.3Parmetros
Parmetro Descripcin
-d 8e/to que describe la instalacin.
El te/to puede ser de !asta ;B caracteres de b$te.simple1 o EH caracteres de b$te.
doble. El )alor por defecto es todo blancos. Debes usar las comillas para el te/to que
contenga blancos.
-n .nstallationName El nombre de la instalacin.
El nombre puede contener !asta =; caracteres de b$te.simple $ debe ser una
combinacin de caracteres algabticos $ numricos en los rangos de a.41 A.P1 $ <.F. El
nombre de instalacin debe ser @nico1 independiente de si se usan ma$@sculas o
min@sculas. 6or e5emplo1 los nombres I&8A2A5;>**>M92+ e Instalacion&ombre
no son @nios. i no suministras un nombre de instalacin1 es usado el siguiente nombre
disponible en la serie Installation=1 InstallationH....
-p .nstallationPat- 2a ruta de intalacin.
i no suministras la ruta de instalacin1 es usado1 :opt:mqm en sistemas %&I' $ 2inu/1
$ :usr:mqm en AI'.
Cd. )et. Descripcin
< Entrada creada sin error
=< &i)el de instalacin no )alido
E; Argumentos suplidos no )alidos
E> El te/to descripti)o est9 en error
BG Ca e/iste la entrada
GF Instalacin especificada no )9lida
>= Error ine/perado
AF .Error en fic!ero I&I
F; &o puede bloquear el fic!ero .I&I
FA Autoridad insuficiente para acceder a fic!ero .I&I
=E= 6roblema de recurso
2.6.5Ejemplo
Este commando define una entrada con un nombre de instalacin de miInstalacion1 una
ruta de instalacin de :opt:miInstalacion1 $ una descriocin QMi instalacin Webp!ere MQQ:
-rtmqinst -n Mi;nstala-i.n -" '."t'mi;nstala-i.n -d PMi instala-i.n QebS"&ere MQP
El encomillado es necesario $a que el te/to descripti)o contiene espacios.
2.! crtmqm
Define un administrador de cola.
2.7.1Propsito
%se el commando crtmqm para definir un administrador de cola $ definir los ob5etos $
sistema por defecto. 2os ob5etos definidos por crtmqm est9n listados en $stem and default
ob5ects. 0uando un administrador de cola !a sido definido1 usa el comando strmqm para iniciarlo.
El administrador de cola es asociado autom9ticamente con la instalacin desde el
commando crtmqm que !a sido emitido. 6ara cambiar la instalacin asociada1 usa el commando
setmqm. Dbser)a que el instalador de Windo#s no aade al usuario que reali4e la instalacin al
grupo de mqm1 para m9s detalles1 consulta Aut!orit$ to administer Webp!ere MQ on %&I'1 2inu/
and Windo#s s$stems.
2.7.2Sintaxis
>>--rtmqm--+-------------------------------------+-------------->
| H=I |
'- -a -+-Localroup-------------+-----'
+-lo!alroup------------+
+-Domain--3--lo!alroup-+
'-lo!alroup--R--Domain-'
>--+-----------+--+-------------------------------+------------->
'- -- -Text-' '- -d -De"aultTransmissionQueue-'
.- -l--.
>--+-------------------------+--+------+--+---------------+----->
'- -& -Maximum#an$leLimit-' '- -ll-' '- -ld -LogPath-'
>--+--------------------+--+-----------------------+------------>
'- -lf -LogFilePages-' '- -l" -LogPrimaryFiles-'
.- -ss--.
>--+-------------------------+--+-----+--+-------+-------------->
'- -ls -LogSecon$aryFiles-' '- -q ' +- -sa--+
+- -sa,-+
'- -si--'
>--+----------------+--+-----------------------+---------------->
'- -md -DataPath-' '- -g -%pplicationroup-'
>--+--------------------+--+----------------------+------------->
'- -t -Interval&alue-' '- -u -Dea$LetterQueue-'
>--+---------------------------------+--+-----+--QMgrName------><
'- -, -Maximum'ncommitte$Messages-' '- -z '
Notas' Slo .indo/s
Parmetro Descripcin
QMgrName El nombre del administrador de cola a definir. El nombre puede contener !asta BA
caractres. Este par9metro debe ser el ultimo item del comando.
Parmetro Descripcin
-a 4ocal5roup%
Domain05lobal5rou
El nombre de un grupo de acceso de seguridad adicioal. Debes definir el grupo adicional
antes de e5ecutar el comando crtmqm con la opcin -a. El grupo es un gupo de
p%
5lobal5roup6Domai
n
seguridad global o local. Es t*picamente un grupo de seguridad global1 que es usado
para suministrar administradores de cola multi.instancia con acceso a carpeta de datos
$ logs de un administrador de cola compartido. %sa el grupo de acceso de seguridad
adicional para seleccionar permisos de lectura $ escritura en la carpeta o fic!eros de
datos $ logs contenidos en el administrador de cola compartido.
El grupo de acceso de seguridad adicional es una alternati)a a usar el grupo local mqm
8!e additional securit$ access group is an alternati)e to using t!e local group mqm to
set permissions on t!e folder containing queue manager data and logs. %nli+e t!e local
group mqm1 $ou can ma+e t!e additional securit$ access group a local or a global
group. It must be a global group to set permissions on t!e s!ared folders t!at contain
t!e data and log files used b$ multi.instance queue managers.
Windo#s c!ec+s t!e access permissions to read and #rite queue manager data and log
files. It c!ec+s t!e permissions of t!e user ID t!at is running queue manager processes.
W!ic! user ID is c!ec+ed depends on #!et!er $ou started t!e queue manager as a
ser)ice or started it interacti)el$. If $ou started t!e queue manager as a ser)ice1 t!e
user ID it c!ec+s is t!e one $ou configured #it! t!e Q6repare Webp!ere MQQ #i4ard. If
$ou started t!e queue manager interacti)el$1 it is t!e user ID t!at ran t!e strmqm
command.
8!e user ID must be a member of t!e local mqm group to start t!e queue manager. If
t!e user ID is a member of t!e additional securit$ access group1 t!e queue manager
can read and #rite files t!at are gi)en permissions using t!e group.
)estriction3 pecif$ an additional securit$ access group onl$ on Windo#s. If $ou
specif$ an additional securit$ access group on ot!er platforms1 t!e crtmqm command
returns an error.
-c Text 8e/to descripti)e para este administrador de cola. 6uedes usar !asta ;B caracteresR por
defecto es todo blancos.
i inclu$es caracteres especiales1 cierra la descripcin entre comillas. El m9/imo
n@mero de caracteres se reduce si el sistema usa el set de caracteres de b$te.doble
"D,0(.
-d
DefaultTransmission
Queue
El nombre de la cola de transmission local donde son colocados mensa5es remotes si
una cola de transmisin no est9 definida e/plicitamente por su destino. &o !a$ )alor
por defecto.
-g Application5roup El nombre del grupo conteniendo los miembros permitidos para:
E5ecutar aplicaciones MQI
Actuali4ar todos los recursos I600
0ambiar los contenidos de algunos directories de administracin de cola
Esta opcin se aplica solo para Webp!ere MQ para AI'-1 olaris1 M6.%'1 $ 2inu/.
El )alor por defecto es -g all1 que permite acceso no restringido.
El )alor -g Application5roup es registrado en el fic!ero de configuracin del
administrador de cola1 qm.ini.
E2 ID de usuario mqm $ el usuario e5ecutando el commando deben estar en el Lrupo
de Aplicacin especificado. 6ara m9s detalles de la operacin del modo restringido1
consultar Modo ?estringido.
-(
Maximum7an!le4imi
t
El m9/imo n@mero de anales que cualquier otra aplicacin puede tener abiertos a la
)e4.
Especifica un )alor en el rango de = . FFFFFFFFF. El )alor por defecto es HG;.
2as siguientes ; descripciones de par9metro relatan el 2ogeo1 que est9 descrito en %sar
el log para recuperacin.
Nota' 0legir los arreglos de logeo con cuidado, ya que algunos no pueden ser
cambiados despus de son con+irmados-
-lc %se circular logging. 8!is met!od is t!e default logging met!od.
-ld 4ogPat- 8!e director$ used to store log files. 8!e default director$ to store log pat!s is defined
#!en $ou install Webp!ere MQ.
If t!e )olume containing t!e log file director$ supports file securit$1 t!e log file director$
must !a)e access permissions. 8!e permissions must allo# t!e user IDs1 under #!ic!
aut!orit$ t!e queue manager runs1 read and #rite access to t!e director$ and its
subdirectories. Cou grant t!e user IDs1 and t!e mqm group1 permissions on t!e default
log director$ #!en $ou install Webp!ere MQ. If $ou set 2og6at! to #rite t!e log file to
a different director$1 $ou must grant t!e user IDs permission to read and #rite to t!e
director$. 8!e user ID and permissions are different for %&I' and 2inu/1 and for
Windo#s:
%&I' and 2inu/
8!e director$1 and subdirectories1 must be o#ned b$ t!e user mqm in t!e group mqm.
If t!e log file is s!ared bet#een different instances of t!e queue manager1 t!e securit$
identifiers "sid( t!at are used1 must be t!e same for t!e different instances. Cou must
!a)e set t!e user mqm to t!e same sid on t!e different ser)ers running instances of
t!e queue manager. 2i+e#ise for t!e group mqm.
Windo#s
If t!e director$ is accessed b$ onl$ one instance of t!e queue manager1 $ou must gi)e
read and #rite access permission to t!e director$ for t!e follo#ing groups and users:
8!e local group mqm
8!e local group Administrators
8!e C8EM user ID
8o gi)e different instances of a queue manager access to t!e s!ared log director$1 t!e
queue manager must access t!e log director$ using a global user. Li)e t!e global
group1 #!ic! contains t!e global user1 read and #rite access permission to t!e log
director$. 8!e global group is t!e additional securit$ access group specified in t!e .a
parameter.
In Webp!ere MQ for Windo#s s$stems1 t!e default is 0:S6rogram
7ilesSI,MSWebp!ere MQSlog "assuming t!at 0 is $our data dri)e(. If t!e )olume
supports file securit$1 t!e C8EM ID1 Administrators1 and mqm group must be granted
read:#rite access to t!e director$.
In Webp!ere MQ for %&I' and 2inu/ s$stems1 t!e default is :)ar:mqm:log. %ser ID
mqm and group mqm must !a)e full aut!orities to t!e log files.
If $ou c!ange t!e locations of t!ese files1 $ou must gi)e t!ese aut!orities $ourself. 8!is
aut!orities are set automaticall$1 if t!e log files are in t!eir default locations.
-lf 4og,ilePages 8!e log data is !eld in a series of files called log files. 8!e log file si4e is specified in
units of B K, pages.
In Webp!ere MQ for %&I' and 2inu/ s$stems1 t!e default number of log file pages is
B<F;1 gi)ing a log file si4e of =; M,. 8!e minimum number of log file pages is ;B and
t!e ma/imum is ;G GEG.
In Webp!ere MQ for Windo#s s$stems1 t!e default number of log file pages is B<F;1
gi)ing a log file si4e of =; M,. 8!e minimum number of log file pages is EH and t!e
ma/imum is ;G GEG.
#ote3 8!e si4e of t!e log files specified during queue manager creation cannot be
c!anged for a queue manager.
-ll %sa logeo linear.
-lp 4ogPrimary,iles 8!e log files allocated #!en t!e queue manager is created.
8!e minimum number of primar$ log files $ou can !a)e is H and t!e ma/imum is HGB
on Windo#s1 or G=< on %&I' and 2inu/ s$stems. 8!e default is E.
8!e total number of primar$ and secondar$ log files must not e/ceed HGG on Windo#s1
or G== on %&I' and 2inu/ s$stems1 and must not be less t!an E.
Dperating s$stem limits can reduce t!e ma/imum log si4e.
8!e )alue is e/amined #!en t!e queue manager is created or started. Cou can c!ange
it after t!e queue manager !as been created. Mo#e)er1 a c!ange in t!e )alue is not
effecti)e until t!e queue manager is restarted1 and t!e effect mig!t not be immediate.
7or more information about primar$ log files1 see W!at logs loo+ li+e.
8o calculate t!e si4e of t!e primar$ log files1 see 0alculating t!e si4e of t!e log.
-ls
4ogSecon!ary,iles
8!e log files allocated #!en t!e primar$ files are e/!austed.
8!e minimum number of secondar$ log files is = and t!e ma/imum is HGE on Windo#s1
or G<F on %&I' and 2inu/ s$stems. 8!e default number is H.
8!e total number of primar$ and secondar$ log files must not e/ceed HGG on Windo#s1
or G== on %&I' and 2inu/ s$stems1 and must not be less t!an E.
Dperating s$stem limits can reduce t!e ma/imum log si4e.
8!e )alue is e/amined #!en t!e queue manager is started. Cou can c!ange t!is )alue1
but c!anges do not become effecti)e until t!e queue manager is restarted1 and e)en
t!en t!e effect mig!t not be immediate.
7or more information about t!e use of secondar$ log files1 see W!at logs loo+ li+e.
8o calculate t!e si4e of t!e secondar$ log files1 see 0alculating t!e si4e of t!e log.
-md DataPat- 8!e director$ used to !old t!e data files for a queue manager.
In Webp!ere MQ for Windo#s s$stems1 t!e default is 0:S6rogram
7ilesSI,MSWebp!ere MQSqmgrs "assuming t!at 0 is $our data dri)e(. If t!e )olume
supports file securit$1 t!e C8EM ID1 Administrators1 and mqm group must be granted
read:#rite access to t!e director$.
In Webp!ere MQ for %&I' and 2inu/ s$stems1 t!e default is :)ar:mqm:qmgrs. %ser ID
mqm and group mqm must !a)e full aut!orities to t!e log files.
8!e Data6at! parameter is pro)ided to assist in t!e configuration of multi.instance
queue managers. 7or e/ample on %&I' and 2inu/ s$stemsR if :)ar:mqm is located on a
local file s$stem1 use Data6at! and 2og6at! to point to t!e s!ared file s$stems
accessible to multiple queue managers.
#ote3 A queue manager created using Data6at! parameter does run on )ersions of
Webp!ere MQ earlier t!an )ersion >.<.=1 but it needs reconfiguring to remo)e t!e
Data6at! parameter from its configuration. Cou !a)e t#o options to restore t!e queue
manager to a pre.)ersion >.<.= configuration and run #it!out t!e Data6at! parameter.
If $ou are confident about editing queue manager configurations1 $ou can manuall$
configure t!e queue manager using t!e 6refi/ queue manager configuration parameter.
Alternati)el$1
top t!e queue manager.
a)e t!e queue manager data and log directories.
Delete t!e queue manager.
,ac+out Webp!ere MQ to t!e pre.)>.<.= fi/ le)el.
0reate t!e queue manager #it! t!e same name.
?eplace t!e ne# queue manager data and log directories #it! t!e ones $ou sa)ed.
-q Ma+es t!is queue manager t!e default queue manager. 8!e ne# queue manager
replaces an$ e/isting default queue manager.
If $ou accidentall$ use t!is flag and #ant to re)ert to an e/isting queue manager as t!e
default queue manager1 c!ange t!e default queue manager as described in Ma+ing an
e/isting queue manager t!e default.
-sa Automatic queue manager startup. 7or Windo#s s$stems onl$.
8!e queue manager is configured to start automaticall$ #!en t!e computer starts1 or
more precisel$1 #!en t!e Webp!ere MQ er)ice starts.
8!is is t!e default option if $ou create a queue manager from Webp!ere MQ E/plorer.
Queue managers created in Webp!ere MQ releases earlier t!an 3> retain t!eir e/isting
startup t$pe.
-sa& Automatic queue manager startup1 permitting multiple instances. 7or Windo#s s$stems
onl$.
8!e queue manager is configured to start automaticall$ #!en t!e computer starts1 or
more precisel$1 #!en t!e Webp!ere MQ er)ice starts.
If an instance of t!e queue manager is not alread$ running else#!ere1 t!e queue
manager starts1 t!e instance becomes acti)e1 and standb$ instances are permitted
else#!ere. If a queue manager instance t!at permits standb$s is alread$ acti)e on a
different ser)er1 t!e ne# instance becomes a standb$.
Dnl$ one instance of a queue manager can run on a ser)er.
Queue managers created in Webp!ere MQ releases earlier t!an 3>.<.= retain t!eir
e/isting startup t$pe.
-si Interacti)e "manual( queue manager startup.
8!e queue manager is configured to start onl$ #!en manuall$ requested using t!e
strmqm command. 8!e queue manager t!en runs under t!e logged on "interacti)e(
user. Queue managers configured #it! interacti)e startup end #!en t!e user #!o
started t!em logs off.
-ss er)ice "manual( queue manager startup.
A queue manager configured to start onl$ #!en manuall$ requested using t!e strmqm
command. 8!e queue manager t!en runs as a c!ild of t!e ser)ice #!en t!e Webp!ere
MQ er)ice starts. Queue managers configured #it! ser)ice startup continue to run
e)en after t!e interacti)e user !as logged off.
8!is is t!e default option if $ou create a queue manager from t!e command line.
-t .nter"alValue 8!e trigger time inter)al in milliseconds for all queues controlled b$ t!is queue
manager. 8!is )alue specifies t!e time after recei)ing a trigger.generating message
#!en triggering is suspended. 8!at is1 if t!e arri)al of a message on a queue causes a
trigger message to be put on t!e initiation queue1 an$ message arri)ing on t!e same
queue #it!in t!e specified inter)al does not generate anot!er trigger message.
Cou can use t!e trigger time inter)al to ensure t!at $our application is allo#ed sufficient
time to deal #it! a trigger condition before it is alerted to deal #it! anot!er on t!e
same queue. Cou mig!t c!oose to see all trigger e)ents t!at !appenR if so1 set a lo# or
4ero )alue in t!is field.
pecif$ a )alue in t!e range < t!roug! FFFFFFFFF. 8!e default is FFFFFFFFF
milliseconds1 a time of more t!an == da$s. Allo#ing t!e default to be used effecti)el$
means t!at triggering is disabled after t!e first trigger message. Mo#e)er1 an
application can enable triggering again b$ ser)icing t!e queue using a command to
alter t!e queue to reset t!e trigger attribute.
-u Dea!4etterQueue 8!e name of t!e local queue t!at is to be used as t!e dead.letter "undeli)ered.
message( queue. Messages are put on t!is queue if t!e$ cannot be routed to t!eir
correct destination.
8!e default is no dead.letter queue.
-&
Maximum8ncommitt
e!Messages
8!e ma/imum number of uncommitted messages under an$ one s$nc point. 8!at is1
t!e sum of:
8!e number of messages t!at can be retrie)ed from queues
8!e number of messages t!at can be put on queues
An$ trigger messages generated #it!in t!is unit of #or+
8!is limit does not appl$ to messages t!at are retrie)ed or put outside a s$nc point.
pecif$ a )alue in t!e range = t!roug! FFFFFFFFF. 8!e default )alue is =<<<<
uncommitted messages.
-4 uppresses error messages.
8!is flag is used #it!in Webp!ere MQ to suppress un#anted error messages. ,ecause
using t!is flag can result in loss of information1 do not use it #!en entering commands
on a command line.
Cd. )et. Descripcin
< Administrador de cola definido
A E/iste el administrador de cola
EF 6ar9metro especificado no )9lido
BF Administrador de cola parado
GA Detectado el uso inconsistente de intalaciones
;F Asignacin no disponible
>< Espacio de cola no disponible
>= Error ine/perado
>H Error en nombre del Adminsitrador de cola name error
>B
8!e Webp!ere MQ ser)ice is not started.
=<< 2og location in)alid
=== Queue manager created. Mo#e)er1 t!ere #as a problem processing t!e default queue
manager definition in t!e product configuration file. 8!e default queue manager
specification mig!t be incorrect.
==G In)alid log si4e
==F
6ermission denied "Windo#s onl$(
2.7.6Ejemplos
=. Este commando define un administrador de cola por defecto llamado
Paint+*ueue+manager1 con una descripcin corta de Paint s(op1 $ define el sistema $
ob5etos por defecto. 8ambin especifica que 2ogeo linear es usado:
-rtmqm -- P%aint s&."P -ll -q %aint.queue.manager
H. Este commando define un administrador de cola por defecto llamado
Paint+*ueue+manager1 define el sistema $ ob5etos por defecto1 $ pide dos fic!eros de log
primaries $ tres secundarios:
-rtmqm -- P%aint s&."P -ll -l" 8 -ls F -q %aint.queue.manager
E. Este commando define un administrador de cola llamado tra"el1 define el sistema $ ob5etos
por defecto1 selecciona el disparador a inter)alos de G<<< milisegundos "o G segundos(1 $
especifica C8EM.DEAD.2E88E?.Q%E%E como su cola dead.letter.
-rtmqm -t EAAA -u SOS+M.$+A$.4++2.Q6+6+ travel
B. 8!is command creates a queue manager called QM= on %&I' and 2inu/ s$stems #it! its log
and queue manager data folders in a common parent director$. 8!e parent director$ is to be
s!ared on !ig!l$ a)ailable net#or+ed storage to create a multi.instance queue manager.
,efore issuing t!e command1 create :MQMA1 :MQMA:logs and :MQMA:qmgrs o#ned b$ user
and group mqm1 and #it! permissions r#/r#/r./.
-rtmqm -ld 'MQ(A'l.gs -md 'MQ(A'qmgrs QM=
2.7.7Comandos relacionados
Comando Descripcin
strmqm Inicia administrador de cola
endmqm 7inali4a administrador de cola
dltmqm ,orra administrador de cola
setmqm elecciona la instalacin asociada
2." dltmqinst
,orra entradas de instalacin del mqinst-ini en sistemas %&I' $ 2inu/.
2.".1Propsito
El fic!ero mqinst-ini contiene informacin sobre las instalaciones Webp!ere- MQ en un
sistema. 6ara m9s informacin sobre mqinst-ini1 consulta Installation configuration file1 mqinst.ini.
2.".2Sintaxis
>>-dltmqinst----+- -" -;nstallati.n%at&----------------------------+---><
+- -n -InstallationName----------------------------+
| H=I |
| H=I |
'- -n -InstallationName-- -" -InstallationPath-----'
Notas' Cuando se especi+ican con,untamente, el nombre de instalacin y ruta de
instalacin deben re+erirse a la misma instalacin-
2.".3Parmetros
Parmetro Descripcin
-p .nstallationPat- 2a ruta de instalacin es la locali4acin donde est9 instalado Webp!ere MQ.
2.".4Cdigos de retorno
Cd. )et. Descripcin
< ,orrada la entrada sin error
G 2a entrada a@n est9 acti)a
BB 2a entrada no e/iste
>= Error ine/perado
AF Error en fic!ero I&I
F; &o puede bloquear fic!ero I&I
FA Autoridad insuficiente para acceder a fic!ero I&I
=E= 6roblema de ?ecursos
2.".5Ejemplo
Este commando borra una entrada con un nombre de instalacin de miInstalacion1 $ una
ruta de instalacin de :opt:miInstalacion:
dltmqinst -n Mi;nstala-i.n -" '."t'mi;nstala-i.n
Nota' Slo puedes usar el comando !ltm*inst en otra instalacin desde la que est1s
e,ecutando- Si slo tienes una instalacin .ebSp*ere MQ, el commando no
traba,ar1-
2.# dltmqm
,orra un administrador de cola.
2.,.1Propsito
%sa el comando dltmqm para borrar un administrador de cola especificado $ todos los
ob5etos asociados con el. Antes de borrar un administrador de cola1 debes borrar un administrador
de cola1 debes finali4arlo $ usar el commando endmqm command.
Debes usar el commando dltmqm desde la instalacin asociada con el administrador de
cola con el que est9s traba5ando. 6uedes encontrar que instalacin de un administrador de cola est9
asociada a el usando el comando dspmq -o installation.
En para Webp!ere- MQ1 es un error borrar un administrador de cola cuando estan
abiertos los fic!eros del administrador de cola. i obtienes este error1 cierra los fic!eros $ )uel)e a
emitir el comando.
2.,.2Sintaxis
>>-dltmqm--+------+--QMgrName----------------------------------><
'- -z -'
2.,.3Parmetros necesarios
Parmetro Descripcin
!gr#ame El nombre del administrador de cola a borrar.
2.,.4Parmetros opcionales
Parmetro Descripcin
-4 uprime mensa5es de error.
2.,.5Cdigos de retorno
Cd. )et. Descripcin
< Administrador de cola borrado
E Queue manager being created
G Queue manager running
=; Queue manager does not e/ist
HB A process t!at #as using t!e pre)ious instance of t!e queue manager !as not $et
disconnected.
HG An error occurred #!ile creating or c!ec+ing t!e director$ structure for t!e queue
manager.
H; Queue manager running as a standb$ instance.
H> Queue manager could not obtain data loc+.
HF Administrador de cola borrado1 !o#e)er t!ere #as a problem remo)ing it from Acti)e
Director$.
EE An error occurred #!ile deleting t!e director$ structure for t!e queue manager.
BF Queue manager stopping
Cd. )et. Descripcin
;F torage not a)ailable
>= Error ine/perado
>B 8!e Webp!ere MQ ser)ice is not started.
=<< 2og location in)alid.
==H Administrador de cola borrado. Mo#e)er1 t!ere #as a problem processing t!e default
queue manager definition in t!e product configuration file. 8!e default queue manager
specification mig!t be incorrect.
==F 6ermission denied "Windo#s onl$(.
2.,.6Ejemplos
El siguiente commando borra el administrador de cola saturn+*ueue+manager.
dltmqm saturn.queue.manager
El siguiente commando borra el administrador de cola )ia5es $ tambin suprime cualquier
mensa5e producido por el comando.
dltmqm -z travel
2.,.7otas de !so
En Webp!ere MQ para Windo#s1 es un error borrar un administrador de cola cuando los
fic!eros del administrador de cola est9n abiertos. i obtienes este error1 cierra los fic!eros $ )uel)e
a emitir el comando.
Deleting a cluster queue manager does not remo)e it from t!e cluster. 8o c!ec+ #!et!er
t!e queue manager $ou #ant to delete is part of a cluster1 issue t!e command DI 02%QML?"J(.
8!en c!ec+ #!et!er t!is queue manager is listed in t!e output. If it is listed as a cluster queue
manager $ou must remo)e t!e queue manager from t!e cluster before deleting it. ee t!e related
lin+ for instructions.
If $ou do delete a cluster queue manager #it!out first remo)ing it from t!e cluster1 t!e
cluster continues to regard t!e deleted queue manager as a member of t!e cluster for at least E<
da$s. Cou can remo)e it from t!e cluster using t!e command ?EE8 02%8E? on a full repositor$
queue manager. ?e.creating a queue manager #it! an identical name and t!en tr$ing to remo)e
t!at queue manager from t!e cluster does not result in t!e cluster queue manager being remo)ed
from t!e cluster. 8!is is because t!e ne#l$ created queue manager1 alt!oug! !a)ing t!e same
name1 does not !a)e t!e same queue manager ID "QMID(. 8!erefore it is treated as a different
queue manager b$ t!e cluster.
2.,."Comandos relacionados
Comando Descripcin
crtmqm Define un administrador de cola
strmqm Inicia un administrador de cola
endmqm 7inali4a el administrador de cola
2.1$ dmpmqaut
3olcar una lista de autori4aciones actuales para una serie de perfiles $ tipos de ob5etos de
Webp!ere MQ.
2.1-.1 .inalidad
%tilice el mandato dmpmqaut para reali4ar un )olcado de las autori4aciones actuales para
un ob5eto especificado.
2.1-.2 Sintaxis
>>-dm"mqaut--+-------------------------+--+--------------+------>
'- -m --Nom!reestorColas-' +- -n --Per"il-+
+- -l ---------+
'- -a ---------'
>--+------------------+--+--------------------------+----------->
'- -t --Tipo(!)eto-' '- -s --ComponenteServicio-'
>--+-----------------------+--+------+-------------------------><
+- -" --Nom!rePrincipal-+ +- -e -+
'- -g --Nom!rerupo-----' '- -, -'
2.1-.3 Parmetros opcionales
Parmetro Descripcin
-m
Nombre5estor9olas
?eali4ar un )olcado de los registros de autori4acin solamente para el gestor de colas
especificado. i omite este par9metro1 solamente se reali4ar9 un )olcado de los
registros de autori4acin del gestor de colas predeterminado.
-n Perfil El nombre del perfil para el que se debe reali4ar el )olcado de autori4aciones. El nombre
de perfil puede ser genrico1 para lo que se utili4ar9n caracteres comod*n que permiten
especificar un rango de nombres1 como se describe en el apartado %tili4acin de perfiles
genricos del DAM en sistemas %&I' o 2inu/ $ Windo#s.
-l ?eali4ar un )olcado solamente del nombre $ del tipo de perfil. %tilice esta opcin para
generar una lista concisa de todos los nombres $ tipos de perfil definidos.
-a Lenerar mandatos de establecimiento de autori4acin.
-t Tipo:b;eto El tipo de ob5eto para el que se debe reali4ar el )olcado de autori4aciones. 2os )alores
posibles son:
"alor Descripcin
aut(info %n ob5eto de informacin de autenticacin1 para utili4arlo con la
seguridad de canal 2 "ecure oc+ets 2a$er(
c(annel o c(l %n canal
clntconn o clcn %n canal de cone/in de cliente
listener o lstr %n escuc!a
namelist o nl %na lista de nombres
process o prcs %n proceso
queue o q %na cola o colas que coinciden con el par9metro de nombre de
ob5eto
qmgr %n gestor de colas
rqmname o rqmn %n nombre de gestor de colas remoto
service o srvc %n ser)icio
topic o top %n tema
-s
9omponenteSer"ici
o
i !a$ soporte para ser)icios de autori4acin instalables1 especifica el nombre del
ser)icio de autori4acin para el que se reali4ar9 el )olcado de autori4aciones. Este
par9metro es opcionalR si lo omite1 la consulta de las autori4aciones se reali4a en el
primer componente instalable del ser)icio.
-p NombrePrincipal Este par9metro slo se aplica a Webp!ere MQ para Windo#sR los sistemas %&I' slo
guardan registros de autori4acin de grupo.
El nombre de un usuario para el que se !an de )olcar autori4aciones sobre el ob5eto
especificado. El nombre del principal puede incluir opcionalmente un nombre de
dominio1 especificado con el formato siguiente:
;$Kusuari.Rd.mini.
i desea )er m9s informacin sobre la inclusin de nombres de dominio en el nombre
de un principal1 consulte el apartado 6rincipales $ grupos.
-g Nombre5rupo El nombre del grupo de usuarios para el que se )an a )olcar las autori4aciones. lo
puede especificarse un nombre1 que debe ser el nombre de un grupo de usuarios
e/istente.
lo para Webp!ere MQ para Windo#s1 el &ombreLrupo puede incluir opcionalmente
un nombre de dominio1 especificado con los formatos siguientes:
Jr.u"*ameRd.main
d.main3*.mbreJru".
-e Mostrar todos los perfiles utili4ados para calcular la autori4acin acumulati)a que la
entidad tiene para el ob5eto especificado en -n Perfil. 2a )ariable 6erfil no debe
contener car9cter comod*n.
8ambin se deben especificar los siguientes par9metros:
-m Nombre5estor9olas
-n Perfil
-t Tipo:b;eto
$ -p NombrePrincipal1 o -g Nombre5rupo.
-& Mostrar todos los perfiles que tiene el mismo nombre que el especificado en -n Perfil.
Esta opcin no se aplica al ob5eto QM5R1 por lo que las peticiones de )olcado con el
formato !mpm*aut-m QM -t QM5R +++ -x no son )9lidas.
2.1-.4 Ejemplos
2os e5emplos siguientes muestran cmo se utili4a dmpmqaut para reali4ar un )olcado de
los registros de autori4acin de perfiles genricos:
En este e5emplo se )uelcan todos los registros de autori4acin que tienen un perfil que
coincide con la cola a.b.c del principal user=.
dm"mqaut -m qm= -n a.b.- -t q -" user=
El )olcado resultante ser*a similar al siguiente:
"r.file@ a.b.0
.bSe-t t!"e@ queue
entit!@ user=
t!"e@ "rin-i"al
aut&.rit!@ get? br./se? "ut? inq
Nota' os usuarios de 2N!3 no pueden utilizar la opcin -p4 en su lugar deben utilizar -g
nombre_grupo-
Este e5emplo se reali4a un )olcado de todos los registros de autori4acin que tienen un
perfil que coincide con la cola a+b+c.
dm"mqaut -m qmgr= -n a.b.- -t q
"r.file@ a.b.-
.bSe-t t!"e@ queue
entit!@ Administrat.r
t!"e@ "rin-i"al
aut&.rit!@ all
- - - - - - - - - - - - - - - - -
"r.file@ a.b.0
.bSe-t t!"e@ queue
entit!@ user=
t!"e@ "rin-i"al
- - - - - - - - - - - - - - - - -
"r.file@ a.00
.bSe-t t!"e@ queue
entit!@ gr.u"=
t!"e@ gr.u"
aut&.rit!@ get
Este e5emplo se reali4a un )olcado de todos los registros de autori4acin para el perfil
a+b+* de tipo queue.
dm"mqaut -m qmgr= -n a.b.0 -t q
"r.file@ a.b.0
.bSe-t t!"e@ queue
entit!@ user=
t!"e@ "rin-i"al
Este e5emplo se reali4a un )olcado de todos los registros de autori4acin para el gestor de
colas *m<.
dm"mqaut -m qm1
"r.file@ q=
.bSe-t t!"e@ queue
entit!@ Administrat.r
t!"e@ "rin-i"al
aut&.rit!@ all
- - - - - - - - - - - - - - - - -
"r.file@ q0
.bSe-t t!"e@ queue
entit!@ user=
t!"e@ "rin-i"al
aut&.rit!@ get? br./se
- - - - - - - - - - - - - - - - -
"r.file@ name.0
.bSe-t t!"e@ namelist
entit!@ user8
t!"e@ "rin-i"al
aut&.rit!@ get
- - - - - - - - - - - - - - - - -
"r.file@ "r=
.bSe-t t!"e@ "r.-ess
entit!@ gr.u"=
t!"e@ gr.u"
aut&.rit!@ get
Este e5emplo se reali4a un )olcado de todos los nombres de perfil $ tipos de ob5eto para el
gestor de colas qm3.
dm"mqaut -m qm1 -l
"r.file@ q=? t!"e@ queue
"r.file@ q0? t!"e@ queue
"r.file@ name.0? t!"e@ namelist
"r.file@ "r=? t!"e@ "r.-ess
Nota' Slo para .ebSp*ere MQ para .indo/s, todos los principales visualizados incluyen
in+ormacin de dominio, por e,emplo5
"r.file@ a.b.0
.bSe-t t!"e@ queue
entit!@ user=Rd.main=
t!"e@ "rin-i"al
0ada clase de ob5eto tiene registros de autori4acin para cada grupo o principal. Estos
registros tienen el nombre de perfil 694ASS $ rastrean la autori4acin crt "crear( com@n a todos los
ob5etos de dic!a clase. i se cambia la autori4acin crt de alg@n ob5eto de esta clase1 se actuali4a el
registro. 6or e5emplo:
"r.file@ R-lass
.bSe-t t!"e@ queue
entit!@ test
entit! t!"e@ "rin-i"al
aut&.rit!@ -rt
Esto muestra que los miembros del grupo test tienen autori4acin crt para la clase *ueue.
lo para Webp!ere MQ para Windo#s1 a los miembros del grupo QAdministradoresQ se
les asigna de forma predeterminada autori4acin total. Esta autori4acin1 no obstante1 la concede
autom9ticamente el )#M1 $ no se define en los registros de autori4acin. El mandato dmpmqaut
muestra la autori4acin definida @nicamente en los registros de autori4acin. 6or lo tanto1 a menos
que se !a$a definido e/pl*citamente un registro de autori4acin1 al e5ecutar el mandato dmpmqaut
para el grupo de QAdministradoresQ no se muestra ning@n registro de autori4acin para dic!o grupo.
2.11 dmpmqcf%
%se el commando dmpmqcfg para )olcar la configuracin de un administrador de cola
Webp!ere MQ.
2.11.1 Propsito
%sa el commando dmpmqcfg para )olcar la configuracin de admistradores de cola
Webp!ere MQ.
>>-dm"mq-fg--+-----+--+----------------------------+------------>
'- -T-' +- ----D*FIN* C#%NN*L String-+
'- ----$e"ault---------------'
>--+------------------+--+-----+--+----------------+--+-----+--->
| .- all----. | '- -a-' '- -s--Se,Num!er-' '- -z-'
'- -,--+---------+-'
+-.bSe-t--+
+-aut&re--+
+--&laut&-+
'-sub-----'
>--+---------------------+--+-------------------+--------------->
| .-0----------. | | .-all------. |
'- -n--+------------+-' '- -t--+----------+-'
'-(!)ectName-' +-aut&inf.-+
+--&annel--+
+--lnt-.nn-+
+--.mminf.-+
+-lstr-----+
'-namelist-'
>--+--------------------+--------------------------------------->
| .-mqs-------. |
'- -.--+-----------+-'
+-=line-----+
+-setmqaut--+
'-grtmqmaut-'
>--+-------------------------------------+--+--------------+---->
| .-S-ST*M.D*F%'LT.M(D*L.Q'*'*-. | '- -r--RmtQMgr-'
'- -q--+----------------------------+-'
'-ReplyQueueName-------------'
>--+---------------+-------------------------------------------><
'- -m--QMgrName-'
2.11.2 Parmetros opcionales
Parmetro Descripcin
-5 6regunta el uso de mensa5e para dmpmqcfg.
-c 7uer4a un modo de cone/in cliente. i el par9metro -c est9 cualificado con la opcin por
defecto1 es usado el proceso de cone/in por defecto. i -c es omitido1 el )alor por defecto
es usado primeramente para intentar conectar al administrador de cola al usar ser)idores
unidos $ despus si este falla por clientes usados unidos.
i la opcin es cualificada con una cadena MQ0 DE7I&E 0MA&&E2 0M28C6E"02&80D&&(
entonces este es pasado $ si tiene /ito1 usado para definir una cone/in temporal al
-& 6 all , ob7ect
, aut(rec ,
c(laut( , sub 8
7ilter t!e definition procedure to s!o# ob5ect definitions1 aut!orit$ records1 c!annel
aut!entication records1 or durable subscriptions. 8!e default )alue all is t!at all t$pes are
returned.
-a ?eturn ob5ect definitions to s!o# all attributes. 8!e default is to return onl$ attributes #!ic!
differ from t!e defaults for t!e ob5ect t$pe.
-sSe*Number ?eset c!annel sequence number for sender1 ser)er and cluster sender c!annel t$pes to t!e
numeric )alue specified. 8!e )alue eq&umber must be in t!e range = . FFFFFFFFF.
-4 Acti)ate silent mode in #!ic! #arnings1 suc! as t!ose #!ic! appear #!en inquiring
attributes from a queue manager of a !ig!er command le)el are suppressed.
-n 6 - ,
%b7ect#ame 8
7ilter t!e definitions produced b$ ob5ect or profile name1 t!e ob5ect:profile name ma$ contain
a single asteris+. 8!e J option can be placed onl$ at t!e end of t!e entered filter string
-t 0!oose a single t$pe of ob5ect for #!ic! to e/port. 6ossible )alues are:
"alor Descripcin
all 8odos los tipos de ob5eto
aut(info %n ob5eto de informacin de autenticacin
c(annel o c(l %n canal "incluido tipo de canal MQ88(
comminfo %n ob5eto informacin de comunicaciones
lstr o listener %n listener
namelist o nl %n namelist
queue o q %na cola
qmgr %n administrador de cola
srvc o service %n ser)icio
topic o top %n tema
-o6 mqsc , 1line
, setmqaut ,
grtmqmaut 8
2os )alores posibles son:
"alor Descripcin
mqsc Multi.line MQ0 t!at can be used as direct input to runmqsc
1line MQ0 #it! all attributes on a single line for line diffing
setmqaut setmqaut statements for %&I' and Windo#s queue managersR )alid onl$
#!en ./ aut!rec is specified
grtmqmaut 2inu/ onl$R generates ieries s$nta/ for granting access to t!e ob5ects.
-q 8!e name of t!e repl$.to queue used #!en getting configuration information.
-r 8!e name of t!e remote queue manager:transmit queue #!en using queued mode. If t!is
parameter is omitted t!e configuration for t!e directl$ connected queue manager "specified
#it! t!e .m parameter( is dumped.
-m 8!e name of t!e queue manager to connect to. If omitted t!e default queue manager name
is used.
2.11.3 /'tori0aciones
8!e user must !a)e MQPADND%86%8 "Tput( aut!orit$ to access t!e command input queue
"C8EM.ADMI&.0DMMA&D.Q%E%E( and MQPADNDI62AC "Tdsp( aut!orit$ to access t!e default
model queue "C8EM.DE7A%28.MDDE2.Q%E%E(1 to be able to create a temporar$ d$namic queue if
using t!e default repl$ queue.
8!e user must also !a)e MQPADN0D&&E08 "Tconnect( and MQPADNI&Q%I?E "Tinq(
aut!orit$ for t!e queue manager1 and MQPADNDI62AC "Tdsp( aut!orit$ for e)er$ ob5ect t!at is
requested.
2.12 dmpmqlo%
3isuali4a $ formatea una porcin del 2og del sistema Webp!ere MQ.
2.12.1 Propsito
%se el commando dmpmqlog para )olcar una )ersion formateada del 2og de sistema de
Webp!ere- MQ a una salida est9ndar.
El 2og a ser )olcado debe !aber sido definido en el mismo tipo del sistema operati)o que se
usa inicialmente para emitir el comando.
2.12.2 Sintaxis
>>-dm"mql.g--+--------------------+--+--------------+----------->
+- -b ---------------+ '- -e --*n$LSN-'
+- -s --StartLSN-----+
'- -n --*xtentNum!er-'
>--+-------------------+--+----------------+-------------------><
'- -f --LogFilePath-' '- -m --QMgrName-'
Parmetro Descripcin
Dump start point %se one of t!e follo#ing parameters to specif$ t!e log sequence number "2&( at #!ic! t!e
dump s!ould start. If $ou omit t!is1 dumping starts b$ default from t!e 2& of t!e first
record in t!e acti)e portion of t!e log.
-b tart dumping from t!e base 2&. 8!e base 2& identifies t!e start of t!e log e/tent t!at
contains t!e start of t!e acti)e portion of t!e log.
-s /tart9/# tart dumping from t!e specified 2&. 8!e 2& is specified in t!e format
nnnn:nnnn:nnnn:nnnn.
If $ou are using a circular log1 t!e 2& )alue must be equal to or greater t!an t!e base 2&
)alue of t!e log.
-n :&tent#umber tart dumping from t!e specified e/tent number. 8!e e/tent number must be in t!e range
<IF FFF FFF.
8!is parameter is )alid onl$ for queue managers using linear logging.
-e :nd9/# End dumping at t!e specified 2&. 8!e 2& is specified in t!e format
nnnn:nnnn:nnnn:nnnn.
-f 9og;ilePat( 8!e absolute "rat!er t!an relati)e( director$ pat! name to t!e log files. 8!e specified
director$ must contain t!e log !eader file "amq!lctl.lf!( and a subdirector$ called acti)e.
8!e acti)e subdirector$ must contain t!e log files. ,$ default1 log files are assumed to be in
t!e directories specified in t!e Webp!ere MQ configuration information. If $ou use t!is
option1 queue names associated #it! queue identifiers are s!o#n in t!e dump onl$ if $ou
use t!e .m option to name a queue manager name t!at !as t!e ob5ect catalog file in its
director$ pat!.
Dn a s$stem t!at supports long file names t!is file is called qmqmob5cat and1 to map t!e
queue identifiers to queue names1 it must be t!e file used #!en t!e log files #ere created.
7or e/ample1 for a queue manager named qm=1 t!e ob5ect catalog file is located in t!e
director$ ..SqmgrsSqm=SqmanagerS. 8o ac!ie)e t!is mapping1 $ou mig!t need to create a
temporar$ queue manager1 for e/ample named tmpq1 replace its ob5ect catalog #it! t!e
one associated #it! t!e specific log files1 and t!en start dmpmqlog1 specif$ing .m tmpq and
.f #it! t!e absolute director$ pat! name to t!e log files.
-m !gr#ame 8!e name of t!e queue manager. If $ou omit t!is parameter1 t!e name of t!e default
queue manager is used.
&ote: Do not dump t!e log #!ile t!e queue manager is running1 and do not start t!e queue
manager #!ile dmpmqlog is running.
2.13 dspmq
3isuali4a informacin sobre administradores de cola.
2.13.1 Propsito
%se el comando dspmq para )isuali4ar nombres $ detalles de los administradores de cola
en un sistema.
2.13.2 Sintaxis
.- -s ----------------------.
>>-ds"mq--+----------------+--+---------------------------+----->
'- -m --QMgrName-' +- -. all ------------------+
| .-----------------------. |
| V | |
'---+-------------------+-+-'
+- -. default ------+
+- -. installati.n -+
+- -. status -------+
'- -. standb! ------'
>--+-----+--+-----+--+-----+-----------------------------------><
'- -,-' '- -n-' '- -a-'
2.13.3 Parmetros necesarios
&inguno
Parmetro Descripcin
-a Displa$s information about t!e acti)e queue managers onl$.
A queue manager is acti)e if it is associated #it! t!e installation from #!ic! t!e dspmq
command #as issued and one or more of t!e follo#ing statements are true:
8!e queue manager is running
A listener for t!e queue manager is running
A process is connected to t!e queue manager
-m QMgrName 8!e queue manager for #!ic! to displa$ details. If $ou gi)e no name1 all queue manager
names are displa$ed.
-n uppresses translation of output strings.
-s 8!e operational status of t!e queue managers is displa$ed. 8!is parameter is t!e default
status setting.
8!e parameter .o status is equi)alent to .s.
-o all 8!e operational status of t!e queue managers is displa$ed1 and #!et!er an$ are t!e default
queue manager.
Dn Windo#s1 %&I' and 2inu/1 t!e installation name "I&8&AME(1 installation pat!
"I&86A8M(1 and installation )ersion "I&83E?( of t!e installation t!at t!e queue manager is
associated #it! is also displa$ed.
-o !efault Displa$s #!et!er an$ of t!e queue managers are t!e default queue manager.
-o installation Windo#s1 %&I' and 2inu/ onl$.
Displa$s t!e installation name "I&8&AME(1 installation pat! "I&86A8M(1 and installation
)ersion "I&83E?( of t!e installation t!at t!e queue manager is associated #it!.
-o status 8!e operational status of t!e queue managers is displa$ed.
-o stan!by 3isuali4a un administrador de cola actualmente permitido iniciando una instancia de reser)e
lista. 2os posibles )alores se muestran a continuacin:
"alor Descripcin
6ermitido El administrador de cola est9 e5ecut9ndose $ permitiendo instancias de
reser)a listas
&o permitido El administrador de cola est9 e5ecut9ndose $ no permite instancias de
reser)a listas
&o aplicable El administrador de cola no est9 e5ecut9ndose. 6uedes iniciar el
administrador de cola $ esta instancia $a acti)e si lo inicias con /ito
-& Es )isuali4ada informacin sobre instancias del administrador de cola. 2os )alores posibles se
muestran a continuacin:
"alor Descripcin
Acti)e 2a instancia es la instancia acti)e
tandb$ 2a instancia es una instancia de reser)a lista.
.
2.13.5 Estados del /dministrador de Cola
2a siguiente lista muestra los diferentes estados que un administrador de cola puede tener:
tarting
?unning
?unning as standb$
?unning else#!ere
Quiescing
Ending immediatel$
Ending pre.empti)el$
Ended normall$
Ended immediatel$
Ended une/pectedl$
Ended pre.empti)el$
tatus not a)ailable
2.13.6 Cdigos de retorno
Cd. )et. Descripcin
>= Error ine/perado
2.13.7 Ejemplos
=. El siguiente commando )isuai4a los administradores de cola de este ser)idor:
ds"mq #. all
H. El siguiente commando )isuali4a informacin de reser)e para administradores de cola en
este ser)idor que !an finali4ado inmediatamente:
ds"mq #. standb!
E. El siguiente commando )isuali4e informacin de reser)e e informacin de instancia para
administradores de cola en este ser)idor:
ds"mq #. standb! -,
2.14 dspmqaut
dspmqaut )isuali4a las autori4aciones de un ob5eto espec*fico Webp!ere- MQ ob5ect.
2.14.1 Propsito
%se el commando dspmqaut para )isuali4ar las autori4aciones de un ob5eto especificado.
i un !% de usuario es miembro de m9s de un grupo1 este commando )isuali4a las
autori4aciones combinadas de todos los grupos.
lo puede ser especificado un grupo o principal.
6ara m9s informacin sobre autoria4acin de componentes de ser)icio1 consulta Installable
ser)ices1 er)ice components1 $ Aut!ori4ation ser)ice interface.
2.14.2 Sintaxis
>>-ds"mqaut--+----------------+-- -n --Pro"ile------------------>
'- -m --QMgrName-'
>-- -t --(!)ectType--+- -g --roupName-----+-------------------->
'- -" --PrincipalName-'
>--+------------------------+----------------------------------><
'- -s --ServiceComponent-'
Parmetro Descripcin
-n Profile El nombre del perfil para el que )isuali4ar autori4aciones. 2as autori4aciones se aplican a
todos los ob5etos Webp!ere MQ con nombres que igualan al nombre especificado del perfil.
El nombre del perfil puede ser generico1 usando caracteres comodin para especificar un
rango de nombres seg@n e/plicado en %sing DAM generic profiles on %&I' or 2inu/ s$stems
and Windo#s. Este par9metro es necesario1 a menos que )isualices las autori4aciones de un
administrador de cola. En este caso no debes incluirlo $ en su lugar especificar el
administrador de cola usando el par9metro 2m.
-t %b7ectT'pe El tipo de ob5eto para el cual se reali4a la in)estigacin. 2os posibles )alores son:
"alor Descripcin
aut(info %n ob5eto de informacin de autenticacin1 para usar con un canal
seguro en 0apa de oc+ets eguros "2(
c(annel c(l %n 0anal
clntconn clcn %n canal de cone/in cliente
listener lstr %n 2istener
namelist nl %n nombre.de.lista
process prcs %n proceso
queue q %na cola o colas que igualan al par9metro nombre de ob5eto
rqmname rqmn %n nombre administrador de cola remota
service srvc %n er)icio
topic top %n 8ema
Parmetro Descripcin
-m !gr#ame 8!e name of t!e queue manager on #!ic! to ma+e t!e inquir$. 8!is parameter is
optional if $ou are displa$ing t!e aut!ori4ations of $our default queue manager.
-g <roup#ame 8!e name of t!e user group on #!ic! to ma+e t!e inquir$. Cou can specif$ onl$ one
name1 #!ic! must be t!e name of an e/isting user group.
7or Webp!ere MQ for Windo#s onl$1 t!e Lroup&ame can optionall$ include a domain
name1 specified in t!e follo#ing formats:
Jr.u"*ameRd.main
d.main3Jr.u"*ame
-p Principal#ame 8!e name of a user for #!om to displa$ aut!ori4ations to t!e specified ob5ect.
7or Webp!ere MQ for Windo#s onl$1 t!e name of t!e principal can optionall$ include a
domain name1 specified in t!e follo#ing format:
useridRd.main
7or more information about including domain names on t!e name of a principal1 see
6rincipals and groups.
-s
/erviceComponent
If installable aut!ori4ation ser)ices are supported1 specifies t!e name of t!e
aut!ori4ation ser)ice to #!ic! t!e aut!ori4ations appl$. 8!is parameter is optionalR if $ou
omit it1 t!e aut!ori4ation inquir$ is made to t!e first installable component for t!e
ser)ice.
2.14.5 Parmetros retornados
De)uel)e una lista de autori4acin1 que puede contener ninguno1 uno1 o m9s )alores de
autori4acin. 0ada )alor de autori4acin retornado significa que cualquier ID de usuario en el grupo
especificado o principal tiene la autoridad de reali4ar la operacin definida por este )alor.
2a siguiente tabla muestra las autoridades que pueden ser dadas para los diferentes tipos
de ob5eto
Tabla 3+ =specificaci)n !e autori!a!es para !iferentes tipos !e ob;etos
Autoridad Cola Proc. Admin.
de cola
Admin.
de cola
remota
#omb
re-de-
lista
Tema +nfo
Autor
Clntcon
n
Canal 9istener /ervicio
all Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces
alladm Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces
allmqi Ces Ces Ces Ces Ces Ces Ces &o &o &o &o
none Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces
altusr &o &o Ces &o &o &o &o &o &o &o &o
bro*se Ces &o &o &o &o &o &o &o &o &o &o
c(g Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces
clr Ces &o &o &o &o Ces &o &o &o &o &o
connect &o &o Ces &o &o &o &o &o &o &o &o
crt Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces
ctrl &o &o &o &o &o Ces &o &o Ces Ces Ces
ctrl& &o &o &o &o &o &o &o &o Ces &o &o
dlt Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces
dsp Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces
get Ces &o &o &o &o &o &o &o &o &o &o
pub &o &o &o &o &o Ces &o &o &o &o &o
put Ces &o &o Ces &o Ces &o &o &o &o &o
inq Ces Ces Ces &o Ces &o Ces &o &o &o &o
passall Ces &o &o &o &o Ces &o &o &o &o &o
passid Ces &o &o &o &o Ces &o &o &o &o &o
resume &o &o &o &o &o Ces &o &o &o &o &o
set Ces Ces Ces &o &o &o &o &o &o &o &o
setall Ces &o Ces &o &o Ces &o &o &o &o &o
setid Ces &o Ces &o &o Ces &o &o &o &o &o
sub &o &o &o &o &o Ces &o &o &o &o &o
s'stem &o &o Ces &o &o &o &o &o &o &o &o
2a siguiente lista define las autori4aciones asociadas con cada )alor:
Autori4acin Descripcin
all
%se all operations rele)ant to t!e ob5ect. all aut!orit$ is
equi)alent to t!e union of t!e aut!orities alladm1 allmqi1 and
s$stem appropriate to t!e ob5ect t$pe.
alladm 6erform all administration operations rele)ant to t!e ob5ect
allmqi %se all MQI calls rele)ant to t!e ob5ect
altusr pecif$ an alternati)e user ID on an MQI call
bro*se
?etrie)e a message from a queue b$ issuing an MQLE8 call #it!
t!e ,?DWE option
c(g 0!ange t!e attributes of t!e specified ob5ect1 using t!e
appropriate command set
clr 0lear a queue "607 command 0lear queue onl$( or a topic
ctrl tart1 and stop t!e specified c!annel1 listener1 or ser)ice1 and
ping t!e specified c!annel.
ctrl& ?eset or resol)e t!e specified c!annel
connect 0onnect t!e application to t!e specified queue manager b$ issuing
an MQ0D&& call
crt 0reate ob5ects of t!e specified t$pe using t!e appropriate
command set
dlt Delete t!e specified ob5ect using t!e appropriate command set
dsp Displa$ t!e attributes of t!e specified ob5ect using t!e appropriate
command set
get
?etrie)e a message from a queue b$ issuing an MQLE8 call
inq
Ma+e an inquir$ on a specific queue b$ issuing an MQI&Q call
passall 6ass all conte/t
passid 6ass t!e identit$ conte/t
pub 6ublis! a message on a topic using t!e MQ6%8 call.
put
6ut a message on a specific queue b$ issuing an MQ6%8 call
resume ?esume a subscription using t!e MQ%, call.
set
et attributes on a queue from t!e MQI b$ issuing an MQE8 call
setall et all conte/t
setid et t!e identit$ conte/t
sub 0reate1 alter1 or resume a subscription to a topic using
t!e MQ%, call.
s'stem %se queue manager for internal s$stem operations
2as autori4aciones para operaciones de administracin1 donde estn soportadas1 se aplican
a este grupo de comandos:
0omandos de 0ontrol
0omandos MQ0
0omandos 607
Cd. )et. Descripcin
< Dperacin e/itosa
B< Queue manager not a)ailable
>= Error ine/perado
=EE %n+no#n ob5ect name
=BG %ne/pected ob5ect name
=B; Db5ect name missing
=B> Db5ect t$pe missing
=BA In)alid ob5ect t$pe
=BF Entit$ name missing
2.14.7 Ejemplos
El siguiente e5emplo muestra un comando que )isuali4a las autori4aciones en el
administrador de cola saturn+*ueue+manager asociado con el grupo de usuarios staff:
ds"mqaut -m saturn.queue.manager -t qmgr -g staff
2os resultados de este commando son:
+ntit! staff &as t&e f.ll./ing aut&.rizati.ns f.r .bSe-t@
get
br./se
"ut
inq
set
-.nne-t
altusr
"assid
"assall
setid
El siguiente e5emplo )isuali4a las aut.ridades user1 que tiene la -.la a+b+c:
ds"mqaut -m qmgr= -n a.b.- -t q -" user=
2os resultados de este comando son:
+ntit! user= &as t&e f.ll./ing aut&.rizati.ns f.r .bSe-t@
get
"ut
2.15 dspmqcsv
Es )isuali4ado el estado del ser)idor de commandos
2.15.1 Propsito
%se el commando dspmqcsv para )isuali4ar el estado del ser)idor de commando para el
administrador de cola especificado.
El estado puede ser uno de los siguientes:
Iniciado
E5ecutado
E5ecutado con S>ST=M+ADM.N+9:MMAND+Q8=8= sin acti)idad para gets
7inali4ado
6arado
Debe usar el commando dspmqcsv desde la instalacin asociada al administrador de cola
con el que est9s traba5ando. 6uedes encontrar con que la instalacin de un administrador de cola
est9 asociada a el usando el commando dspmq -o installation.
2.15.2 Sintaxis
>>-ds"mq-sv--+----------+--------------------------------------><
'-QMgr*ame-'
&inguno
Parmetro Descripcin
QMgrName 8!e name of t!e local queue manager for #!ic! t!e command ser)er status is being
requested.
Cd. )et. Descripcin
2.15.6 Ejemplos
El siguiente comando )isuali4e el estado del seer)idor de comandos asociado con
"enus+*+mgr:
ds"mq-sv venus.q.mgr
2.15.7 Comandos relacionados
Command Descripcin
strmqcs) tart a command ser)er
endmqcs) End a command ser)er
2.1 dspmqfls
3isuali4a los nombres de fic!ero correspondientes a ob5etos Webp!ere- MQ.
2.16.1 Propsito
%se el comando dspmqfls para )isuali4ar el nombre del sistema de fic!eros real de todos
los ob5etos Webp!ere MQ ob5ects que igualan a un criterio especificado. 6uedes usar este
commando para identificar los fic!eros asociados con un ob5eto en particular. Este comando es
usado para reali4ar copia de seguridad de ob5etos espec*ficos. 0onsulta %nderstanding Webp!ere
MQ file names para informacin sobre transformacin de nombre.
2.16.2 S%ntax
>>-ds"mqfls--+----------------+--+---------------+-------------->
'- -m --QMgr*ame-' '- -t -->bS!"e-'
>--Jeneri->bS*ame----------------------------------------------><
2.16.3 *e1'ired parameters
Parmetro Descripcin
5eneric:b;Name 8!e name of t!e ob5ect. 8!e name is a string #it! no flag and is a required parameter.
Dmitting t!e name returns an error.
8!is parameter supports an asteris+ "J( as a #ildcard at t!e end of t!e string.
2.16.4 2ptional parameters
Parmetro Descripcin
-m QMgrName El nombre del administrador de cola para el cual e/aminer fic!eros. i omites este
nombre1 el comando opera en el administrador de cola por defecto.
-t ObjType El tipo.de.ob5eto. 2a lista siguiente muestra los tipos de ob5eto )9lidos. El nombre
abre)iado es mostrado en primer lugar seguido por el nombre completo.
"alor /ignificado
- o all 8odos los tipos de ob5etoR este par9metro es por defecto.
aut(info Aut!entication information ob5ect1 for use #it! ecure oc+ets 2a$er
"2( c!annel securit$
c(annel o c(l A c!annel
clntconn o
clcn
A client connection c!annel
catalog o ctlg An ob5ect catalog
namelist o nl A namelist
listener o lstr A listener
process o prcs A process
queue o q A queue or queues matc!ing t!e ob5ect name parameter
qalias o qa An alias queue
qlocal o ql A local queue
qmodel o qm A model queue
qremote o qr A remote queue
qmgr A queue manager ob5ect
service o srvc A ser)ice
Notas' T*e dspmq+ls command displays t*e name o+ t*e directory containing t*e queue,
not t*e name o+ t*e queue itsel+-
!n .ebSp*ere MQ +or 2N!3 systems, you must prevent t*e s*ell +rom interpreting
t*e meaning o+ special c*aracters, +or e6ample, an asteris7 89:- T*e /ay you do
t*is depends on t*e s*ell you are using- !t may involve t*e use o+ single quotation
mar7s, double quotation mar7s, or a bac7slas*-
2.16.5 *et'rn codes
Cd. )et. Descripcin
< 0ommand completed normall$
=< 0ommand completed but not entirel$ as e/pected
H< An error occurred during processing
2.16.6 Examples
=. El commando siguiente )isuali4a los detalles de todos los ob5etos con nombres que
comien4an con SYSTEM.ADMIN definido en el administrador de cola por defecto.
ds"mqfls SOS+M.A$M;*0
H. El siguiente commando )isuali4a detalles de fic!ero para todos los procesos con nombres
que comien4an con PROC definidos en el administrador de cola RADIUS.
ds"mqfls -m 2A$;6S -t "r-s %2>50
2.1! dspmqinf
3isuali4a informacin de configuracin Webp!ere- MQ "solo plataformas Windo#s $
%&I'(.
2.17.1 Propsito
%se el comando dspmqinf para )isuali4ar la informacin de configuracin Webp!ere MQ.
2.17.2 Sintaxis
.- -s -QueueManager-. .- -. -stanza--.
>>-ds"mqinf -+-------------------+--+--------------+--Stan/aName-><
'- -s -Stan/aType---' '- -. --.mmand-'
Parmetro Descripcin
/tan4a#ame 8!e name of t!e stan4a. 8!at is1 t!e )alue of t!e +e$ attribute t!at distinguis!es bet#een
multiple stan4as of t!e same t$pe.
Parmetro Descripcin
-s StanzaType 8!e t$pe of stan4a to displa$. If omitted1 t!e QueueManager stan4a is displa$ed.
8!e onl$ supported )alue of tan4a8$pe is QueueManager.
-o stanza Displa$s t!e configuration information in stan4a format as it is s!o#n in t!e .ini files. 8!is
format is t!e default output format.
%se t!is format to displa$ stan4a information in a format t!at is eas$ to read.
-o comman! Displa$s t!e configuration information as an addmqinf command.
Information about t!e installation associated #it! t!e queue manager is not displa$ed
using t!is parameter. 8!e addmqinf command does not require information about t!e
installation.
%se t!is format to paste into a command s!ell.
Cd. )et. Descripcin
< Dperacin e/itosa
Cd. )et. Descripcin
EF 6ar9metros de l*nea.de.comandos malos
BB tan4a does not e/ist
>= Error ine/perado
2.17.6 Ejemplos
ds"mqinf QM.*AM+
El comando por defecto busca una estrofa QueueManager denominada QM.&AME $ la
)isuali4e en format estrofa:
QueueManager@
*ame=QM.*AM+
%refi,='var'mqm
$ire-t.r!=QM)*AM+
$ata%at&='MQ(A'qmgrs'QM)*AM+
;nstallati.n*ame=;nstallati.n=
El siguiente comando da el mismo resultado:
ds"mqinf #s QueueManager #. stanza QM.*AM+
El siguiente e5emplo )isuali4e la salida en formato addmqinf.
ds"mqinf #. -.mmand QM.*AM+
2a salida est9 en esta l*nea:
addmqinf #s QueueManager #v *ame=QM.*AM+ #v %refi,='var'mqm #v $ire-t.r!=QM)*AM+
#v $ata%at&='MQ(A'qmgrs'QM)*AM+
2.17.7 otas de !so
%se dspmqinf con addmqinf para definer una instancia de un administrador de cola multi.
instancia en un ser)idor diferente.
6ara usar este comando debe ser administrador de Webp!ere MQ administrator $ un
miembro del grupo mqm.
2.17." Comandos relacionados
Command Descripcin
addmqinf Add queue manager configuration information
rm)mqinf ?emo)e queue manager configuration information
2.1" dspmqinst
3isuali4a entradas de instalacin para mqinst.ini en %&I'1 2inu/1 $ Windo#s.
2.1".1 Propsito
El fic!ero mqinst.ini contiene informacin sobre todas las instalaciones de Webp!ere- MQ
en un sistema. 6ara m9s informacin sobre mqinst.ini1 consultar Installation configuration file1
mqinst.ini.
2.1".2 Sintaxis
>>-ds"mqinst----+- -" -InstallationPath----------------------------+---><
| H=I |
| H=I |
Notas' Cuando se especi+ica con,untamente, el nombre de instalacin y ruta de instalacin
debe re+erirse a la misma instalacin-
2.1".3 Parmetros
Parmetro Descripcin
-p .nstallationPat- 2a ruta de la instalacin.
5 3isuali4a informacin de uso.
2.1".4 Cdigos de retorno
Cd. )et. Descripcin
< Entr$ displa$ed #it!out error
>= Error ine/perado
AF .Error en fic!ero I&I
F; 0ould not loc+ .ini file
=E= ?esource problem
2.1".5 Ejemplos
Displa$ details of all Webp!ere MQ installations on t!e s$stem:
ds"mqinst
Quer$ t!e entr$ for t!e installation named !nstallation;:
ds"mqinst -n ;nstallati.nF
Quer$ t!e entr$ #it! an installation pat! of :opt:mqm:
ds"mqinst -" '."t'mqm
Quer$ t!e entr$ for t!e installation named !nstallation;. Its e/pected installation pat! is
:opt:mqm:
ds"mqinst -n ;nstallati.nF -" '."t'mqm
2.1# dspmqrte
Determina la ruta que toma un mensa5e en la red del gestor de colas.
2.1,.1 .inalidad
2a aplicacin de )isuali4acin de ruta de Webp!ere MQ "dspmqrte( puede e5ecutarse en
todas las plataformas sal)o en 4:D. 6uede e5ecutar la aplicacin de )isuali4acin de ruta de
Webp!ere MQ como un cliente para un gestor de colas de Webp!ere MQ para 4:D1 especificando
el par9metro .c al emitir el mandato dspmqrte.
Nota' Para e,ecutar una aplicacin cliente para un gestor de colas de .ebSp*ere MQ para
z<)S, la caracter=stica de cone6in de clientes debe estar instalada-
2a aplicacin de )isuali4acin de ruta de Webp!ere MQ genera $ en)*a un mensa5e de
rastreo de ruta a una red de gestores de colas. Mientras el mensa5e de rastreo de ruta se despla4a
por la red de gestores de colas1 se registra informacin sobre su acti)idad. 0uando el mensa5e de
rastreo de ruta llega a su cola de destino1 la aplicacin de )isuali4acin de ruta de Webp!ere MQ
recopila la informacin de acti)idad $ la muestra. 6ara obtener m9s informacin $ e5emplos del uso
de la aplicacin de )isuali4acin de ruta de Webp!ere MQ1 consulte Aplicacin de )isuali4acin de
ruta de Webp!ere MQ.
2.1,.2 Sintaxis
>>-ds"mqrte--+------+------------------------------------------->
'- -- -'
.-| >"-i.nes de genera-iUn |--------------------.
>--+-----------------------------------------------+------------>
'- -i --CorrelI$--| >"-i.nes de visualiza-iUn |-'
>-- -q --TargetQName--+----------------+-----------------------><
'- -m --QMgrName-'
2.19.2.1 OPCIONES DE GENERACIN
|--+------------------+--+---------------+--+---------------+--->
'- -a- --+-------+-' '- -d --Deliver-' '- -f --For0ar$-'
'- -ar -'
>--+-----------------------+--+------+--+----------------+------>
| H=I | '- -. -' '- -" --Priority-'
'- -l --Persistence-----'
>--+-----------------------+--+-----------------------------+--->
'- -qm --TargetQMgrName-' '- -r. --+- n.ne -----------+-'
| .-?------------. |
| V | |
'---Report(ption-+-'
>--+------------------------------------------+----------------->
'- -rq --ReplyToQ--+---------------------+-'
'- -rqm --ReplyToQMgr-'
>--+------------------+--+--------------+----------------------->
'- -s --%ctivities-' '- -t --Detail-'
>--+------------------+--+-------------------+------------------>
'- -ts --SerieTema-' '- -," --Pass*xpiry-'
.-| >"-i.nes de visualiza-iUn |-.
>--+---------------+--+-------------------------------+---------|
'- -,s --*xpiry-' | H8I |
'--- -n ------------------------'
2.19.2.2 OPCIONES DE VISUALIZACIN
.- -v summar! --------------------------------.
|--+------+--+----------------------------------------------+--->
'- -b -' '- -v --+- all ------------------------------+-'
+- n.ne -----------------------------+
'- .utline --+---------------------+-'
| .-?---------------. |
| V | |
'--- Display(ption -+-'
>--+----------------+-------------------------------------------|
'- -/ --1aitTime-'
Notas' Si el par1metro Persistence se especi+ica como yes, y va acompa>ado de una
solicitud de un mensa,e de respuesta de rastreo de ruta 8-ar:, o de cualquier
opcin de generacin de in+orme 8-ro Report:ption:, debe especi+icar el
par1metro -r* ReplyToQ- a cola de respuestas no debe resolverse en una cola
din1mica temporal-
Si este par1metro va acompa>ado de una solicitud de un mensa,e de respuesta de
rastreo de ruta 8-ar:, o de cualquiera de las opciones de generacin de in+orme 8-
ro Report:ption:, debe especi+icarse una cola de respuestas 8no modelo:
espec=+ica utilizando -r* ReplyToQ- %e +orma predeterminada, se solicitan
mensa,es de in+orme de actividad-
2.1,.3 Parmetros necesarios
Parmetro Descripcin
-q TargetQName i la aplicacin de )isuali4acin de ruta de Webp!ere MQ se est9 utili4ando para en)iar
un mensa5e de rastreo de ruta a una red de gestores de colas1 8argetQ&ame especifica el
nombre de la cola de destino.
i la aplicacin de )isuali4acin de ruta de Webp!ere MQ se est9 utili4ando para )er
informacin de acti)idad recopilada anteriormente1 8argetQ&ame especifica el nombre de
la cola donde est9 almacenada la informacin de acti)idad.
2.1,.4 Parmetros opcionales
Parmetro Descripcin
-c Especifica que la aplicacin de )isuali4acin de ruta de Webp!ere MQ se conecta como
una aplicacin cliente. 6ara obtener m9s informacin sobre cmo configurar m9quinas
cliente1 consulte Instalacin de un cliente Webp!ere MQ.
i no especifica este par9metro1 la aplicacin de )isuali4acin de ruta de Webp!ere no se
conecta como una aplicacin cliente.
-i Correl+d Este par9metro se utili4a cuando la aplicacin de )isuali4acin de ruta de Webp!ere MQ
se utili4a solamente para )isuali4ar informacin de acti)idad acumulada pre)iamente.
6uede !aber muc!os informes de acti)idad $ mensa5es de respuesta de rastreo de ruta en
la cola especificada en ?q TargetQName. ID0orrel se utili4a para identificar los informes de
acti)idad1 o un mensa5e de respuesta de rastreo de ruta1 relacionados con un mensa5e de
rastreo de ruta. Especifique el identificador de mensa5e del mensa5e de rastreo de ruta
original en 0orrelId.
El formato de 0orrelId es una serie !e/adecimal de BA caracteres.
-m !gr#ame El nombre del gestor de colas al que se conecta la aplicacin de )isuali4acin de ruta de
Webp!ere MQ. El nombre puede tener !asta BA caracteres como m9/imo.
i no especifica este par9metro1 se utili4a el gestor de colas predeterminado.
%pciones de
generacin3
2os par9metros siguientes se utili4an cuando la aplicacin de )isuali4acin de ruta de
Webp!ere MQ se utili4a para en)iar un mensa5e de rastreo de ruta a una red de gestores
de colas.
-ac Especifica que la informacin de acti)idad se debe acumular en el mensa5e de rastreo de
ruta.
i no especifica este par9metro1 la informacin de acti)idad no se acumula en el mensa5e
de rastreo de ruta.
-ar olicita que se genere un mensa5e de respuesta de rastreo de ruta que contenga toda la
informacin de acti)idad acumulada1 en las siguientes situaciones:
%n gestor de colas de Webp!ere MQ 3ersin >.< descarta el mensa5e de rastreo
de ruta.
%n gestor de colas de Webp!ere MQ 3ersin >.< coloca el mensa5e de rastreo
de ruta en una cola local "cola de destino o cola de mensa5es no entregados(.
El n@mero de acti)idades reali4adas en el mensa5e de rastreo de ruta es superior
al )alor especificado en .s Acti)ities.
6ara obtener m9s informacin sobre los mensa5es de respuesta de rastreo de ruta1
consulte ?eferencia de mensa5e de respuesta de ruta de rastreo.
i no especifica este par9metro1 no se solicita un mensa5e de respuesta de rastreo de
ruta.
-d Deliver Especifica si el mensa5e de rastreo de ruta se !a de entregar en la cola de destino al
llegar. 2os posibles )alores para Deli)er son:
'es Al llegar1 el mensa5e de rastreo de ruta se coloca en la cola de
destino1 aunque el gestor de colas no admita la mensa5er*a de
rastreo de ruta.
no Al llegar1 el mensa5e de rastreo de ruta no se coloca en la cola de
destino.
i no especifica este par9metro1 el mensa5e de rastreo de ruta no se coloca en la cola de
destino.
-f ;or*ard Especifica el tipo de gestor de colas al que se puede reen)iar el mensa5e de rastreo de
ruta. 2os gestores de colas utili4an un algoritmo al decidir si )an a en)iar un mensa5e a un
gestor de colas remoto. 6ara obtener informacin detallada sobre este algoritmo1 consulte
El algoritmo de gestin de carga de traba5o del cl@ster. 2os )alores posibles para ?een)iar
son:
all El mensa5e de rastreo de ruta se reen)*a a cualquier gestor de
colas.
Aviso3 Si se reenv=a a un gestor de colas de .ebSp*ere MQ
anterior a la versin @-A, el mensa,e de rastreo de ruta no se
reconoce y puede entregarse en una cola local, a pesar del valor
del par1metro .d Entregar.
supported El mensa5e de rastreo de ruta slo se reen)*a a un gestor de colas
que acepte el par9metro Deli)er del grupo 607 8race?oute.
i no especifica este par9metro1 el mensa5e de rastreo de ruta slo se reen)*a a un gestor
de colas que acepte el par9metro Deli)er.
-l Persistence Especifica la persistencia del mensa5e de rastreo de ruta generado. 2os posibles )alores
para 6ersistence son:
"alor Descripcin
'es El mensa5e de rastreo de ruta generado es persistente.
"MQ6E?N6E?I8E&8(.
no El mensa5e de rastreo de ruta generado no es persistente.
"MQ6E?N&D8N6E?I8E&8(.
q El mensa5e de rastreo de ruta generado !ereda su )alor de persistencia de
la cola especificada en .q &omb0olaDestino.
"MQ6E?N6E?I8E&0ENANQNDE7(.
%n mensa5e de respuesta de rastreo de ruta1 o cualquier mensa5e de informe1 de)uelto
comparte el mismo )alor de persistencia que el mensa5e de rastreo de ruta original.
i 6ersistencia se especifica como $es1 debe especificar el par9metro .rq ?epl$8oQ. 2a
cola de respuestas no debe resol)erse en una cola din9mica temporal.
i no especifica este par9metro1 el mensa5e de rastreo de ruta generado no es
persistente.
-o Indica que la cola de destino no est9 enla4ada a un destino espec*fico. 6or lo general1 este
par9metro se utili4a cuando el mensa5e de rastreo de ruta debe transferirse a tra)s de
un cl@ster. 2a cola de destino se abre con la opcin MQDDN,I&DN&D8N7I'ED.
i no especifica este par9metro1 la cola de destino se enla4a a un destino espec*fico.
-p Priorit' Especifica la prioridad del mensa5e de rastreo de ruta. El )alor de 6riorit$ es ma$or que o
igual a <1 o MQ6?IN6?ID?I8CNANQNDE7. MQ6?IN6?ID?I8CNANQNDE7 indica que el
)alor de prioridad se toma de la cola especificada en ?q TargetQMgrName.
i no especifica este par9metro1 el )alor de prioridad se toma de la cola especificada en ?q
NombCola%estino.
-qm
Target!gr#ame
0alifica el nombre de la cola de destinoR entonces se aplica la resolucin de nombres de
gestor de colas normal. 2a cola de destino se especifica con ?q TargetQMgrName.
i no especifica este par9metro1 el gestor de colas al que est9 conectada la aplicacin de
)isuali4acin de ruta de Webp!ere MQ se utili4a como el gestor de colas de respuestas.
-ro none ,
)eport%ption
2a siguiente tabla muestra la descripcin de las opciones:
"alor Descripcin
none Especifica que no se !a establecido ninguna opcin de informe.
%pcin+nforme Especifica las opciones de informe para el mensa5e de rastreo de
ruta. e pueden especificar )arias opciones de informe utili4ando
la coma como separador. 2os )alores posibles para DpcinInforme
son:
Activit' e establece la opcin de informe MQ?DNA08I3I8C.
coa e establece la opcin de informe
MQ?DN0DANWI8MN7%22NDA8A.
cod e establece la opcin de informe
MQ?DN0DDNWI8MN7%22NDA8A.
e&ception e establece la opcin de informe
MQ?DNE'0E68ID&NWI8MN7%22NDA8A.
e&piration e establece la opcin de informe
MQ?DNE'6I?A8ID&NWI8MN7%22NDA8A.
discard e establece la opcin de informe MQ?DNDI0A?DNML.
i no se especifica ?ro 'eport)ption ni ?ro none1 se especifican las opciones de informe
MQ?DNA08I3I8C $ MQ?DNDI0A?DNML.
-rq )epl'To Especifica el nombre de cola de respuestas a la que se en)*an todas las respuestas al
mensa5e de rastreo de ruta. i el mensa5e de rastreo de ruta es persistente1 o si se
especifica el par9metro ?n1 debe especificarse una cola de respuestas que no sea una cola
din9mica temporal.
i no especifica este par9metro1 la cola modelo predeterminada del sistema1
C8EM.DE7A%28.MDDE2.Q%E%E1 se utili4a como la cola de respuestas. 2a utili4acin de
esta cola modelo pro)oca la creacin de una cola din9mica temporal para la aplicacin de
)isuali4acin de ruta de Webp!ere MQ.
-rqm
)epl'To!gr
Especifica el nombre del gestor de colas donde est9 ubicada la cola de respuestas. El
nombre puede tener !asta BA caracteres como m9/imo.
i no especifica este par9metro1 el gestor de colas al que est9 conectada la aplicacin de
)isuali4acin de ruta de Webp!ere MQ se utili4a como el gestor de colas de respuestas
-s Activities Especifica el n@mero m9/imo de acti)idades registradas que se pueden reali4ar en nombre
del mensa5e de rastreo de ruta antes de que sea descartado. Este par9metro impide que
el mensa5e de rastreo de ruta se reen)*e indefinidamente si cae en un bucle infinito. El
)alor de Acti)ities es ma$or que o igual a =1 o MQ?D%8EN%&2IMI8EDNA08I3I8IE.
MQ?D%8EN%&2IMI8EDNA08I3I8IE especifica que se puede reali4ar un n@mero ilimitado
de acti)idades en nombre del mensa5e de rastreo de ruta.
i no especifica este par9metro1 se puede reali4ar un n@mero ilimitado
de acti)idades en nombre del mensa5e de rastreo de ruta.
-t Detail Especifica las acti)idades que se registran. 2os )alores posibles para Detalle son:
"alor Descripcin
lo* lo se registran las acti)idades reali4adas por una aplicacin definida
por el usuario.
medium e registran las acti)idades especificadas en lo*. Adem9s1 se registran
las acti)idades reali4adas por los M0A.
(ig( e registran las acti)idades especificadas en lo* $ medium. 2os M0A
no e/ponen ninguna otra informacin de acti)idad en este ni)el de
detalle. Esta opcin est9 disponible para aplicaciones definidas por el
usuario que slo )an a e/poner informacin de acti)idad adicional. 6or
e5emplo1 si una aplicacin definida por el usuario determina la ruta que
toma un mensa5e considerando ciertas caracter*sticas del mensa5e1 la
lgica de direccionamiento puede incluirse en este ni)el de detalle.
i no especifica este par9metro1 se registran las acti)idades de ni)el medio.
-ts Topic/tring Especifica una serie de tema en la que la aplicacin de )isuali4acin de ruta de Webp!ere
MQ )a a publicar un mensa5e de rastreo de ruta1 $ coloca esta aplicacin en modalidad de
tema. En esta modalidad1 la aplicacin reali4a un rastreo de todos los mensa5es
resultantes de la solicitud de publicacin.
-&p Pass:&pir' Especifica si la opcin de informe MQ?DNDI0A?DNML $ el tiempo de caducidad
restante del mensa5e de rastreo de ruta se pasan al mensa5e de respuesta de rastreo de
ruta. 2os posibles )alores para 6assE/pir$ son:
"alor Descripcin
'es 2a opcin de informe MQ?DN6ANDI0A?DNA&DNE'6I?C se especifica en el
descriptor de mensa5e del mensa5e de rastreo de ruta.
i se genera un mensa5e de respuesta de rastreo de ruta1 o informes de
acti)idad1 para el mensa5e de rastreo de ruta1 la opcin de informe
MQ?DNDI0A?DNML "si se especifica( $ el tiempo de caducidad restante se
pasan en el mensa5e.
Este par9metro es el )alor predeterminado.
no 2a opcin de informe MQ?DN6ANDI0A?DNA&DNE'6I?C no se especifica.
i se genera un mensa5e de respuesta de rastreo de ruta para el mensa5e de
rastreo de ruta1 la opcin discard $ el tiempo de caducidad restante del
mensa5e de rastreo de ruta no se pasan en el mensa5e.
i no especifica este par9metro1 la opcin de informe
MQ?DN6ANDI0A?DNA&DNE'6I?C no se especifica en el mensa5e de rastreo de ruta.
-&s :&pir' Especifica el tiempo de caducidad1 en segundos1 del mensa5e de rastreo de ruta.
i no especifica este par9metro1 el tiempo de caducidad se establece en ;< segundos.
-n Especifica que la informacin de acti)idad de)uelta para el mensa5e de rastreo de ruta no
se debe mostrar.
i este par9metro )a acompaado de una solicitud de un mensa5e de respuesta de rastreo
de ruta1 "-ar(1 o de cualquiera de las opciones de generacin de informe =-ro
)eport%ption(1 debe especificarse una cola de respuestas "no modelo( espec*fica
utili4ando -rq )epl'To. De forma predeterminada1 se solicitan mensa5es de informe de
acti)idad.
0uando el mensa5e de rastreo de ruta se !a colocado en la cola de destino especificada1
se de)uel)e una serie !e/adecimal de BA caracteres que contiene el identificador de
mensa5e del mensa5e de rastreo de ruta. 2a aplicacin de )isuali4acin de ruta de
Webp!ere MQ puede utili4ar el identificador de mensa5e para mostrar posteriormente la
informacin de acti)idad para el mensa5e de rastreo de ruta. Esto se puede efectuar
mediante el par9metro -i +DCorrel.
i no especifica este par9metro1 la informacin de acti)idad de)uelta para el mensa5e de
rastreo de ruta se )isuali4a en el formato especificado en el par9metro -v.
2.19.4.1 OPCIONES DE VISUALIZACIN
2os par9metros siguientes se utili4an cuando la aplicacin de )isuali4acin de ruta de
Webp!ere MQ se utili4a para mostrar la informacin de acti)idad recopilada.
Parmetro Descripcin
2.1,.5 Cdigos de retorno
Cd. )et. Descripcin
< Mandato completado con normalidad
=< e !an suministrado argumentos no )9lidos
H< e !a producido un error durante el proceso
-b Especifica que la aplicacin de )isuali4acin de ruta de Webp!ere MQ slo e/amina
informes de acti)idad o un mensa5e de respuesta de rastreo de ruta relacionado con un
mensa5e. Este par9metro permite que la informacin de acti)idad se )uel)a a )isuali4ar
m9s adelante.
i no especifica este par9metro1 la aplicacin de )isuali4acin de ruta de Webp!ere MQ
obtiene informes de acti)idad $ los suprime1 o bien un mensa5e de respuesta de rastreo
de ruta relacionado con un mensa5e.
-v summar' , all ,
none , outline
:pci)nVisualizaci)
n
"alor Descripcin
summar' e )isuali4an las colas a tra)s de las cuales se !a direccionado
el mensa5e de rastreo de ruta.
all e )isuali4a toda la informacin disponible.
none &o se )isuali4a ninguna informacin.
outline
%pcin"isuali4acin
Especifica las opciones de )isuali4acin para el mensa5e de
rastreo de ruta. e pueden especificar )arias opciones de
)isuali4acin utili4ando la coma como separador.
i no se proporciona ning@n )alor1 se )isuali4a la informacin
siguiente:
El nombre de la aplicacin
El tipo de cada operacin
0ualquier par9metro espec*ficos de operacin
2os )alores posibles para Dpcin3isuali4acin son:
activit'3 e )isuali4an todos los par9metros de grupo no
607 en los grupos 607 Acti)idad.
identifiers3 e )isuali4an los )alores que tienen los
identificadores de par9metro MQ,A07NMLNID o
MQ,A07N0D??E2NID. Este )alor pre)alece sobre
msgdelta.
message3 e )isuali4an todos los par9metros de grupo no
607 en los grupos 607 Mensa5e. 0uando se especifica
este )alor1 no se puede especificar msgdelta.
msgdelta3 e )isuali4an todos los par9metros de grupo no
607 en los grupos 607 Mensa5e que !an cambiado
desde la @ltima operacin. 0uando se especifica este
)alor1 no se puede especificar mensa,e.
operation3 e )isuali4an todos los par9metros de grupo no
607 en los grupos 607 de Dperacin.
traceroute3 e )isuali4an todos los par9metros de grupo no
607 en los grupos 607 8race?oute.
i no especifica este par9metro1 se )isuali4a un resumen de la ruta de mensa5es.
-* Tiempo:spera Especifica el tiempo1 en segundos1 que la aplicacin de )isuali4acin de ruta de
Webp!ere MQ espera a que los informes de acti)idad1 o un mensa5e de rastreo de ruta1
)uel)an a la cola de respuestas especificada.
i no especifica este par9metro1 el tiempo de espera se especifica como el tiempo de
caducidad del mensa5e de rastreo de ruta1 m9s ;< segundos.
2.1,.6 Ejemplos
El mandato siguiente en)*a un mensa5e de rastreo de ruta a una red de gestores de colas
con la cola de destino especificada como 8A?LE8.Q. iempre que los gestores de colas de la ruta
estn !abilitados para el registro de acti)idad1 se generan informes de acti)idad. En funcin del
atributo del gestor de colas1 A08I3?E01 los informes de acti)idad se entregan a la cola de respuestas
A08.?E6D?8.?E62C.Q o a una cola del sistema. El mensa5e de rastreo de ruta se descarta cuando
llega a la cola de destino.
ds"mqrte -q A2J+.Q -rq A5.2+%>2.2+%4O.Q
iempre que se entregue uno o m9s informes de acti)idad a la cola de respuestas1
A08.?E6D?8.?E62C.Q1 la aplicacin de )isuali4acin de ruta de Webp!ere MQ ordena $ muestra
la informacin de acti)idad.
El mandato siguiente en)*a un mensa5e de rastreo de ruta a una red de gestores de colas
con la cola de destino especificada como 8A?LE8.Q. e acumula informacin sobre la acti)idad
dentro del mensa5e de ruta de rastreo1 pero no se generan informes de acti)idad. El mensa5e de
rastreo de ruta se descarta cuando llega a la cola de destino. En funcin del )alor del atributo del
gestor de colas de destino1 ?D%8E?E01 se puede generar $ entregar un mensa5e de respuesta de
rastreo de ruta a la cola de respuestas 8??.?E62C.8D.Q o a una cola del sistema.
ds"mqrte -a- -ar -r. dis-ard -rq 22.2+%4O.>.Q -q A2J+.Q
iempre que se genere un mensa5e de respuesta de rastreo de ruta1 $ se entregue a la cola
de respuestas 8??.?E62C.8D.Q1 la aplicacin de )isuali4acin de ruta de Webp!ere MQ ordena $
muestra la informacin de acti)idad que estaba acumulada en el mensa5e de rastreo de ruta.
6ara obtener m9s e5emplos del uso de la aplicacin de )isuali4acin de ruta de Webp!ere
MQ $ su salida1 consulte E5emplos de la aplicacin de )isuali4acin de ruta de Webp!ere
MQ.
2.2$ dspmqspl
%se el commando dspmqspl para )isuali4ar una lista de todas las pol*ticas $ detalles de
una pol*tica determinada.
2.2-.1 Sintaxis
>>-ds"mqs"l-- -m -QMgrName--+-----------------+--+----------+--><
'- -" -PolicyName-' '- -e,".rt-'
Table 1. dspmqspl command flags.
/e>al de
Comando
:&plicacin
-m &ombre del administrador de 0ola "mandato(.
-p &ombre de 6ol*tica.
-e&port Aadir esta seal genera salida que puede ser aplicada a un administrador de cola
diferente.
2.21 dspmqtrc
7ormatea $ )isuali4a el tra4ado de Webp!ere MQ "solo plataformas %ni/(.
2.21.1 Propsito
El commando dspmqtrc est9 soportado en sistemas %&I' solamente. %sa el comando
dspmqtrc para )isuali4ar salida de tra4a formateada Webp!ere- MQ.
2os fic!eros de tra4a 2 e5ecutables tienen los nombres AMQ.2.8?0 $ AMQ.2.8?0.=.
&o puedes formatear cualquiera de los fic!eros de tra4a 2. 2os fic!eros de tra4a 2 son fic!eros
binaries $1 si est9n transferidos para I,M- suportados por 7861 deben ser transferidos en modo de
transferencia binarios.
2.21.2 Sintaxis
>>-ds"mqtr---+----------------------+--+-----+--+-----+--------->
'- -t --FormatTemplate-' '- -&-' '- -s-'
>--+----------------------+--InputFileName---------------------><
'- -. --(utputFilename-'
Parmetro Descripcin
+nput;ile#ame El nombre del fic!ero conteniendo la tra4a no formateada1 por e5emplo:
:)ar:mqm:trace:AMQ=HEBG.<=.8?0
If $ou pro)ide one input file1 dspmqtrc formats it eit!er to stdout or to t!e output file $ou
name. If $ou pro)ide more t!an one input file1 an$ output file $ou name is ignored1 and
formatted files are named AMQ$$$$$.44.7M81 based on t!e 6ID of t!e trace file.
Parmetro Descripcin
.t ,ormatTemplate 8!e name of t!e template file containing details of !o# to displa$ t!e trace. If t!is
parameter is not supplied1 t!e default template file location is used:
7or AI'- s$stems1 t!e default )alue is as follo#s:
MQ2INST%LL%TI(N2P%T#'lib'amqtr-8.fmt
7or all %&I' s$stems ot!er t!an AI' s$stems1 t!e default )alue is as follo#s:
MQ2INST%LL%TI(N2P%T#'lib'amqtr-.fmt
MQ&!NST##T!)N&P#T$ represents t!e !ig!.le)el director$ in #!ic! Webp!ere MQ is
installed.
-( Dmit !eader information from t!e report.
-s E/tract trace !eader and put to stdout.
-o
output?filename
8!e name of t!e file into #!ic! to #rite formatted data.
Comando Descripcin
endmqtrc End trace
strmqtrc tart trace
2.22 dspmqtrn
3isuali4a transacciones completas en b$te.doble $ !eur*sticamente.
2.22.1 Propsito
%se el commando dspmqtrn para )isuali4ar detalles de transacciones. Este commando
inclu$e transacciones coordinadas por Webp!ere- MQ $ por administrador de transaccin e/terno.
2.22.2 Sintaxis
>>-ds"mqtrn--+-----+--+-----+--+-----+--+-----+--+-----+-------->
'- -e-' '- -h-' '- -i-' '- -a-' '- -,-'
>--+--------------+--------------------------------------------><
'- -m QMgrName-'
2.23 &ar'metros opcionales
Parmetro Descripcin
-e ?equests details of e/ternall$ coordinated1 in.doubt transactions. uc! transactions are t!ose
for #!ic! Webp!ere MQ !as been as+ed to prepare to commit1 but !as not $et been informed
of t!e transaction outcome.
-(
?equests details of e/ternall$ coordinated transactions t!at #ere resol)ed b$ t!e rs)mqtrn
command1 and t!e e/ternal transaction coordinator !as $et to ac+no#ledge #it! an /a.
forget command. 8!is transaction state is termed *euristically completed b$ ':Dpen.
&ote: If $ou do not specif$ .e1 .!1 or Ii1 details of bot! internall$ and e/ternall$ coordinated
in.doubt transactions are displa$ed1 but details of e/ternall$ coordinated1 !euristicall$
completed transactions are not displa$ed.
-i ?equests details of internall$ coordinated1 in.doubt transactions. uc! transactions are t!ose
for #!ic! eac! resource manager !as been as+ed to prepare to commit1 but Webp!ere MQ
!as $et to inform t!e resource managers of t!e transaction outcome.
Information about t!e state of t!e transaction in eac! of its participating resource managers is
displa$ed. 8!is information can !elp $ou assess t!e affects of failure in a particular resource
manager.
&ote3 If $ou do not specif$ .e or .i1 details of bot! internall$ and e/ternall$ coordinated in.
doubt transactions are displa$ed.
-a ?equests a list of all transactions +no#n to t!e queue manager. 8!e returned data includes
transaction details for all transactions +no#n to t!e queue manager. If a transaction is
currentl$ associated #it! a Webp!ere MQ application connection1 information related to t!at
Webp!ere MQ application connection is also returned. 8!e data returned b$ t!is command
mig!t t$picall$ be correlated #it! t!e output of a runmqsc DI62AC 0D&& command1 and t!e
output fields !a)e t!e same meaning as in t!at command.
&ot all of t!e fields are appropriate for all transactions. W!en t!e fields are not meaningful1
t!e$ are displa$ed as blan+. 7or e/ample: 8!e %DW2DL )alue #!en t!e command is issued
against a circular logging queue manager.
-q
pecif$ing t!is parameter on its o#n is t!e same as specif$ing .a .q.
Displa$s all t!e data from t!e .a parameter and a list of up to =<< unique ob5ects updated
#it!in t!e transaction. If more t!an =<< ob5ects are updated in t!e same transaction1 onl$ t!e
first =<< distinct ob5ects are listed for eac! transaction.
-m!gr#ame 8!e name of t!e queue manager for #!ic! to displa$ transactions. If $ou omit t!e name1 t!e
transaction of t!e default queue manager are displa$ed.
Cd. )et. Descripcin
< Dperacin e/itosa
>= Error ine/perado
=<H &o transactions found
Command Descripcin
rs)mqtrn ?esol)e transaction
2.24 dspmqver
3isuali4a )ersin e informacin de construccin Webp!ere- MQ.
2.24.1 Propsito
%se el commando dspmqver para )isuali4ar la )ersion e informacin de construccin de
Webp!ere MQ.
6or defecto1 el comando dspmqver )isuali4e detalles de instalacin desde donde es
llamado. i e/isten otras instalaciones es )isuali4ada una notaR usa el par9metro 2i para )isuali4ar
sus detalles.
2.24.2 Sintaxis
>>-ds"mqver----------------------------------------------------->
>--+-+------+--+------------------+--+--------------+--+-----+--+-----+-+-><
| '- -a -' '- -" --components-' '- -f --"iel$s-' '- -b-' '- -v-' |
'- -i----------------------------------------------------------------'
Parmetro Descripcin
-a Displa$ information about all fields and components.
-p
9omponents
Displa$ information for t!e components specified b$ component. Eit!er a single component or
multiple components can be specified. Enter eit!er t!e )alue of a single component or t!e sum
of t!e )alues of all t!e required components. A)ailable components and related )alues follo#:
"alor Descripcin
= Webp!ere MQ ser)er1 o cliente.
H 0lases Webp!ere MQ para Oa)aU.
B 0lases Webp!ere MQ para er)icio de Mensa5e Oa)a
A Webcale Distribution Mub
=;
=
I,M- Webp!ere MQ custom c!annel for Windo#s 0ommunication 7oundation
EH I,M Message er)ice 0lient for .&E8 "'M .&E8( . t!is component is onl$ a)ailable
on Windo#s
;B LKit
=HA Webp!ere MQ Ad)anced Message ecurit$
#otas:
Supported by .ebSp*ere MQ +or .indo/s only- !+ you *ave not installed Microso+t -N0T ; or
later, t*e +ollo/ing error message is displayed5
Title5 .MQ.CBCustomC*annelevel-e6e ? #pplication 0rror
T*e application +ailed to initialize properly 8A6AAAAC;D:-
T*e de+ault value is C-
-f Campos 3isuali4a informacin para los campos especificados por campo. D bien especifica un campo
simple o multiples campos. D bien introduce el )alor de un campo simple o la suma de los
)alores de todos los campos necesarios. 2os campos disponibles $ )alores detallados on los
siguientes:
"alor Descripcin
= &ombre
H 3ersin1 en el formato 3.?.M.7:
Donde 3V3ersin1 ?V?e)isin1 MVModificacin1 $ 7V6ac+ de 7i5ado
B &i)el
A 8ipo de 0onstruccin
=; 6lataforma
EH Modo de direccionamiento
;B istema operati)e
=HA ?uta de instalacin
HG; Descripcin de instalacin
G=H &ombre de Instalacin
=<HB M9/imo ni)el de comando
H<BA Instalacin primaria
B<F; ?uta de dato
Information for eac! selected field is displa$ed on a separate line #!en t!e dspmq)er command
is run.
8!e default )alue is A=F=. 8!is displa$s information for all fields.
-b Dmit !eader information from t!e report.
-v Displa$ )erbose output.
-i Displa$ information about all installations. Cou cannot use t!is option #it! ot!er options. 8!e
installation from #!ic! t!e dspmq)er command #as issued is displa$ed first. 7or an$ ot!er
installations1 onl$ t!e follo#ing fields are displa$ed: &ame1 3ersion1 Installation name1
Installation description1 Installation pat!1 and 6rimar$ installation.
Cd. )et. Descripcin
2.24.5 Ejemplos
8!e follo#ing command displa$s Webp!ere MQ )ersion and build information1 using t!e
default settings for .p and .f :
ds"mqver
8!e follo#ing command displa$s information about all fields and components and is t!e
equi)alent of specif$ing dspmq)er .p ;E .f B<FG:
ds"mqver -a
8!e follo#ing command displa$s )ersion and build information for t!e Webp!ere MQ
classes for Oa)a:
ds"mqver -" 8
8!e follo#ing command displa$s t!e 0ommon er)ices for Oa)a 6latform tandard Edition1
I,M Webp!ere MQ1 Oa)a Message er)ice 0lient1 and Webp!ere MQ classes for Oa)a Message
er)ice:
ds"mqver -" D
8!e follo#ing command displa$s t!e build le)el of t!e Webcale Distribution Mub:
ds"mqver -" C -f D
El siguiente commando )isuali4e el nombre $ tipo de contruccin para canal personalidado
I,M Webp!ere MQ de Windo#s 0ommunication 7oundation:
ds"mqver -" =7 -f G
8!e follo#ing command displa$s information about installations of Webp!ere MQ.
ds"mqver -i
2.24.6 .allo de Comando
8!e dspmq)er command can fail if $ou tr$ to )ie# )ersion or build information for t!e
Webp!ere MQ classes for Oa)a1 and $ou !a)e not correctl$ configured $our en)ironment. 7or
e/ample1 $ou mig!t see t!e follo#ing message:
Vr..tRbladeCCF WXY ds"mqver -"8
AMQCFE=@ QebS"&ere MQ Zava envir.nment &as n.t been -.nfigured -.rre-tl!.
8o resol)e t!is problem1 ensure t!at t!e pat! is configured to include t!e O?E1 and t!at t!e
correct en)ironment )ariables are setR for e/ample1 b$ using set5msen) or set5msen);B. 7or
e/ample:
e,".rt %A(=[%A(@'."t'mqm'Sava'Sre'bin
-d '."t'mqm'Sava'bin'
. .'setSmsenv7D
Vr..tRbladeCCF binXY ds"mqver -"8
*ame@ QebS"&ere MQ -lasses f.r Zava
Versi.n@ B.=.A.A
4evel@ :AAA-4==AGAC
9uild !"e@ %r.du-ti.n
2.25 endmqcsv
Detiene el ser)idor de commando para un administrador de cola.
2.25.1 Propsito
%se el comando endmqscv para parar el ser)idor 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 est9 traba5ando. 6uede buscar que instalacin del administrador de cola est9
asociado con el usando el comando dspmq -o installation.
i el atributo administrador de cola1 /C!D/:)"1 es especificado como !<) entonces
cambiar el estado del ser)idor de comando usando endmqscv no tiene efecto seg@n actual el
administrador de cola !asta que el atributo /C!D/:)" se restaura la siguiente )e4.
2.25.2 Sintaxis
.- -- -.
>>-endmq-sv--+------+--QMgrName--------------------------------><
'- -i -'
Parmetro Descripcin
!gr#ame 8!e name of t!e queue manager for #!ic! to end t!e command ser)er.
Parmetro Descripcin
-c 6ara el ser)idor de commando en una forma controlada. El ser)idor de commando puede
completer el proceso de cualquier mensa5e de commando que $a est9 iniciado. &o se leen nue)os
mensa5es en la cola de comandos. Es el par9metro por defecto
-i 6ara el ser)idor de commando inmediatamente. 2as acciones asociadas con un mensa5e de
commando en proceso actual no se completar9n.
Cd. )et. Descripcin
2.25.6 Ejemplos
8!e follo#ing command stops t!e command ser)er on queue manager
saturn.queue.manager:
endmq-sv -- saturn.queue.manager
8!e command ser)er can complete processing an$ command it !as alread$ started before
it stops. An$ ne# commands recei)ed remain unprocessed in t!e command queue until t!e
command ser)er is restarted.
8!e follo#ing command stops t!e command ser)er on queue manager pluto immediatel$:
endmq-sv -i "lut.
Command Descripcin
strmqcs) tart a command ser)er
dspmqcs) Displa$ t!e status of a command ser)er
2.2 endmqlsr
7inali4a todos los procesos listener para un administrador de cola.
2.26.1 Propsito
El comando endmqlsr finali4e 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 est9 traba5ando. 6uede buscar qu administrador de cola est9 asociada a la instalacin
usando el comando dspmq -o installation.
Cou do not!a)e to stop t!e queue manager before issuing t!e endmqlsr command. If an$
of t!e listeners are configured to !a)e inbound c!annels running #it!in t!e runmqlsr listener
process1 rat!er t!an #it!in a pool process1 t!e request to end t!at listener mig!t fail if c!annels are
still acti)e. In t!is case a message is #ritten indicating !o# man$ listeners #ere successfull$ ended
and !o# man$ listeners are still running.
If t!e listener attribute1 0D&8?D21 is specified as QML? t!en c!anging t!e state of t!e
listener using endmqlsr does not effect !o# t!e queue manager acts upon t!e 0D&8?D2 attribute at
t!e ne/t restart.
2.26.2 Sintaxis
>>-endmqlsr--+------+--+----------------+----------------------><
'- -/ -' '- -m --QMgrName-'
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager. If $ou omit t!is parameter1 t!e command operates on t!e
default queue manager.
-* Wait before returning control.
0ontrol is returned to $ou onl$ after all listeners for t!e specified queue manager !a)e
stopped.
Cd. )et. Descripcin
2.2! endmqdnm
6ara el monitor .&E8 para una cola "solo Windo#s(.
2.27.1 Propsito
&ota: El commando endmqdnm se aplica solo a Webp!ere- MQ para Windo#s.
%se el commando de control endmqdnm para parar un monitor .&E8.
2.27.2 Sintaxis
>>-endmqdnm-- -q --QueueName--+----------------+---------------><
'- -m --QMgrName-'
Parmetro Descripcin
-q QueueName El nombre de la aplicacin de cola que el monitor .&E8 est9 monitori4ando.
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager t!at !osts t!e application queue.
If omitted1 t!e default queue manager is used.
Cd. )et. Descripcin
< Dperacin e/itosa
>= Error ine/perado
=EE %n+no#n ob5ect name error
2.2" endmqm
6ara el administrador de cola o cambia a un administrador de cola de reser)a.
2.2".1 Propsito
%se el comando endmqm para finali4ar "parar( un administrador de cola especificado. Este
comando para un administrador de cola en uno de estos tres modos:
0ontrolled or quiesced s!utdo#n
Immediate s!utdo#n
6re.empti)e s!ut do#n
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. 6uedes emitir el
commando endmqm bien en la instancia acti)e1 o una de las instancias de reser)e listas de un
administrador de cola multi.instancia. Debes emitir endmqm en la instancia acti)a para finali4ar el
If $ou issue t!e endmqm command on t!e acti)e instance of a multi.instance queue
manager1 $ou can permit a standb$ instance to s#itc! o)er to being t!e ne# acti)e instance #!en
t!e current acti)e instance completes its s!utdo#n.
If $ou issue t!e endmqm command on a standb$ instance of a multi.instance queue
manager1 $ou can end t!e standb$ instance b$ adding t!e ./ option1 and lea)e t!e acti)e instance
running. 8!e queue manager reports an error if $ou issue endmqm on t!e standb$ instance #it!out
t!e ./ option.
Issuing t!e endmqm command #ill affect an$ client application connected t!roug! a
ser)er.connection c!annel. 8!e effect )aries depending on t!e parameter used1 but it is as t!oug! a
8D6 0MA&&E2 command #as issued in one of t!e t!ree possible modes. ee topping c!annels1 for
information about t!e effects of 8D6 0MA&&E2 modes on ser)er.connection c!annels. 8!e endmqm
optional parameter descriptions state #!ic! 8D6 0MA&&E2 mode t!e$ #ill be equi)alent to.
If $ou issue endmqm to stop a queue manager1 reconnectable clients do not tr$ to
reconnect. 8o o)erride t!is be!a)ior1 specif$ eit!er t!e .r or .s option to enable clients to start tr$ing
to reconnect.
Nota' !+ a queue manager or a c*annel ends une6pectedly, reconnectable clients start
trying to reconnect-
Nota' T*e client mig*t not reconnect to t*is queue manager- %epending on t*e
MQC)NN3 reconnect option t*e client *as used, and t*e de+inition o+ t*e queue
manager group in t*e client connection table, t*e client mig*t reconnect to a
di++erent queue manager- (ou can con+igure t*e client to +orce it to reconnect to t*e
same queue manager-
Cou must use t!e endmqm command from t!e installation associated #it! t!e queue
manager t!at $ou are #or+ing #it!. Cou can find out #!ic! installation a queue manager is
associated #it! using t!e dspmq .o installation command.
8!e attributes of t!e queue manager and t!e ob5ects associated #it! it are not affected b$
t!e endmqm command. Cou can restart t!e queue manager using t!e strmqm "tart queue
manager( command.
8o delete a queue manager1 stop it and t!en use t!e dltmqm "Delete queue manager(
command.
2.2".2 Sintaxis
.- -- -.
>>-endmqm--+------+--+-+------+--+------+-+--QMgrName----------><
'- -z -' | +- -/ -+ +- -s -+ |
| +- -i -+ '- -r -' |
| '- -" -' |
'- -, ---------------'
2.2".3 Parmetros necesarios
Parmetro Descripcin
QMgrName El nombre del administrador de cola de mensa5e a ser parado.
2.2".4 Parmetros opcionales
Parmetro Descripcin
-c 0ontrolled "or quiesced( s!utdo#n. 8!is parameter is t!e default.
8!e queue manager stops1 but onl$ after all applications !a)e disconnected. An$ MQI calls
currentl$ being processed are completed. In t!e unli+el$ e)ent t!at a dspmq command is issued
in t!e small timeframe bet#een t!e applications disconnecting and t!e queue manager actuall$
stopping1 t!e dspmq command mig!t transientl$ report t!e status as Ending immediatel$1 e)en
t!oug! a controlled s!utdo#n #as requested.
0ontrol is returned to $ou immediatel$ and $ou are not notified of #!en t!e queue manager !as
stopped.
8!e effect on an$ client applications connected t!roug! a ser)er.connection c!annel is equi)alent
to a 8D6 0MA&&E2 command issued in Q%IE0E mode.
-i Immediate s!utdo#n. 8!e queue manager stops after it !as completed all t!e MQI calls currentl$
being processed. An$ MQI requests issued after t!e command !as been issued fail. An$
incomplete units of #or+ are rolled bac+ #!en t!e queue manager is ne/t started.
0ontrol is returned after t!e queue manager !as ended.
to a 8D6 0MA&&E2 command issued in 7D?0E mode.
-p 6re.empti)e s!utdo#n.
%se t!is t$pe of s!utdo#n onl$ in e/ceptional circumstances. 7or e/ample1 #!en a queue
manager does not stop as a result of a normal endmqm command.
8!e queue manager mig!t stop #it!out #aiting for applications to disconnect or for MQI calls to
complete. 8!is can gi)e unpredictable results for Webp!ere MQ applications. 8!e s!utdo#n
mode is set to immediate s!utdo#n. If t!e queue manager !as not stopped after a fe# seconds1
t!e s!utdo#n mode is escalated1 and all remaining queue manager processes are stopped.
to a 8D6 0MA&&E2 command issued in 8E?MI&A8E mode.
-r tart tr$ing to reconnect reconnectable clients. 8!is parameter !as t!e effect of reestablis!ing t!e
connecti)it$ of clients to ot!er queue managers in t!eir queue manager group.
-s #itc! o)er to a standb$ queue manager instance after s!utting do#n. 8!e command c!ec+s t!at
t!ere is a standb$ instance running before ending t!e acti)e instance. It does not #ait for t!e
standb$ instance to start before ending.
0onnections to t!e queue manager are bro+en b$ t!e acti)e instance s!utting do#n.
?econnectable clients start tr$ing to reconnect.
Cou can configure t!e reconnection options of a client to reconnect onl$ to anot!er instance of t!e
same queue manager1 or to reconnect to ot!er queue managers in t!e queue manager group.
-* Wait s!utdo#n.
8!is t$pe of s!utdo#n is equi)alent to a controlled s!utdo#n e/cept t!at control is returned to
$ou onl$ after t!e queue manager !as stopped. Cou recei)e t!e message Waiting for queue
manager qm&ame to end #!ile s!utdo#n progresses. In t!e unli+el$ e)ent t!at a dspmq
command is issued in t!e small timeframe bet#een t!e applications disconnecting and t!e queue
manager actuall$ stopping1 t!e dspmq command mig!t transientl$ report t!e status as Ending
immediatel$1 e)en t!oug! a controlled s!utdo#n #as requested.
to a 8D6 0MA&&E2 command issued in Q%IE0E mode.
-& End a standb$ instance of t!e queue manager1 #it!out ending t!e acti)e instance of t!e queue
manager.
-4 uppresses error messages on t!e command.
Cd. )et. Descripcin
< Queue manager ended
>= Error ine/perado
>> Webp!ere MQ queue manager cannot s#itc! o)er
>F
Acti)e instance of Webp!ere MQ queue manager QmgrName not ended
F<
tandb$ instance of Webp!ere MQ queue manager QmgrName not ended
Cd. )et. Descripcin
==F 6ermission denied
2.2".6 Ejemplos
El siguiente e5emplo muestra comandos que paran los administradores de cola
especificados.
8!is command ends t!e queue manager named mercur$.queue.manager in a controlled
#a$. All applications currentl$ connected are allo#ed to disconnect.
endmqm mer-ur!.queue.manager
8!is command ends t!e queue manager named saturn.queue.manager immediatel$. All
current MQI calls complete1 but no ne# ones are allo#ed.
endmqm -i saturn.queue.manager
2os resultados de emitir el commando endmqm en la instancia local de un administrador de
cola multi.instancia son mostrados en la table siguiente. 8!e results of t!e command depend on
#!et!er t!e .s or ./ s#itc! is used1 and t!e running status of local and remote instances of t!e
queue manager.
Tabla 3+ acciones !e en!m*m
%pcin
endmqm
%rdenador
9ocal
%rdenador
)emoto
)C !ensa7e )esultado
Acti)a &inguna < . 7inali4ado administrador de cola.
?eser)a 7inali4ado administrador de cola1 incluido la
instancia de reser)a.
?eser)a Acti)a F< AMQAE;A tandb$ instance of Webp!ere MQ queue
manager QmgrName not ended.
-s Acti)a &inguna >> AMQ>H>; Webp!ere MQ queue manager cannot s#itc!
o)er.
?eser)a < . Queue manager QM&AME ended1 permitting
s#itc!o)er to a standb$ instance.
?eser)a Acti)a F< AMQAE;A tandb$ instance of Webp!ere MQ queue
-& Acti)a &inguna >F AMQAE;> Acti)e instance of Webp!ere MQ queue
?eser)a
?eser)a Acti)a < . tandb$ instance of queue manager QM&AME
ended.
2.2".7 Comandos relacionados
Comando Descripcin
crtmqm Define un administrador de cola
endmqm End queue manager
dltmqm Delete queue manager
2.2# endmqsvc (finali(ar servicio )*+ ,eb-phere +.)
El comando endmqsvc finali4a el ser)icio I,M- Webp!ere- MQ en Windo#s. "lo
Windo#s(.
2.2,.1 Propsito
El comando finali4a el ser)icio I,M Webp!ere MQ en Windo#s.
E5ecutar el comando para finali4ar el ser)icio1 si el ser)icio est9 e5ecut9ndose.
?estaurar el ser)icio para Webp!ere MQ procesa recogida de un &ue)o entorno1 incluido
nue)as definiciones de seguridad
2.2,.2 Sintaxis
endmqsv-
2.2,.3 Parmetros
El comando endmqsvc no tiene par9metros.
Debes seleccionar la ruta de instalacin que contiene el ser)icio. ,ien fabricando la
instalacin primaria1 e5ecutando el comando setmqenv1 o e5ecutando el commando desde el
directorio que contiene el fic!ero binario endmqsvc.
2.2,.4 *e+erencia relacionada)
strmqs)c "tart I,M Webp!ere MQ ser)ice(
2.3$ endmqtrc
7inali4a el tra4ado para alguna o todas las entidades que est9n en tra4ado.
2.3-.1 Propsito
%se el comando endmqtrc para finali4ar el tra4ad de la entidad especificada o todas las
entidades. El comando endmqtrc finali4e solo el tra4ado que est9 descrito por sus par9metros. %sar
endmqtrc sin par9metros finali4a r9pidamente el tra4ado para todos los procesos.
2.3-.2 Sintaxis
2a sint9/is de este comando es la siguiente:
>>-endmqtr---+----------------+--+---------------+-------------->
'- -m --QMgrName-' '- -i --Pi$Ti$s-'
>--+------------+--+------+--+------+--------------------------><
'- -" --%pps-' '- -e -' '- -a -'
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager for #!ic! to end tracing.
8!e QMgr&ame supplied must matc! e/actl$ t!e QMgr&ame supplied on t!e strmqtrc
command. If t!e strmqtrc command used #ildcards1 t!e endmqtrc command must use t!e
same #ildcard specification including t!e escaping of an$ #ildcard c!aracters to pre)ent
t!em being processed b$ t!e command en)ironment.
A ma/imum of one .m flag and associated queue manager name can be supplied on t!e
command.
-i PidTids 6rocess identifier "6ID( and t!read identifier "8ID( for #!ic! to end tracing. Cou cannot use
t!e .i flag #it! t!e .e flag. If $ou tr$ to use t!e .i flag #it! t!e .e flag1 t!en an error
message is issued. 8!is parameter must onl$ be used under t!e guidance of I,M- er)ice
personnel
-p Apps 8!e named processes for #!ic! to end tracing. Apps is a comma.separated list. Cou must
specif$ eac! name in t!e list e/actl$ as t!e program name #ould be displa$ed in t!e
Q6rogram &ameQ 7D0 !eader. Asteris+ "J( or question mar+ "W( #ildcards are allo#ed. Cou
cannot use t!e .p flag #it! t!e .e flag. If $ou tr$ to use t!e .p flag #it! t!e .e flag1 t!en an
error message is issued.
-e Ends earl$ tracing of all processes.
%sing endmqtrc #it! no parameters !as t!e same effect as endmqtrc .e. Cou cannot specif$
t!e .e flag #it! t!e .m flag1 t!e .i flag1 or t!e .p flag.
-a Ends all tracing.
8!is flag must be specified alone.
2.3-.4 Cdigos de retorno
Cd. )et. Descripcin
AMQG;== 8!is message is issued if $ou suppl$ in)alid arguments to t!e command.
2.3-.5 Ejemplos
Este commando finali4e el tra4ado de datos para un administrador de cola llamado QM3.
endmqtr- -m QM=
2os e5emplos siguientes son una secuencia que muestra como el commando endmqtrc
finali4e solo el tra4ado que est9 descrito por sus par9metros.
El siguiente commando acti)e la tra4a para el administrador de cola QM3 $ proceso
am*xxx+exe:
strmqtr- -m QM= -" amq,,,.e,e
El siguiente commando acti)e la tra4a para el administrador de cola QM?:
strmqtr- -m QM8
El siguiente commando finali4e la tra4a para el administrador de cola QM? solamente. El
tra4ado de administrador de cola QM3 $ proceso am*xxx+exe contin@a:
endmqtr- -m QM8
2.3-.6 Comandos relacionados
Command Descripcin
dspmqtrc 3isuali4a salida del tra4ado formatado
strmqtrc Inicia el tra4ado
2.31 mi%mbbrk
8!e migmbbr+ command migrates publis!:subscribe configuration data from Webp!ere-
E)ent ,ro+er 3ersion ;.< or Webp!ere Message ,ro+er 3ersion ;.< or ;.= to Webp!ere MQ
3ersion >.<.= or later )ersions.
2.31.1 Propsito
T-e migmbbr@ comman! is not supporte! on all of t-e platforms t-at 2ebSp-ere
MQ supports+ See upported operating s$stems for !etails+
8o use t!e migmbbr+ command $ou must be using at least Webp!ere Message ,ro+er
3ersion ;.<1 7i/ 6ac+ F1 or Webp!ere Message ,ro+er 3ersion ;.=1 7i/ 6ac+ B.
%se t!e migmbbr+ command to migrate t!e publis!:subscribe configuration data from a
Webp!ere E)ent ,ro+er 3ersion ;.< or a Webp!ere Message ,ro+er 3ersion ;.< or 3ersion ;.=
bro+er to a Webp!ere MQ 3ersion >.<.= or later queue manager. 8!e command runs a migration
process t!at migrates t!e follo#ing publis!:subscribe configuration data to t!e queue manager t!at
is associated #it! t!e named bro+er:
ubscriptions
ubscription points. "ubscription points are supported onl$ #!en ?7MH messages are
used.(
treams
?etained publications
8!e migmbbr+ command does not migrate t!e Access 0ontrol 2ist "A02(. Instead1 running
t!e migration #it! t!e .t or .r parameters produces a file containing suggested setmqaut commands
to set up a securit$ en)ironment in t!e queue manager t!at is equi)alent to t!e securit$
en)ironment t!at e/isted in t!e bro+er. Cou must re)ie# and modif$ t!e securit$ command file as
needed and run t!e commands to set up a securit$ en)ironment in t!e queue manager1 equi)alent
to t!e one t!at e/isted in t!e bro+er1 before $ou run t!e migration #it! t!e .c parameter to
complete t!e migration.
&ote: Dn %&I' s$stems1 all aut!orities are !eld b$ user groups internall$1 not b$ principals.
8!is !as t!e follo#ing implications:
If $ou use t!e setmqaut command to grant an aut!orit$ to a principal1 t!e aut!orit$ is
granted to t!e primar$ user group of t!e principal. 8!is means t!at t!e aut!orit$ is
effecti)el$ granted to all members of t!at user group.
If $ou use t!e setmqaut command to re)o+e an aut!orit$ from a principal1 t!e
aut!orit$ is re)o+ed from t!e primar$ user group of t!e principal. 8!is means t!at t!e
aut!orit$ is effecti)el$ re)o+ed from all members of t!at user group.
Cou must issue t!e migmbbr+ command from a command #indo# t!at can e/ecute bot!
Webp!ere MQ and Webp!ere Message ,ro+er commands successfull$. 8$picall$ t!is is true if t!e
command is issued from a Webp!ere Message ,ro+er command console.
8!e Webp!ere E)ent ,ro+er 3ersion ;.< or Webp!ere Message ,ro+er 3ersion ;.< or ;.=
publis!:subscribe configuration data1 #!ic! is stored in t!e subscription database tables1 is not
deleted b$ t!e migration process. 8!is configuration data is t!erefore a)ailable to use until $ou
e/plicitl$ delete it.
2.31.2 Sintaxis
.----------.
V |
>>-migmbbr:--+- -- -+----+------+-+-- -b --3ro4erName----------><
+- -r -+ +- -l -+
'- -t -' +- -. -+
+- -s -+
'- -z -'
Parmetro Descripcin
-b 1ro@erName 8!e name of t!e bro+er t!at is t!e source of t!e publis!:subscribe configuration data t!at is
to be migrated. 8!e queue manager to #!ic! t!e publis!:subscribe configuration data is
migrated is t!e queue manager t!at is associated #it! t!e named bro+er.
-c 0omplete t!e migration of t!e publis!:subscribe configuration data. 8!e completion p!ase of
t!e migration uses t!e topic ob5ects t!at are created in t!e initial .t p!ase. It is possible t!at
t!e bro+er state !as c!anged since t!e initial p!ase #as run and t!at ne# additional topic
ob5ects are no# required. If so1 t!e completion p!ase creates ne# topic ob5ects as
necessar$. 8!e completion p!ase does not delete an$ topic ob5ects t!at !a)e become
unnecessar$R $ou mig!t need to delete an$ topic ob5ects t!at $ou do not require.
,efore $ou complete t!e migration $ou must re)ie# and modif$ t!e securit$ command file
produced in t!e .r or .t p!ase as required and e/ecute t!e commands to set up a securit$
en)ironment in t!e queue manager1 equi)alent to t!e one t!at e/isted in t!e bro+er.
,efore $ou run t!is completion p!ase1 $ou must run t!e initial .t p!ase. Cou cannot use t!e
.c parameter #it! t!e .r parameter or t!e .t parameter. 8!is p!ase also creates a migration
log.
-r ?e!earse t!e migration process but do not c!ange an$t!ing. Cou can use t!is parameter
before running t!e migration #it! t!e .t parameter1 to create a migration log1 including an$
errors1 so t!at $ou can obser)e #!at t!e result of t!e migration process #ould be1 but
#it!out c!anging t!e current configurations.
?e!earsing t!e migration also produces a file containing suggested setmqaut commands to
set up a securit$ en)ironment in t!e queue manager t!at is equi)alent to t!e securit$
en)ironment t!at e/isted in t!e bro+er. ,efore $ou complete t!e migration #it! t!e .c
parameter $ou must re)ie# and modif$ t!e securit$ command file as required and e/ecute
t!e commands to set up a securit$ en)ironment in t!e queue manager1 equi)alent to t!e one
t!at e/isted in t!e bro+er.
Cou cannot use t!e .r parameter #it! t!e .c parameter or t!e .t parameter.
-t 0reate topic ob5ects t!at mig!t be needed in t!e queue manager1 based on t!e A02 entries
t!at are defined in t!e bro+er.
%se of t!e .t parameter also produces a file containing suggested setmqaut commands to set
up a securit$ en)ironment in t!e queue manager t!at is equi)alent to t!e securit$
en)ironment t!at e/isted in t!e bro+er. 8!e topic ob5ects are created in anticipation of $ou
e/ecuting t!e securit$ commands to create A02s for t!e topic ob5ects. ,efore $ou complete
t!e migration #it! t!e .c parameter $ou must re)ie# and modif$ t!e securit$ command file
as required and e/ecute t!e commands to set up a securit$ en)ironment in t!e queue
manager1 equi)alent to t!e one t!at e/isted in t!e bro+er.
Cou must run t!is p!ase before $ou run t!e completion p!ase #it! t!e .c parameter. Cou
cannot use t!e .t parameter #it! t!e .c parameter or t!e .r parameter. 8!is p!ase also
creates a migration log.
Parmetro Descripcin
-l 2ea)e t!e bro+er running. If $ou do not specif$ t!is parameter1 t!e bro+er is s!ut do#n b$
default at t!e end of t!e migration process.
-o D)er#rite an$ subscription or retained publication t!at e/ists in t!e queue manager and t!at !as
t!e same name as a subscription or retained publication t!at is being migrated from t!e bro+er1
#it! t!e publis!:subscribe configuration data t!at #as retrie)ed from t!e bro+er. 8!e .o
parameter !as no effect if $ou use it #it! t!e .r parameter.
-s Discard an$ intermediate configuration data t!at #as retained from a pre)ious instance of t!e
migration process t!at failed or #as interrupted. 8!e migration process populates pri)ate queues
#it! temporar$ data. If t!e migration process completes successfull$1 t!e temporar$ data is
deleted. If $ou do not specif$ t!is parameter and t!e migration process fails or is interrupted1 t!e
temporar$ data is retained and is used b$ t!e migration process if $ou restart it1 so t!at t!e
process resumes at t!e point #!ere it pre)iousl$ failed or #as interrupted.
-4 ?un t!e migration process1 regardless of #!et!er it !as pre)iousl$ run to a successful completion.
If $ou do not specif$ t!is parameter and t!e migration process !as pre)iousl$ run to a successful
completion1 t!e process recogni4es t!is fact and e/its. Cou can use t!e .o parameter #it! t!e .4
parameter1 but t!is is not mandator$. A pre)ious re!earsal of t!e migration using t!e .r
parameter does not count as a successful completion
Cd. )et. :&planation
< Migration completed successfull$
2.31.6 2'tp't +iles
8!e migration process #rites t#o output files to t!e current director$:
amqmigratea-l.t,t
A file containing a list of setmqaut commands1 created in t!e current director$ for $ou to
re)ie#1 c!ange1 and run if appropriate1 to !elp $ou to reproduce $our A02s.
amqmigmbbr:.l.g
A log file containing a record of t!e details of t!e migration.
2.31.7 Ejemplos
8!is command migrates t!e publis!:subscribe configuration data of bro+er ,?K= into its
associated queue manager and specifies t!at t!e migration process runs regardless of #!et!er it !as
pre)iousl$ run to a successful completion. It also specifies t!at an$ subscription or retained
publication t!at e/ists in t!e queue manager1 t!at !as t!e same name as a subscription or retained
publication t!at is being migrated from t!e bro+er1 must be o)er#ritten.
migmbbr: -z -. -b 92\=
2.31." S'pported operating s%stems
8!e migmbbr1 command is supported onl$ on t!e follo#ing platforms t!at support
Webp!ere E)ent ,ro+er 3ersion ;.< or Webp!ere Message ,ro+er 3ersion ;.<:
Microsoft Windo#s '6 6rofessional #it! 6H1 EHIbit )ersions onl$
olaris /A;.;B platform: olaris =<
olaris 6A?0 platform: un olaris F ";BIbit(
AI'- 3ersion G.H or later1 ;BIbit onl$
M6.%' Itanium platform: M6.%' ==i
2inu/ 4eries- ";B.bit(
2inu/ 6o#er60- ";BIbit(
2inu/ Intel /A;
2inu/ Intel /A;I;B
Dn 4:D-1 t!e equi)alent function to t!e migmbbr+ command is pro)ided b$ t!e
0Q%MLM, utilit$.
2.32 mqrc (+. /0d. 1et.)
3isuali4a informacin sobre 0digos de ?etorno.
2.32.1 Propsito
6uedes usar el comando mqrc para )isuali4ar informacin sobre s*mbolos1 cdigos de
retorno1 $ mensa5es AMQ. 6uedes especificar un rango de cdigos de retorno o mensa5es AMQ1 as
as* como cdigos de retorno o mensa5es AMQ espec*ficos.
2os argumentos numricos son tenterpretados como decimal si comien4an con un d*gito = .
F1 o !e/adecimal si est9 prefi5ado con </.
2.32.2 Sintaxis
>>-+-+-----+--+-----+--+-returnCo$e-------------------------+-+-><
| '- -a ' '- -b ' +- -r -returnCo$e--------------------+ |
| +-%MQmessage-------------------------+ |
| +- -m -%MQmessage--------------------+ |
| +- -2 -+---------------------------+-+ |
| | | H=I | | |
| | '- -f -"irst-- -l -last-----' | |
| | H=I | |
| '- -M - -f -"irst-- -l -last---------' |
'-+-----+--sym!ol------------------------------------------'
'- -s-'
Notas' .f t-ere is a problem Ait- a message Ait-in a range( an in!ication is
!isplaye! before t-e message text+ B is !isplaye! if t-ere are no matc-ing
return co!es for t-e message+ C is !isplaye! if t-e message se"erity is
!ifferent to t-e return co!e se"erity+
2.32.3 Parmetros
Parmetro Descripcin
return9o!e El cdigo de retorno a )isuali4ar
AMQmessage El mensa5e AMQ a )isuali4ar
symbol El s*mbolo a )isuali4ar
-a 6rueba todas las )e)eridades para encontrar te/to de mensa5e
-b 3isuali4a mensa5es son informacin e/tendida
-f first 6rimer n@mero en un rango
-l last Xltimo n@mero en un rango
-m AMQmessage El mensa5e AMQ a listar
-! 3isuali4a mensa5es AMQ en un rango
-r return9o!e El cdigo de retorno a )isuali4ar
-) 3isuali4a todos los cdigos de retorno. i es usado con lo par9metros If $ Il1 .? )isuali4e
los cdigo de retorno en un ?ango.
-s symbol 8!e s$mbol to displa$
2.32.4 Ejemplos
El comando )isuali4a mensa5e AMQ G<<G:
mqr- AMQEAAE
Este comando )isuali4a -Udig.s de ret.rn. en el rang. 8EAE . HGE<:
mqr- -2 -f 8EAE -l 8EFA
2.33 rcrmqob2
?e.define un ob5eto1 o grupo de ob5etos1 desde sus im9genes contenidas en el 2og.
2.33.1 Propsito
%se t!is command to re.create an ob5ect1 or group of ob5ects1 from t!eir images contained
in t!e log. 8!is command can onl$ be used #!en using linear logging. %se t!e associated command1
rcdmqimg1 to record t!e ob5ect images to t!e log.
%se t!is command on a running queue manager. All acti)it$ on t!e queue manager after
t!e image #as recorded is logged. 8o re.create an ob5ect1 repla$ t!e log to re.create e)ents t!at
occurred after t!e ob5ect image #as captured.
2.33.2 Sintaxis
>>-r-rmq.bS--+----------------+--+------+-- -t (!)ectType------->
'- -m --QMgrName-' '- -z -'
>--eneric(!)Name----------------------------------------------><
Parmetro Descripcin
5eneric:b;Name 8!e name of t!e ob5ect to re.create. 8!is parameter can !a)e a trailing asteris+ to re.
create an$ ob5ects #it! names matc!ing t!e portion of t!e name before t!e asteris+.
8!is parameter is required unless t!e ob5ect t$pe is t!e c!annel s$nc!roni4ation fileR an$
ob5ect name supplied for t!is ob5ect t$pe is ignored.
-t %b7ectT'pe 8!e t$pes of ob5ect to re.create. 3alid ob5ect t$pes are:
- o all 8odos los tipos de ob5etos.
aut(info Aut!entication information ob5ect1 for use #it! ecure oc+ets 2a$er
"2( c!annel securit$
c(annel o c(l 0anales
clntconn o clcn 0anales cone/in cliente
clc(ltab 8abla de canal cliente
listener o lstr 2istener
namelist o nl &amelists
process o prcs 6rocesos
queue o q 8odos los tipos de cola
qalias o qa Alias de colas
qlocal o ql 0olas locales
qmodel o qm 0olas modelo
qremote o qr 0olas remotas
service o srvc er)icio
s'ncfile 0!annel s$nc!roni4ation file.
Cou can use t!is option #!en circular logs are configured but
t!es$ncfile fails if t!e c!annel scratc!pad files1 #!ic! are used to
rebuild s$ncfile1 are damaged or missing.
topic o top 8emas
Note3 2-en using 2ebSp-ereD MQ for 8N.< systems( you must pre"ent t-e
s-ell from interpreting t-e meaning of special c-aracters( for example( an
asteris@ E*F+ 7oA you !o t-is !epen!s on t-e s-ell you are using( but mig-t
in"ol"e t-e use of single *uotation mar@s EGF( !ouble *uotation mar@s EHF( or a
bac@slas- E0F+
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager for #!ic! to re.create ob5ects. If omitted1 t!e command
operates on t!e default queue manager.
Cd. )et. Descripcin
< Dperacin e/itosa
;; Media image not a)ailable
;A Media reco)er$ not supported
>= Error ine/perado
==F %ser not aut!ori4ed
=HA &o ob5ects processed
=EG 8emporar$ ob5ect cannot be reco)ered
=E; Db5ect in use
2.33.6 Ejemplos
El siguiente commando recrea todas las colas locales para el administrador de cola por
defecto:
r-rmq.bS -t ql 0
El siguiente commando recrea todas las colas remotas asociadas con el administrador de
cola almacen:
r-rmq.bS -m almacen -t qr 0
Comando Descripcin
rcdmqimg ?ecord an ob5ect in t!e log
2.34 rmvmqinf
?etira informacin de configuracin Webp!ere- MQ "solo plataforma Windo#s $ %&I'(.
2.34.1 Propsito
%se el comando rmvmqinf para retirar informacin de configuracin Webp!ere MQ.
Debe usar el comando rmvmqinf desde la instalacin asociada con el administrador de
cola que est9s traba5ando. 6uedes buscar que admnistrador de cola est9 asociado a la instalacin
usando el comando dspmq -o installation.
2.34.2 Sintaxis
.- -s -QueueManager-.
>>-rmvmqinf -+-------------------+--Stan/aName-----------------><
'- -s -Stan/aType---'
Parmetro Descripcin
/tan4a#ame 8!e name of t!e stan4a. 8!at is1 t!e )alue of t!e +e$ attribute t!at distinguis!es bet#een
multiple stan4as of t!e same t$pe.
Parmetro Descripcin
-s /tan4aT'pe 8!e t$pe of stan4a to remo)e. If omitted1 a QueueManager stan4a is remo)ed.
8!e onl$ supported )alue of StanzaType is QueueManager.
Cd. )et. Descripcin
< Dperacin e/itosa
G Queue manager is running
H; Queue manager is running as a standb$ instance
EF ,ad command line parameters
BB tan4a does not e/ist
BF Queue manager is stopping
;F Almacenamiento no disponible
>= Error ine/perado
2.34.6 Ejemplo
rmvmqinf QM.*AM+
2.34.7 otas de !so
%se rm)mqinf to remo)e an instance of a multi.instance queue manager.
8o use t!is command $ou must be a Webp!ere MQ administrator and a member of t!e
mqm group.
2.34." Comandos relacionados
Command Descripcin
addmqinf Add queue manager configuration information
Command Descripcin
dspmqinf Displa$ queue manager configuration information
2.35 rsvmqtrn
?esol)e in.doubt and !euristicall$ completed transactions
2.35.1 Propsito
El comando rsvmqtrn es usado para resol)er dos estados de transaccin.
2.35.1.1 IN-DOUBT TRANSACTIONS
%se t!e rs)mqtrn command to commit or bac+ out internall$ or e/ternall$ coordinated in.
doubt transactions.
&ote: %se t!is command onl$ #!en $ou are certain t!at transactions cannot be resol)ed b$
t!e normal protocols. Issuing t!is command mig!t result in t!e loss of transactional integrit$
bet#een resource managers for a distributed transaction.
2.35.1.2 HEURISTICALLY COMPLETED TRANSACTIONS
%se t!e rs)mqtrn command #it! t!e .f option for Webp!ere- MQ to remo)e all
information about e/ternall$ coordinated transactions t!at #ere pre)iousl$ resol)ed manuall$ using
t!e rs)mqtrn command1 but t!e resolution !as not been ac+no#ledged b$ t!e transaction
coordinator using t!e /a.forget command. 8ransactions t!at are manuall$ resol)ed b$ a resource
manager and unac+no#ledged b$ t!e transaction manager1 are +no#n as *euristically completed
transactions b$ ':Dpen.
&ote: Dnl$ use t!e .f option if t!e e/ternal transaction coordinator is permanentl$
una)ailable. 8!e queue manager1 as a resource manager1 remembers t!e transactions t!at are
committed or bac+ed out manuall$ b$ t!e rs)mqtrn command.
2.35.2 Sintaxis
>>-rsvmqtrn--+- -a -------------------------+-- -m --QMgrName--><
'-+- -b --------+--Transaction-'
+- -- --------+
+- -f --------+
'- -r --RMID -'
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager.
Parmetro Descripcin
-a 8!e queue manager resol)es all internall$ coordinated1 in.doubt transactions "t!at is1 all
global units of #or+(.
-b ,ac+s out t!e named transaction. 8!is flag is )alid for e/ternall$ coordinated transactions
"t!at is1 for e/ternal units of #or+( onl$.
-c 0ommits t!e named transaction. 8!is flag is )alid for e/ternall$ coordinated transactions
"t!at is1 e/ternal units of #or+( onl$.
-f 7orgets t!e named !euristicall$ completed transaction. 8!is flag is )alid onl$ for e/ternall$
coordinated transactions "t!at is1 e/ternal units of #or+( t!at are resol)ed1 but
unac+no#ledged b$ t!e transaction coordinator.
&ote: %se onl$ if t!e e/ternal transaction coordinator is ne)er going to be able to
ac+no#ledge t!e !euristicall$ completed transaction. 7or e/ample1 if t!e transaction
coordinator !as been deleted.
-r )!+D 8!e participation of t!e resource manager in t!e in.doubt transaction can be ignored. 8!is
flag is )alid for internall$ coordinated transactions onl$1 and for resource managers t!at !a)e
!ad t!eir resource manager configuration entries remo)ed from t!e queue manager
configuration information.
&ote: 8!e queue manager does not call t!e resource manager. Instead1 it mar+s t!e
participation of t!e resource manager in t!e transaction as being complete.
Transaction 8!e transaction number of t!e transaction being committed or bac+ed out. %se t!e dspmqtrn
command to find t!e rele)ant transaction number. 8!is parameter is required #it! t!e .b1 .c1
and .r ?MID parameters.
Cd. )et. Descripcin
< Dperacin e/itosa
EH 8ransactions could not be resol)ed
EB ?esource manager not recogni4ed
EG ?esource manager not permanentl$ una)ailable
>= Error ine/perado
AG 8ransactions not +no#n
Command Descripcin
dspmqtrn Displa$ list of prepared transactions
2.3 runmqchi
E5ecuta un canal iniciador de proceso para automati4ar canals iniciados.
2.36.1 Propsito
%se el comando runmqc(i para e5ecutar un proceso iniciador de canal.
Debe usar el comando runmqc(i desde la instalacin asociada con el administrador de cola
con el que est9s traba5ando. 6uedes encontrar que la instalacin de un administrador de cola est9
asociado con el usando el comando dspmq -o installation.
El iniciador de canal comien4a por defecto como parte del administrador de cola.
2.36.2 Sintaxis
>>-runmq-&i--+-----------------------+--+----------------+-----><
'- -q --InitiationQName-' '- -m --QMgrName-'
Parmetro Descripcin
-q .nitiationQName El nombre de iniciacin de cola a ser procesado por este canal iniciador. i se omite es
usado C8EM.0MA&&E2.I&I8Q.
-m QMgrName El nombre del administrador de cola en que la cola de iniciacin e/iste. i omites el
nombre1 es usado el administrador de cola por defecto.
Cd. )et. Descripcin
If errors occur t!at result in return codes of eit!er =< or H<1 re)ie# t!e queue manager
error log t!at t!e c!annel is associated #it! for t!e error messages1 and t!e s$stem error log for
records of problems t!at occur before t!e c!annel is associated #it! t!e queue manager. 7or more
information about error logs1 see Error log directories.
2.3! runmqchl
Inicia un emisor o canal peticionario.
2.37.1 Propsito
%se el comando runmqc(l para e5ecutar bien un canal emisor "D?( o peticionario
"?Q8?(.
El cana se e5ecuta sincronicamente. 6ara parar el canal1 emitir el comando !/C /T%P
C@A##:9.
2.37.2 Sintaxis
>>-runmq-&l-- -- --ChannelName--+----------------+-------------><
'- -m --QMgrName-'
Parmetro Descripcin
-c C(annel#ame El nombre del canal a e5ecutarse.
Parmetro Descripcin
-m !gr#ame 8!e name of t!e queue manager #it! #!ic! t!is c!annel is associated. If $ou omit t!e
name1 t!e default queue manager is used.
Cd. )et. Descripcin
i son generados los cdigos de retorno =< H<1 re)isar el log de error del administrador
de cola asociado para los mensa5es de error1 $ el log error de sistema para registro de problemas
que ocurren antes de que el canal est asociado con el administrador de cola.
2.3" runmqdlq
tart t!e dead.letter queue !andler to monitor and process messages on t!e dead.letter
queue.
2.3".1 Propsito
%se t!e runmqdlq command to start t!e dead.letter queue "D2Q( !andler1 #!ic! monitors
and !andles messages on a dead.letter queue.
2.3".2 Sintaxis
>>-runmqdlq--+-------------------------+-----------------------><
'- QName --+------------+-'
'- QMgrName -'
2.3".3 3escription
%se t!e dead.letter queue !andler to perform )arious actions on selected messages b$
specif$ing a set of rules t!at can bot! select a message and define t!e action to be performed on
t!at message.
8!e runmqdlq command ta+es its input from stdin. W!en t!e command is processed1 t!e
results and a summar$ are put into a report t!at is sent to stdout.
,$ ta+ing stdin from t!e +e$board1 $ou can enter runmqdlq rules interacti)el$.
,$ redirecting t!e input from a file1 $ou can appl$ a rules table to t!e specified queue. 8!e
rules table must contain at least one rule.
If $ou use t!e D2Q !andler #it!out redirecting stdin from a file "t!e rules table(1 t!e D2Q
!andler reads its input from t!e +e$board. In Webp!ere- MQ for AI'-1 olaris1 M6.%'1 and 2inu/1
t!e D2Q !andler does not start to process t!e named queue until it recei)es an endNofNfile "0trlTD(
c!aracter. In Webp!ere MQ for Windo#s1 it does not start to process t!e named queue until $ou
press t!e follo#ing sequence of +e$s: 0trlTP1 Enter1 0trlTP1 Enter.
7or more information about rules tables and !o# to construct t!em1 see 2a 8abla de reglas
del canali4ador D2Q.
2.3".4 Parmetros opcionales
8!e MQ0 command rules for comment lines and for 5oining lines also appl$ to t!e D2Q
!andler input parameters.
Parmetro Descripcin
#ame 8!e name of t!e queue to be processed.
If $ou omit t!e name1 t!e dead.letter queue defined for t!e local queue manager is used. If $ou
enter one or more blan+s "Y Y(1 t!e dead.letter queue of t!e local queue manager is e/plicitl$
assigned.
!gr#ame 8!e name of t!e queue manager t!at o#ns t!e queue to be processed.
If $ou omit t!e name1 t!e default queue manager for t!e installation is used. If $ou enter one or
more blan+s "Y Y(1 t!e default queue manager for t!is installation is e/plicitl$ assigned.
2.3# runmqdnm
Inicia el proceso de mensa5es en una cola usando el monitor .&E8 "slo Windo#s(.
2.3,.1 Propsito
&ote: 8!e runmqdnm command applies to Webp!ere- MQ for Windo#s onl$.
runmqdnm can be run from t!e command line1 or as a triggered application.
%se t!e runmqdnm control command to start processing messages on an application
queue #it! a .&E8 monitor.
2.3,.2 Sintaxis
>>-runmqdnm-- -q --QueueName-- -a --%ssem!lyName---------------->
>--+----------------+--+-----------------+---------------------->
'- -m --QMgrName-' '- -- --ClassName-'
>--+---------------------+--+-----------------+----------------->
'- -u --'serParameter-' '- -s --Syncpoint-'
>--+------------------+--+------------------+------------------->
'- -d --Conversion-' '- -n --MaxThrea$s-'
>--+---------------+--+------------------------+---------------->
'- -t --Timeout-' '- -b --3ac4outThreshol$-'
>--+-----------------+--+---------------------+----------------><
'- -r --QueueName-' '- -" --Context(ption-'
Parmetro Descripcin
-q QueueName 8!e name of t!e application queue to monitor.
-a AssemblyName 8!e name of t!e .&E8 assembl$.
2.3,.4 Parmetros opcionales
Parmetro Descripcin
-m QMgrName 8!e name of t!e queue manager t!at !osts t!e application queue.
If omitted1 t!e default queue manager is used.
-c 9lassName 8!e name of t!e .&E8 class t!at implements t!e IMQDb5ect8rigger interface. 8!is class
must reside in t!e specified assembl$.
If omitted1 t!e specified assembl$ is searc!ed to identif$ classes t!at implement t!e
IMQDb5ect8rigger interface:
If one class is found1 t!en 0lass&ame ta+es t!e name of t!is class.
If no classes or multiple classes are found1 t!en t!e .&E8 monitor is not started
and a message is #ritten to t!e console.
-u 8serData %ser.defined data. 8!is data is passed to t!e E/ecute met!od #!en t!e .&E8 monitor
calls it. %ser data must contain A0II c!aracters onl$1 #it! no double quotation mar+s1
&%22s1 or carriage returns
If omitted1 null is passed to t!e E/ecute met!od
-s Syncpoint pecifies #!et!er s$nc point control is required #!en messages are retrie)ed from t!e
application queue. 6ossible )alues are:
A:/ Messages are retrie)ed under s$nc point control
"MQLMDNC&06DI&8(.
#% Messages are not retrie)ed under s$nc point control
"MQLMDN&DNC&06DI&8(.
P:)/+/T:#T 6ersistent messages are retrie)ed under s$nc point control
"MQLMDNC&06DI&8NI7N6E?I8E&8(.
If omitted1 t!e )alue of $ncpoint is dependent on $our transactional model:
If distributed transaction coordination "D80( is being used1 t!en $ncpoint is
specified as CE.
If distributed transaction coordination "D80( is not being used1 t!en $ncpoint is
specified as 6E?I8E&8.
-d Conversion pecifies #!et!er data con)ersion is required #!en messages are retrie)ed from t!e
application queue. 6ossible )alues are:
A:/ Data con)ersion is required "MQLMDN0D&3E?8(.
#% Data con)ersion is not required "no get message option specified(.
If omitted1 0on)ersion is specified as &D.
-n !a&T(reads 8!e ma/imum number of acti)e #or+er t!reads.
If omitted1 Ma/8!reads is specified as H<.
-t Timeout 8!e time1 in seconds1 t!at t!e .&E8 monitor #aits for furt!er messages to arri)e on t!e
application queue. If $ou specif$ .=1 t!e .&E8 monitor #aits indefinitel$.
If omitted #!en run from t!e command line1 t!e .&E8 monitor #aits indefinitel$.
If omitted #!en run as a triggered application1 t!e .&E8 monitor #aits for =< seconds.
-b
Bac1outT(res(old
pecifies t!e bac+out t!res!old for messages retrie)ed from t!e application queue.
6ossible )alues are:
-1 8!e bac+out t!res!old is ta+en from t!e application queue attribute1
,D8M?EM.
C 8!e bac+out t!res!old is not set.
1 o ms E/plicitl$ sets t!e bac+out t!res!old.
If omitted1 ,ac+out8!res!old is specified as .=.
-r ueue#ame 8!e queue to #!ic! messages1 #it! a bac+out count e/ceeding t!e bac+out t!res!old1
are put.
If omitted1 t!e )alue of Queue&ame is dependent on t!e )alue of t!e ,DQ&AME attribute
from t!e application queue:
If ,DQ&AME is non.blan+1 t!en Queue&ame ta+es t!e )alue of ,DQ&AME.
If ,DQ&AME is blan+1 t!en Queue&ame is specified as t!e queue manager dead
letter queue. If a dead letter queue !as not been assigned to t!e queue
manager1 t!en bac+out processing is not a)ailable.
-p Conte&t%ption pecifies #!et!er conte/t information from a message t!at is being bac+ed out is passed
to t!e bac+ed out message. 6ossible )alues are:
#%#: &o conte/t information is passed.
D:#T+TA Identit$ conte/t information is passed onl$.
A99 All conte/t information is passed.
If omitted1 0onte/tDption is specified as A22.
Cd. )et. Descripcin
< Dperacin e/itosa
>= Error ine/perado
=EE %n+no#n ob5ect name error
2.4$ runmqlsr
E5ecuta un proceo listener para listen for remote requests on )arious communication
protocols.
2.4-.1 Propsito
%se t!e runmqlsr command to start a listener process.
8!is command is run s$nc!ronousl$ and #aits until t!e listener process !as finis!ed before
returning to t!e caller.
2.4-.2 Sintaxis
>>-runmqlsr-- -t ----------------------------------------------->
>--+- t-" --+------------+--+--------------+--+---------------+-+-->
| '- -" --Port-' '- -i --IP%$$r-' '- -b --3ac4log-' |
+- lu78 -- -n --TpName---------------------------------------+
| .---------------------. |
| V | |
+- netbi.s ----+-----------------+-+-------------------------+
| +- -a --%$apter---+ |
| +- -l --LocalName-+ |
| +- -e --Names-----+ |
| +- -s --Sessions--+ |
| '- -. --Comman$s--' |
| .-------------------. |
| V | |
'- s", ----+---------------+-+-------------------------------'
+- -, --Soc4et--+
'- -b --3ac4log-'
>--+----------------+------------------------------------------><
'- -m --QMgrName-'
2.4-.3 Parmetros necesarios
Parmetro Descripcin
-t 8!e transmission protocol to be used:
tcp 8ransmission 0ontrol 6rotocol : Internet 6rotocol "806:I6(
lu;H &A 2% ;.H "Windo#s onl$(
netbios &et,ID "Windo#s onl$(
sp/ 6' "Windo#s onl$(
Parmetro Descripcin
-p Port 8!e port number for 806:I6. 8!is flag is )alid for 806 onl$. If $ou omit t!e port number1 it is
ta+en from t!e queue manager configuration information1 or from defaults in t!e program.
8!e default )alue is =B=B. It must not e/ceed ;GGEG.
-i +PAddr
8!e I6 address for t!e listener1 specified in one of t!e follo#ing formats:
I6)B dotted decimal
I6); !e/adecimal notation
Alp!anumeric format
8!is flag is )alid for 806:I6 onl$.
Dn s$stems t!at are bot! I6)B and I6); capable $ou can split t!e traffic b$ running t#o
separate listeners. Dne listening on all I6)B addresses and one listening on all I6);
addresses. If $ou omit t!is parameter1 t!e listener listens on all configured I6)B and I6);
addresses.
-n Tp#ame 8!e 2% ;.H transaction program name. 8!is flag is )alid onl$ for t!e 2% ;.H transmission
protocol. If $ou omit t!e name1 it is ta+en from t!e queue manager configuration
information.
-a Adapter 8!e adapter number on #!ic! &et,ID listens. ,$ default t!e listener uses adapter <.
-l 9ocal#ame 8!e &et,ID local name t!at t!e listener uses. 8!e default is specified in t!e queue manager
configuration information.
-e #ames 8!e number of names t!at t!e listener can use. 8!e default )alue is specified in t!e queue
manager configuration information.
-s /essions 8!e number of sessions t!at t!e listener can use. 8!e default )alue is specified in t!e queue
manager configuration information.
-o Commands 8!e number of commands t!at t!e listener can use. 8!e default )alue is specified in t!e
queue manager configuration information.
-& /oc1et 8!e 6' soc+et on #!ic! 6' listens. 8!e default )alue is !e/adecimal GEA;.
-m !gr#ame 8!e name of t!e queue manager. ,$ default t!e command operates on t!e default queue
manager.
-b Bac1log 8!e number of concurrent connection requests t!at t!e listener supports. ee 8061 2%;H1
&E8,ID1 and 6' for a list of default )alues and furt!er information.
2.4-.5 Cdigos de retorno
Cd. )et. Descripcin
H< Ma ocurrido un error durante el proceso: t!e AMQM3?& process did not start.
2.4-.6 Ejemplos
8!e follo#ing command runs a listener on t!e default queue manager using t!e &et,ID
protocol. 8!e listener can use a ma/imum of fi)e names1 fi)e commands1 and fi)e sessions. 8!ese
resources must be #it!in t!e limits set in t!e queue manager configuration information.
runmqlsr -t netbi.s -e E -s E -. E
2.41 runmqsc
E5ecuta comandos Webp!ere- MQ en un administrador de cola.
2.41.1 Propsito
%se t!e runmqsc command to issue MQ0 commands to a queue manager. MQ0
commands enable $ou to perform administration tas+s1 for e/ample defining1 altering1 or deleting a
local queue ob5ect. MQ0 commands and t!eir s$nta/ are described in t!e Webp!ere MQ cript
"MQ0( 0ommand ?eference.
Cou must use t!e runmqsc command from t!e installation associated #it! t!e queue
2.41.2 Sintaxis
>>-runmqs---+------+--+------+---------------------------------->
'- -e -' '- -v -'
>--+----------------------------------------------------+------->
| .- -m -De"aultQMgrName-. |
'- -/ --1aitTime--+------+--+----------------------+-'
'- -, -' '- -m -LocalQMgrName---'
>--+----------+------------------------------------------------><
'-QMgrName-'
2.41.3 3escription
Cou can start t!e runmqsc command in t!ree #a$s:
2.41.3.1 VERIFY COMMAND
3erif$ MQ0 commands but do not run t!em. An output report is generated indicating t!e
success or failure of eac! command. 8!is mode is a)ailable on a local queue manager onl$.
2.41.3.2 RUN COMMAND DIRECTLY
end MQ0 commands directl$ to a local queue manager.
2.41.3.3 RUN COMMAND INDIRECTLY
?un MQ0 commands on a remote queue manager. 8!ese commands are put on t!e
command queue on a remote queue manager and run in t!e order in #!ic! t!e$ #ere queued.
?eports from t!e commands are returned to t!e local queue manager.
8!e runmqsc command ta+es its input from stdin. W!en t!e commands are processed1
t!e results and a summar$ are put into a report t!at is sent to stdout.
,$ ta+ing stdin from t!e +e$board1 $ou can enter MQ0 commands interacti)el$.
,$ redirecting t!e input from a file1 $ou can run a sequence of frequentl$ used commands
contained in t!e file. Cou can also redirect t!e output report to a file.
Parmetro Descripcin
-e 6re)ents source te/t for t!e MQ0 commands from being copied into a report. 8!is
parameter is useful #!en $ou enter commands interacti)el$.
-m
4ocalQMgrName
8!e local queue manager t!at $ou #ant to use to submit commands to t!e remote queue
manager. If $ou omit t!is parameter t!e local default queue manager is used to submit
commands to t!e remote queue manager.
-v 3erifies t!e specified commands #it!out performing t!e actions. 8!is mode is onl$
a)ailable locall$. 8!e .# and ./ flags are ignored if t!e$ are specified at t!e same time.
-* 2aitTime ?un t!e MQ0 commands on anot!er queue manager. Cou must !a)e t!e required c!annel
and transmission queues set up for t!is. ee 6reparing c!annels and transmission queues
for remote administration for more information.
2aitTime 8!e time1 in seconds1 t!at runmqsc #aits for replies. An$ replies recei)ed after t!is are
discarded1 but t!e MQ0 commands still run. pecif$ a time in t!e range = t!roug! FFF
FFF seconds.
Eac! command is sent as an Escape 607 to t!e command queue
"/A/T:!.AD!+#.C%!!A#D.D:D:( of t!e target queue manager.
8!e replies are recei)ed on queue /A/T:!.!/C.):P9A.D:D: and t!e outcome is
added to t!e report. 8!is can be defined as eit!er a local queue or a model queue.
Esta seal es ignorada si es especificada la seal -v.
-& 8!e target queue manager is running under 4:D-. 8!is flag applies onl$ in indirect mode.
8!e .# flag must also be specified. In indirect mode1 t!e MQ0 commands are #ritten in a
form suitable for t!e Webp!ere MQ for 4:D command queue.
!gr#ame 8!e name of t!e target queue manager on #!ic! to run t!e MQ0 commands1 b$ default1
t!e default queue manager.
Cd. )et. Descripcin
<< MQ0 command file processed successfull$
=< MQ0 command file processed #it! errorsR report contains reasons for failing
commands
H< ErrorR MQ0 command file not run
2.41.6 Ejemplos
Introducir este comando en la )entana de comandos:
runmqs-
A!ora puedes introducer comandos MQ0 directamente en la )entana de comandos. &o se
especifica ning@n administrador de cola1 as* que los comandos MQ0 son procesados en el
administrador de cola por defecto.
%se uno de estos comandos1 seg@n sea apropiado para su entorno1 para especificar que
que comando MQ0 )an a ser )erificados solamente:
runmqs- -v 9A*\ < P'u'users'-.mmfile.inP

runmqs- -v 9A*\ < P-@3users3-.mmfile.inP
Este comando )erifica los comandos MQ0 en el fic!ero commfile+in. El administrador de
cola es 1ANI. 2a salida es )isuali4ada en la )entana actual.
Estos comandos e5ecutan el fic!ero de comandos m*scfile+in nue)amente para el
administrador de cola por defecto.
runmqs- < P'var'mqm'mqs-'mqs-file.inP > P'var'mqm'mqs-'mqs-file..utP

runmqs- < P-@3%r.gram <iles3;9M3QebS"&ere MQ3mqs-3mqs-file.inP >
P-@3%r.gram <iles3;9M3QebS"&ere MQ3mqs-3mqs-file..utP
;n t&is e,am"le? t&e .ut"ut is dire-ted t. file mqs-file..ut.
Este comando propone comandos al administrador de cola QMR=M:T=1 usando QM4:9A4
para proponer los comandos.
runmqs- #/ FA #m QM4>5A4 QM2+M>+
2.42 runmqtmc
Inicia el monitor de disparador en un cliente.
2.42.1 Propsito
%se t!e runmqtmc command to start a trigger monitor for a client. 7or furt!er information
about using trigger monitors1 see 8rigger monitors.
W!en a trigger monitor starts1 it continuousl$ monitors t!e specified initiation queue. 8!e
trigger monitor does not stop until t!e queue manager ends1 see endmqm. W!ile t!e client trigger
monitor is running it +eeps t!e dead letter queue open.
2.42.2 Sintaxis
>>-runmqtm---+----------------+--+-----------------------+------>
'- -m --QMgr*ame-' '- -q --;nitiati.nQ*ame-'
>--+-----+-----------------------------------------------------><
'- -r '
Parmetro Descripcin
-m !gr#ame 8!e name of t!e queue manager on #!ic! t!e client trigger monitor operates1 b$ default
t!e default queue manager.
-q
+nitiation#ame
8!e name of t!e initiation queue to be processed1 b$ default
SOS+M.$+<A64.;*;;A;>*.Q6+6+.
-r pecifies t!at t!e client trigger monitor automaticall$ reconnects.
Cd. )et. Descripcin
< &ot used. 8!e client trigger monitor is designed to run continuousl$ and t!erefore not to
end. 8!e )alue is reser)ed.
=< 0lient trigger monitor interrupted b$ an error.
H< ErrorR client trigger monitor not run.
2.42.5 Ejemplos
7or e/amples of using t!is command1 see 8!e 8riggering sample programs.
2.43 runmqtrm
tart t!e trigger monitor on a ser)er.
2.43.1 Propsito
%se t!e runmqtrm command to start a trigger monitor. 7or furt!er information about using
trigger monitors1 see 8rigger monitors.
W!en a trigger monitor starts1 it continuousl$ monitors t!e specified initiation queue. 8!e
trigger monitor does not stop until t!e queue manager ends1 see endmqm. W!ile t!e trigger monitor
is running it +eeps t!e dead letter queue open.
2.43.2 Sintaxis
>>-runmqtrm--+----------------+--+-----------------------+-----><
'- -m --QMgrName-' '- -q --InitiationQName-'
Parmetro Descripcin
-m !gr#ame 8!e name of t!e queue manager on #!ic! t!e trigger monitor operates1 b$ default t!e
default queue manager.
-q +nitiation#ame pecifies t!e name of t!e initiation queue to be processed1 b$ default
SOS+M.$+<A64.;*;;A;>*.Q6+6+.
Cd. )et. Descripcin
< &ot used. 8!e trigger monitor is designed to run continuousl$ and t!erefore not to
end. Mence a )alue of < #ould not be seen. 8!e )alue is reser)ed.
=< 8rigger monitor interrupted b$ an error.
H< ErrorR trigger monitor not run.
2.44 runs3chl
runs#c!l "s#itc! cluster c!annel( on %&I'1 2inu/1 and Windo#s.
2.44.1 Propsito
8!e command s#itc!es or queries t!e cluster transmission queues associated #it! cluster.
sender c!annels.
2.44.2 otas de !so
Cou must log on as an Administrator to run t!is command.
8!e command s#itc!es all t!e stopped or inacti)e cluster.sender c!annels t!at matc! t!e
.c parameter1 require s#itc!ing1 and can be s#itc!ed. 8!e command reports bac+ on t!e c!annels
t!at are s#itc!ed1 t!e c!annels t!at do not require s#itc!ing1 and t!e c!annels it cannot s#itc!
because t!e$ are not stopped or inacti)e.
If $ou set t!e .q parameter1 t!e command does not perform t!e s#itc!1 but it pro)ides t!e
list of c!annels t!at #ould be s#itc!ed.
2.44.3 Sintaxis
>>-runs/-&l-- -m-- -QmgrName--+- ---- -5------------------+--+-----+-><
+- ---- -enericChannelName-+ +- -q-+
'- ---- -ChannelName--------' '- -n-'
Parmetro Descripcin
-m QmgrName 8!e queue manager to run t!e command against. 8!e queue manager must be
started.
-c - All t!e cluster.sender c!annels
-c
5eneric9-annelNam
e
All matc!ing cluster.sender c!annels
-c C(annel#ame ingle cluster.sender c!annel.
Cod. )et Descripcin
< 8!e command completed successfull$
=< 8!e command completed #it! #arnings.
H< 8!e command completed #it! errors.
2.44.7 Ejemplos
8o displa$ t!e configuration state of cluster.sender c!annel 8D.QMH:
26*SQ5(4 -m QM= -- >.QM8 -q
8o s#itc! t!e transmission queue for cluster.sender c!annel 8D.QME #it!out mo)ing t!e
messages on it:
26*SQ5(4 -m QM= -- >.QMF -n
8o s#itc! t!e transmission queue for cluster.sender c!annel 8D.QME and mo)e t!e
messages on it:
26*SQ5(4 -m QM= -- >.QMF
8o displa$ t!e configuration state of all cluster.sender c!annels on QM=:
26*SQ5(4 -m QM= -- 0 -q
8o displa$ t!e configuration state of all cluster.sender c!annels #it! a generic name of
8D.J:
26*SQ5(4 -m QM= -- >.0 -q
2.44." (areas relacionadas)
0lustering: #itc!ing cluster transmission queues
2.45 setmqaut
0!ange t!e aut!ori4ations to a profile1 ob5ect1 or class of ob5ects. Aut!ori4ations can be
granted to1 or re)o+ed from1 an$ number of principals or groups.
-q Displa$ t!e state of one or more c!annels. If $ou omit t!is parameter1 t!e commands
s#itc!es an$ stopped or inacti)e c!annels t!at require s#itc!ing.
-n W!en s#itc!ing transmission queues1 do not transfer messages from t!e old queue to
t!e ne# transmission queue.
&ote: 8a+e care #it! t!e .n option: messages on t!e old transmission queue are not
transferred unless $ou associate t!e transmission queue #it! anot!er cluster.sender
c!annel.
7or more information about aut!ori4ation ser)ice components1 see Installable ser)ices1
er)ice components1 and Aut!ori4ation ser)ice interface.
7or more information about !o# aut!ori4ations #or+1 see Mo# aut!ori4ations #or+.
2.45.1 Sintaxis
>>-setmqaut--+----------------+-- -n --Pro"ile------------------>
'- -m --QMgrName-'
>-- -t --(!)ectType--+------------------------+----------------->
'- -s --ServiceComponent-'
.-------------------------.
V |
>----+- -" --PrincipalName-+-+---------------------------------->
'- -g --roupName-----'
.---------------------------------------.
V |
>----+-| MQ; aut&.rizati.ns |------------+-+-------------------><
+-| 5.nte,t aut&.rizati.ns |--------+
+-| Administrati.n aut&.rizati.ns |-+
+-| Jeneri- aut&.rizati.ns |--------+
+- +rem.ve -------------------------+
'- -rem.ve -------------------------'
2.45.1.1 MI AUTHORIZATIONS
.--------------------.
V |
|------+- +altusr --+---+---------------------------------------|
+- -altusr --+
+- +br./se --+
+- -br./se --+
+- +-.nne-t -+
+- --.nne-t -+
+- +get -----+
+- -get -----+
+- +inq -----+
+- -inq -----+
+- +"ub -----+
+- -"ub -----+
+- +"ut -----+
+- -"ut -----+
+- +resume --+
+- -resume---+
+- +set -----+
+- -set -----+
+- +sub -----+
'- -sub -----'
2.45.1.2 CONTE!T AUTHORIZATIONS
.--------------------.
V |
|------+- +"assall -+---+---------------------------------------|
+- -"assall -+
+- +"assid --+
+- -"assid --+
+- +setall --+
+- -setall --+
+- +setid ---+
'- -setid ---'
2.45.1.3 ADMINISTRATION AUTHORIZATIONS
.------------------.
V |
|------+- +-&g ---+---+-----------------------------------------|
+- --&g ---+
+- +-lr ---+
+- --lr ---+
+- +-rt ---+
+- --rt ---+
+- +dlt ---+
+- -dlt ---+
+- +ds" ---+
+- -ds" ---+
+- +-trl --+
+- --trl --+
+- +-trl, -+
'- --trl, -'
2.45.1.4 GENERIC AUTHORIZATIONS
.-------------------.
V |
|------+- +all ----+---+----------------------------------------|
+- -all ----+
+- +alladm -+
+- -alladm -+
+- +allmqi -+
+- -allmqi -+
+- +n.ne ---+
+- +s!stem -+
'- -s!stem -'
2.45.2 3escription
%se setmqaut bot! to grant an aut!ori4ation1 t!at is1 gi)e a principal or user group
permission to perform an operation1 and to revo7e an aut!ori4ation1 t!at is1 remo)e t!e permission
to perform an operation. Cou can specif$ a number of parameters:
Queue manager name
6rincipals and user groups
Db5ect t$pe
6rofile name
er)ice component
8!e aut!ori4ations t!at can be gi)en are categori4ed as follo#s:
Aut!ori4ations for issuing MQI calls
Aut!ori4ations for MQI conte/t
Aut!ori4ations for issuing commands for administration tas+s
Leneric aut!ori4ations
Eac! aut!ori4ation to be c!anged is specified in an aut!ori4ation list as part of t!e
command. Eac! item in t!e list is a string prefi/ed b$ a plus sign "T( or a minus sign ".(. 7or
e/ample1 if $ou include Tput in t!e aut!ori4ation list1 $ou grant aut!orit$ to issue MQ6%8 calls
against a queue. Alternati)el$1 if $ou include .put in t!e aut!ori4ation list1 $ou re)o+e t!e
aut!orit$ to issue MQ6%8 calls.
Cou can specif$ an$ number of principals1 user groups1 and aut!ori4ations in a single
command1 but $ou must specif$ at least one principal or user group.
If a principal is a member of more t!an one user group1 t!e principal effecti)el$ !as t!e
combined aut!orities of all t!ose user groups. Dn Windo#s s$stems1 t!e principal also !as all t!e
aut!orities t!at !a)e been granted to it e/plicitl$ using t!e setmqaut command.
Dn %&I' s$stems1 all aut!orities are !eld b$ user groups internall$1 not b$ principals.
Lranting aut!orities to groups !as t!e follo#ing implications:
If $ou use t!e setmqaut command to grant an aut!orit$ to a principal1 t!e aut!orit$ is
granted to t!e primar$ user group of t!e principal. 8!is means t!at t!e aut!orit$ is
effecti)el$ granted to all members of t!at user group.
If $ou use t!e setmqaut command to re)o+e an aut!orit$ from a principal1 t!e
aut!orit$ is re)o+ed from t!e primar$ user group of t!e principal. 8!is means t!at t!e
aut!orit$ is effecti)el$ re)o+ed from all members of t!at user group.
8o alter aut!ori4ations for a cluster sender c!annel t!at !as been automaticall$ generated
b$ a repositor$1 see 0!annel definition commands.
Parmetro Descripcin
-t :b;ectType El tipo de ob5eto para el que cambiar autori4aciones. 2os )alores posibles son los
siguientes:
aut(info %n ob5eto informacin de autenticacin
c(annel o c(l %n canal
clntconn o clcn %n canal cone/in cliente
comminfo %n ob5eto informacin de comunicacin
listener o lstr %n listener
namelist o nl %na lista.de.nombre
queue o q %na cola
rqmname o rqmn %n nombre de administrador de cola remoto
service o srvc %n ser)icio
topic o top %n tema
-n Profile 8!e name of t!e profile for #!ic! to c!ange aut!ori4ations. 8!e aut!ori4ations appl$ to all
Webp!ere MQ ob5ects #it! names t!at matc! t!e profile name specified. 8!e profile name
can be generic1 using #ildcard c!aracters to specif$ a range of names as e/plained in %sing
DAM generic profiles on %&I' or 2inu/ s$stems and Windo#s.
8!is parameter is required1 unless $ou are c!anging t!e aut!ori4ations of a queue
manager1 in #!ic! case $ou must not include it. 8o c!ange t!e aut!ori4ations of a queue
manager use t!e queue manager name1 for e/ample
setmqaut -m QMJ2 -t qmgr -" user= +-.nne-t
#!ere QML? is t!e name of t!e queue manager and user= is t!e user requesting t!e
c!ange.
Eac! class of ob5ect !as aut!orit$ records for eac! group or principal. 8!ese records !a)e
t!e profile name Z02A and trac+ t!e crt "create( aut!orit$ common to all ob5ects of t!at
class. If t!e crt aut!orit$ for an$ ob5ect of t!at class is c!anged t!en t!is record is
updated. 7or e/ample:
"r.file@ R-lass
.bSe-t t!"e@ queue
entit!@ test
entit! t!"e@ "rin-i"al
aut&.rit!@ -rt
8!is s!o#s t!at members of t!e group test !a)e crt aut!orit$ to t!e class queue.
Parmetro Descripcin
-m !gr#ame 8!e name of t!e queue manager of t!e ob5ect for #!ic! to c!ange aut!ori4ations. 8!e
name can contain up to BA c!aracters.
8!is parameter is optional if $ou are c!anging t!e aut!ori4ations of $our default queue
manager.
-p Principal#ame 8!e name of t!e principal for #!ic! to c!ange aut!ori4ations.
7or Webp!ere MQ for Windo#s onl$1 t!e name of t!e principal can optionall$ include a
domain name1 specified in t!e follo#ing format:
useridRd.main
7or more information about including domain names on t!e name of a principal1 see
6rincipals and groups.
Cou must !a)e at least one principal or group.
-g <roup#ame 8!e name of t!e user group for #!ic! to c!ange aut!ori4ations. Cou can specif$ more
t!an one group name1 but eac! name must be prefi/ed b$ t!e .g flag.
7or Webp!ere MQ for Windo#s onl$1 t!e Lroup&ame can optionall$ include a domain
name1 specified in t!e follo#ing formats:
Jr.u"*ameRd.main
d.main3Jr.u"*ame
-s
/erviceComponent
8!e name of t!e aut!ori4ation ser)ice to #!ic! t!e aut!ori4ations appl$ "if $our s$stem
supports installable aut!ori4ation ser)ices(. 8!is parameter is optionalR if $ou omit it1 t!e
aut!ori4ation update is made to t!e first installable component for t!e ser)ice.
Eremove o
-remove
?emo)e all t!e aut!orities from Webp!ere MQ ob5ects t!at matc! t!e specified profile.
8!is option cannot be used #it! t!e option .t qmgr.
Aut(ori4ations 8!e aut!ori4ations to be granted or re)o+ed. Eac! item in t!e list is prefi/ed b$ a plus
sign "T( or a minus sign ".(. 8!e plus sign indicates t!at aut!orit$ is to be granted. 8!e
minus sign indicates t!at aut!orit$ is to be re)o+ed.
7or e/ample1 to grant aut!orit$ to issue MQ6%8 calls1 specif$ Tput in t!e list. 8o re)o+e
t!e aut!orit$ to issue MQ6%8 calls1 specif$ .put.
2a siguiente tala muestra las autoridades que pueden ser dadas a los diferentes tipos de
ob5etos.
Table 3+ Autori!a!es =specificas para !iferentes tipos !e ob;etos.
Autorid
ad
Col
a
Pro
c.
Adm.
Cola
#om.
Adm.
Cola
)emota
9ista-
#ombre
Tema
Auten.
info
Clntconn Canal 9istener /ervicio Comminfo
all
=
Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces Ces
alladm
H
Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces Ces
allmqi
E
Ces Ces Ces Ces Ces Ces Ces &o &o &o &o &o
none Ces Ces Ces Ces Ces &o Ces Ces Ces Ces Ces Ces
altusr &o &o Ces &o &o &o &o &o &o &o &o &o
bro#se Ces &o &o &o &o &o &o &o &o &o &o &o
c!g Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces Ces
clr Ces &o &o &o &o Ces &o &o &o &o &o &o
connec
t
&o &o Ces &o &o &o &o &o &o &o &o &o
crt Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces Ces
ctrl &o &o &o &o &o Ces &o &o Ces Ces Ces &o
ctrl/ &o &o &o &o &o &o &o &o Ces &o &o &o
dlt Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces Ces
dsp Ces Ces Ces &o Ces Ces Ces Ces Ces Ces Ces Ces
get Ces &o &o &o &o &o &o &o &o &o &o &o
pub &o &o &o &o &o Ces &o &o &o &o &o &o
put Ces &o &o Ces &o &o &o &o &o &o &o &o
inq Ces Ces Ces &o Ces &o Ces &o &o &o &o &o
passall Ces &o &o &o &o &o &o &o &o &o &o &o
passid Ces &o &o &o &o &o &o &o &o &o &o &o
resume &o &o &o &o &o Ces &o &o &o &o &o &o
set Ces Ces Ces &o &o &o &o &o &o &o &o &o
setall Ces &o Ces &o &o &o &o &o &o &o &o &o
setid Ces &o Ces &o &o &o &o &o &o &o &o &o
sub &o &o &o &o &o Ces &o &o &o &o &o &o
s$stem &o &o Ces &o &o &o &o &o &o &o &o &o
Note5
all aut*ority is equivalent to t*e union o+ t*e aut*orities alladm, allmqi, and system appropriate to t*e ob,ect type-
alladm aut*ority is equivalent to t*e union o+ t*e individual aut*orities c*g, clr, dlt, dsp, ctrl, and ctrl6 appropriate to t*e
ob,ect type- crt aut*ority is not included in t*e subset alladm-
allmqi aut*ority is equivalent to t*e union o+ t*e individual aut*orities altusr, bro/se, connect, get, inq, pub, put, resume,
set, and sub appropriate to t*e ob,ect type-
Cd. )et. :&planation
< Dperacin e/itosa
>= Error ine/perado
=EE %n+no#n ob5ect name
=BG %ne/pected ob5ect name
=B; Db5ect name missing
=B> Db5ect t$pe missing
=BA In)alid ob5ect t$pe
=BF Entit$ name missing
=G< Aut!ori4ation specification missing
=G= In)alid aut!ori4ation specification
2.45.6 Ejemplos
8!is e/ample s!o#s a command t!at specifies t!at t!e ob5ect on #!ic! aut!ori4ations are
being gi)en is t!e queue orange.queue on queue manager saturn.queue.manager.
setmqaut -m saturn.queue.manager -n .range.queue -t queue
-g tang. +inq +alladm
8!e aut!ori4ations are gi)en to a user group called tango1 and t!e associated aut!ori4ation
list specifies t!at t!e user group can:
Issue MQI&Q calls
6erform all administration operations on t!at ob5ect
In t!is e/ample1 t!e aut!ori4ation list specifies t!at a user group called fo/$:
0annot issue an$ MQI calls to t!e specified queue
0an perform all administration operations on t!e specified queue
setmqaut -m saturn.queue.manager -n .range.queue -t queue
-g f.,! -allmqi +alladm
8!is e/ample gi)es user= full access to all queues #it! names beginning a.b. on queue
manager qmgr=. 8!e profile is persistent and applies to an$ ob5ect #it! a name t!at matc!es t!e
profile.
setmqaut -m qmgr= -n a.b.0 -t q -" user= +all
8!is e/ample deletes t!e specified profile.
setmqaut -m qmgr= -n a.b.0 -t q -" user= -rem.ve
8!is e/ample creates a profile #it! no aut!orit$.
setmqaut -m qmgr= -n a.b.0 -t q -" user= +n.ne
2.45.7 /'tori0aciones
Para llamadas !+
altusr %se anot!er user[s aut!orit$ for t!e queue manager.
bro#se ?etrie)e a message from a queue using an MQLE8 call #it! t!e ,?DWE option.
connect 0onnect t!e application to t!e specified queue manager using an MQ0D&& call.
get ?etrie)e a message from a queue using an MQLE8 call.
inq Ma+e an inquir$ on a specific queue using an MQI&Q call.
pub 6ublis! a message on a topic using t!e MQ6%8 call.
put 6ut a message on a specific queue using an MQ6%8 call.
resume ?esume a subscription using t!e MQ%, call.
set et attributes on a queue from t!e MQI using an MQE8 call.
sub 0reate1 alter or resume a subscription to a topic using t!e MQ%, call.
&ote: If $ou open a queue for multiple options1 $ou must be aut!ori4ed for eac! option.
Para conte&to
passall 6ass all conte/t on t!e specified queue. All t!e conte/t fields are copied from t!e
original request.
passid 6ass identit$ conte/t on t!e specified queue. 8!e identit$ conte/t is t!e same as t!at
of t!e request.
setall et all conte/t on t!e specified queue. 8!is is used b$ special s$stem utilities.
setid et identit$ conte/t on t!e specified queue. 8!is is used b$ special s$stem utilities.
Note' To use setid or setall aut*ority aut*orizations must be granted on bot* t*e
appropriate queue ob,ect and also on t*e queue manager ob,ect-
2.45." /'t4ori0ations +or commands
c!g 0!ange t!e attributes of t!e specified ob5ect.
clr 0lear t!e specified queue or a topic.
crt 0reate ob5ects of t!e specified t$pe.
dlt Delete t!e specified ob5ect.
dsp Displa$ t!e attributes of t!e specified ob5ect.
ctrl 7or listeners and ser)ices1 start and stop t!e specified c!annel1 listener1 or ser)ice.
7or c!annels1 start1 stop1 and ping t!e specified c!annel.
7or topics1 define1 alter1 or delete subscriptions.
ctrl/ ?eset or resol)e t!e specified c!annel.
2.45., /'t4ori0ations +or generic operations
all
%se all operations applicable to t!e ob5ect. all aut!orit$ is equi)alent to t!e union of t!e
aut!orities alladm1 allmqi1 and s$stem appropriate to t!e ob5ect t$pe.
alladm %se all administration operations applicable to t!e ob5ect.
allmqi %se all MQI calls applicable to t!e ob5ect.
none &o aut!orit$. %se t!is aut!ori4ation to create profiles #it!out aut!orit$. W!en an aut!orit$
is gi)en to an ob5ect or group t!at #as pre)iousl$ s!o#ing QnoneQ1 t!en t!e aut!ori4ation
c!anges to t!e aut!orit$ 5ust applied. Mo#e)er1 #!en t!e QnoneQ aut!ori4ation is added to
an ob5ect or group #it! an e/isting alternati)e aut!orit$1 t!e aut!orit$ does not c!ange.
s$stem %se queue manager for internal s$stem operations.
2.4 setmqcrl
Administrar las definiciones 2DA6 de la 0?2 "lista de re)ocacin de certificados( en un
Acti)e Director$ "slo en Windo#s(.
2.46.1 .inalidad
Nota' 0l mandato setmqcrl se aplica a .ebSp*ere MQ para .indo/s Enicamente-
%tilice el mandato setmqcrl para configurar $ administrar el soporte para publicar
definiciones 2DA6 de 0?2 "lista de re)ocacin de certificados( en un Acti)e Director$.
%n administrador del dominio debe utili4ar inicialmente este mandato1 o setmqscp1 para
preparar Acti)e Director$ para que utilice Webp!ere MQ $ para otorgar a los usuarios $
administradores de Webp!ere MQ las autori4aciones pertinentes para acceder $ actuali4ar los
ob5etos Acti)e Director$ de Webp!ere MQ. 8ambin puede utili4ar el mandato setmqcrl para
)isuali4ar todas las definiciones de ser)idor de 0?2 configuradas actualmente que estn disponibles
en Acti)e Director$1 es decir1 aquellas definiciones a las que !ace referencia la 2ista de nombres 0?2
del gestor de colas.
2os @nicos tipos de ser)idores de 0?2 soportados son los ser)idores 2DA6.
2.46.2 Sintaxis
>>-setmq-rl--+-----------------------------------+-------------->
'- -a --+-------------------------+-'
'- -m --Nom!reestorColas-'
>--+-----------------------------------+--+------+-------------><
'- -r --+-------------------------+-' '- -d -'
'- -m --Nom!reestorColas-'
Debe especificar uno de estos tres: -a "aadir(1 -r "eliminar( o -d ")isuali4ar(.
Parmetro Descripcin
-a Aade el contenedor Acti)e Director$ de cone/iones de cliente MQI de Webp!ere MQ1 si toda)*a
no e/iste. Debe ser un usuario con los pri)ilegios adecuados para crear subcontenedores en el
contenedor Sistema del dominio. 2a carpeta de Webp!ere MQ se llama 0&VI,M.
MQ0lient0onnections. &o suprima esta carpeta de ning@n otro modo que no sea mediante el
mandato setmqscp.
-d 3isuali4a las definiciones de ser)idor de 0?2 de Webp!ere MQ.
-r Elimina las definiciones de ser)idor de 0?2 de Webp!ere MQ.
-m 6 - , qmgr 8
Modifica el par9metro especificado "-a o -r( de modo que slo resulte afectado el gestor de colas
especificado. Debe incluir esta opcin con el par9metro -a.
- , qmgr
- especifica que todos los gestores de colas se )en afectados. Esto le permite migrar un arc!i)o
de definiciones de ser)idor de 0?2 de Webp!ere MQ espec*fico desde un solo gestor de colas.
2.46.4 Ejemplos
El mandato siguiente crea la carpeta I,M.MQ0lient0onnections $ asigna los permisos
necesarios a los administradores de Webp!ere MQ para la carpeta $ para los ob5etos !i5o que se
creen posteriormente. En este caso1 es funcionalmente equi)alente a setmqscp .a.
setmq-rl -a
El mandato siguiente migra las definiciones de ser)idor de 0?2 e/istentes de un gestor de
colas local1 Paint+*ueue+manager1 a Acti)e Director$1 para lo que antes suprime cualquier
otra definicin de C)9 de Active Director':
setmq-rl -a -m %aint.queue.manager
2.4! setmqenv
A5usta el entorno de Webp!ere- MQ1 en %&I'1 2inu/1 $ Windo#s.
2.47.1 Propsito
6uedes usar el script setmqenv para a5ustar autom9ticamente el entono para uso con una
instalacin de Webp!ere MQ. Alternati)amente1 puedes usar el commando crtmqen) para definer
una lista de )ariables de entorno $ )alores para a5ustar manualmente cada )ariable de entorno de tu
sistema.
Cou can specif$ #!ic! installation t!e en)ironment is set up for b$ specif$ing a queue
manager name1 an installation name1 or an installation pat!. Cou can also set up t!e en)ironment
for t!e installation t!at issues t!e setmqen) command b$ issuing t!e command #it! t!e .s
parameter.
8!is command sets t!e follo#ing en)ironment )ariables1 appropriate to $our s$stem:
02A6A8M
I&02%DE
2I,
MA&6A8M
MQNDA8AN6A8M
MQNE&3NMDDE
MQN7I2EN6A8M
MQNOA3ANI&8A22N6A8M
MQNOA3ANDA8AN6A8M
MQNOA3AN2I,N6A8M
MQNOA3ANO3MN72AL
MQNO?EN6A8M
6A8M
Dn %&I' and 2inu/ s$stems1 if t!e .l or .+ flag is specified1 t!e !"P#T$ en)ironment
)ariable is set on AI'-1 and t!e %&!"'#'(&P#T$ en)ironment )ariable is set on M6.%'1 2inu/1
and olaris.
2.47.2 otas de !so
8!e setmqen) command remo)es all directories for all Webp!ere MQ installations
from t!e en)ironment )ariables before adding ne# references to t!e installation $ou
are setting up t!e en)ironment for. 8!erefore1 if $ou #ant to set an$ additional
en)ironment )ariables t!at reference Webp!ere MQ1 set t!e )ariables after issuing t!e
setmqen) command. 7or e/ample1 if $ou #ant to add
MQ&!NST##T!)N&P#T$:5a)a:lib to %&!"'#'(&P#T$1 $ou must do so after running
setmqen).
In some s!ells1 command.line parameters cannot be used #it! setmqen) and an$
setmqen) command issued is assumed to be a setmqen) .s command. 8!e command
produces an informational message t!at t!e command !as been e/ecuted as if a
setmqen) .s command !ad been issued. 8!erefore1 in t!ese s!ells $ou must ensure
t!at $ou issue t!e command from t!e installation $ou #ant to set t!e en)ironment for.
In t!ese s!ells1 $ou must set t!e %&!"'#'(&P#T$ )ariable manuall$. %se t!e
crtmqen) command #it! t!e .l or .+ parameter to list t!e %&!"'#'(&P#T$ )ariable
and )alue. 8!en use t!is )alue to set t!e %&!"'#'(&P#T$.
2.47.3 Sintaxis
>>-setmqenv--+- -m -QMgrName---------+--+-----+--+-----------+-><
+- -n -InstallationName-+ +- -: + '- -, -Mo$e-'
+- -" -InstallationPath-+ '- -l '
+- -r ------------------+
'- -s ------------------'
Parmetro Descripcin
-m QMgrName et up t!e en)ironment for t!e installation associated #it! t!e queue manager
QMgrName.
-n .nstallationName et up t!e en)ironment for t!e installation named !nstallationName.
-p .nstallationPat- et up t!e en)ironment for t!e installation in t!e pat! !nstallationPat*.
-r ?emo)e all installations from t!e en)ironment.
-s et up t!e en)ironment for t!e installation t!at issued t!e setmqen) command.
-1 %&I' and 2inu/ onl$.
Include t!e %&!"'#'(&P#T$1 or !"P#T$1 en)ironment )ariable in t!e en)ironment1
adding t!e pat! to t!e Webp!ere MQ libraries at t!e start of t!e current
%&!"'#'(&P#T$1 or !"P#T$1 )ariable.
-l %&I' and 2inu/ onl$.
Include t!e %&!"'#'(&P#T$1 or !"P#T$1 en)ironment )ariable in t!e en)ironment1
adding t!e pat! to t!e Webp!ere MQ libraries at t!e end of t!e current
%&!"'#'(&P#T$1 or !"P#T$1 )ariable.
-& Mo!e Mode can ta+e t!e )alue EH1 or ;B.
0reate a EH.bit or ;B.bit en)ironment. If t!is parameter is not specified1 t!e
en)ironment matc!es t!at of t!e queue manager or installation specified in t!e
command.
An$ attempt to displa$ a ;B.bit en)ironment #it! a EH.bit installation fails.
Cd. )et. Descripcin
2.47.6 Ejemplos
8!e follo#ing e/amples assume t!at a cop$ of Webp!ere MQ is installed in /opt/m*m on
a %&I' or 2inu/ s$stem.
&ote: 8!e . c!aracter used at t!e beginning of eac! command ma+es t!e setmqen) script
run in t!e current s!ell. 8!erefore1 t!e en)ironment c!anges made b$ t!e setmqen) script are
applied to t!e current s!ell. Wit!out t!e . c!aracter1 t!e en)ironment )ariables are c!anged in
anot!er s!ell1 and t!e c!anges are not applied to t!e s!ell from #!ic! t!e command is issued.
8!is command sets up t!e en)ironment for an installation installed in :opt:mqm:
. '."t'mqm'bin'setmqenv -s
8!is command sets up t!e en)ironment for an installation installed in :opt:mqmH1 and
includes t!e pat! to t!e installation at t!e end of t!e current )alue of t!e %&!"'#'(&P#T$
)ariable:
. '."t'mqm'bin'setmqenv -" '."t'mqm8 -l
8!is command sets up t!e en)ironment for t!e queue manager QM=1 in a EH.bit
en)ironment:
. '."t'mqm'bin'setmqenv -m QM= -, F8
8!e follo#ing e/ample assumes t!at a cop$ of Webp!ere MQ is installed in 0:S6rogram
7ilesSI,MSWebp!ere MQ on a Windo#s s$stem.
8!is command sets up t!e en)ironment for an installation called Installation=:
P5@3%r.gram <iles3;9M3QebS"&ere MQ3bin3setmqenv.-mdP -n ;nstallati.n=
2.47.7 *e+erencia relacionada)
crtmqen)
2.47." &n+ormacin relacionada
Multiple installations
2.4" setmqinst
et Webp!ere- MQ installations1 on %&I'1 2inu/1 and Windo#s.
2.4".1 Propsito
Cou can use t!e setmqinst command to c!ange t!e installation description of an
installation1 or to set or unset an installation as t!e primar$ installation. 8o c!ange t!e primar$
installation1 $ou must unset t!e current primar$ installation before $ou can set a ne# primar$
installation. 8!is command updates information contained in t!e mqinst.ini file.
After unsetting t!e primar$ installation1 t!e setmqinst command #ill not be a)ailable unless
$ou specif$ t!e full pat! or !a)e an appropriate installation director$ on $our 6A8M "or equi)alent(.
8!e default pat! in a s$stem standard location #ill !a)e been deleted.
7ile mqinst.ini contains information about all Webp!ere MQ installations on a s$stem. 7or
more information about mqinst.ini1 see Installation configuration file1 mqinst.ini.
Dn %&I' or 2inu/ s$stems1 $ou must run t!is command as root. Dn Windo#s s$stems1 $ou
must run t!is command as a member of t!e Administrators group. 8!e command does not !a)e to
be run from t!e installation $ou are modif$ing.
2.4".2 Sintaxis
>>-setmqinst--| A-ti.n |--| ;nstallati.n |---------------------><
2.4".2.1 ACTION
|--+- -i------------------+-------------------------------------|
+- -,------------------+
'- -d--DescriptiveText-'
2.4".2.2 INSTALLATION
|--+- -" -InstallationPath----------------------------+---------|
| H=I |
+- -" -InstallationPath-- -n--InstallationName-----+
| H=I |
Notas' 2-en specifie! toget-er( t-e installation name an! installation pat- must
refer to t-e same installation+
2.4".3 Parmetros
Parmetro Descripcin
-d Descripti"eText 8e/t t!at describes t!e installation.
8!e te/t can be up to ;B single.b$te c!aracters1 or EH double.b$te c!aracters. 8!e
default )alue is all blan+s. Cou must use double quotation mar+s around t!e te/t if it
contains spaces.
-i et t!is installation as t!e primar$ installation.
-& %nset t!is installation as t!e primar$ installation.
-n .nstallationName 8!e name of t!e installation to modif$.
-p .nstallationPat- 8!e pat! of t!e installation to modif$. Cou must use double quotation mar+s around t!e
pat! if it contains spaces
Cd. )et. Descripcin
< Entr$ set #it!out error
E> El te/to descripti)o est9 en error
Cd. )et. Descripcin
>= Error ine/perado
AF Error en fic!ero I&I
F; &o puede bloquear fic!ero I&I
FA Autoridad insuficiente para acceder a fic!ero I&I
=E= ?esource problem
2.4".5 Ejemplos
8!is command sets t!e installation #it! t!e name of m$Installation as t!e primar$
installation:
setmqinst -i -n m!;nstallati.n
8!is command sets t!e installation #it! an installation pat! of :opt:m$Installation as t!e
primar$ installation:
setmqinst -i -" '."t'm!;nstallati.n
8!is command unsets t!e installation named m$Installation as t!e primar$ installation:
setmqinst -, -n m!;nstallati.n
8!is command unsets t!e installation #it! an installation pat! of :opt:m$Installation as t!e
primar$ installation:
setmqinst -, -" '."t'm!;nstallati.n
8!is command sets t!e descripti)e te/t for t!e installation named m$Installation:
setmqinst -d PM! installati.nP -n m!;nstallati.n
8!e descripti)e te/t is enclosed in quotation mar+s as it contains spaces.
2.4".6 *elated concepts)
2.4".7 (areas relacionadas)
0!anging t!e primar$ installation
2.4# setmqm
elecciona la instalacin asociada de un administrador de cola.
2.4,.1 Propsito
%se el comando setmqm para seleccionar la instalacin asociada de Webp!ere- MQ de
un administrador de cola. El administrador de cola puede posteriormente ser administrado usando
solo los commandos de la instalacin asocidada. 6or e5emplo1 cuando un administrador de cola es
iniciado con strmqm1 debe ser el comando strmqm de la instalacin que !a sido especificado por el
comando setmqm.
6ara m9s informacin sobre uso de este comando1 include informacin sobre su uso1
consultar Associating a queue manager #it! an installation.
Este comando solo es applicable a %&I'1 2inu/ $ Windo#s.
2.4,.2 otas de !so
Cou must use t!e setmqm command from t!e installation $ou #ant to associate t!e
queue manager #it!.
8!e installation name specified b$ t!e setmqm command must matc! t!e installation
from #!ic! t!e setmqm command is issued.
Cou must stop t!e queue manager before e/ecuting t!e setmqm command. 8!e
command fails if t!e queue manager is still running.
Dnce $ou !a)e set t!e associated installation of a queue manager using t!e setmqm
command1 migration of t!e queue managerYs data occurs #!en $ou start t!e queue
manager using t!e strmqm command.
Dnce $ou !a)e started t!e queue manager on an installation1 $ou cannot t!en use
setmqm to set t!e associated installation to an earlier )ersion of Webp!ere MQ1 as it is
not possible to migrate bac+ to earlier )ersions of Webp!ere MQ.
Cou can find out #!ic! installation is associated #it! a queue manager b$ using t!e
dspmq command. ee dspmq for more information.
2.4,.3 Sintaxis
>>-setmqm-- -m--QMgrName-- -n--InstallationName----------------><
Parmetro Descripcin
-m QMgrName El nombre del administrador de cola a seleccionar asociado a la instalacin.
-n .nstallationName 8!e name of t!e installation t!at t!e queue manager is to be associated #it!. 8!e
installation name is not case.sensiti)e.
Cd. )et. Descripcin
< Queue manager set to an installation #it!out error
;< 0ommand not e/ecuted from t!e installation named b$ t!e .n parameter
;= In)alid installation name for t!is queue manager
;F ?esource problem
>= Error ine/perado
==F %ser not aut!ori4ed
2.4,.6 Ejemplos
Este comando asocia un administrador de cola QM5R31 de una instalacin con e nombre
de instalacin miInstalacion.
MQ2INST%LL%TI(N2P%T#'bin'setmqm -m QMJ2= -n mi;nstala-i.n
2.5$ setmqspl
%se t!e setmqspl command to define a ne# securit$ polic$1 alter an alread$ e/isting one1
or remo)e an e/isting polic$.
2.5-.1 Sintaxis
>>-setmqs"l-- -m -QMgrName-------------------------------------->
>-- -" -PolicyName--+-| %.li-! definiti.n |-+------------------><
'- -rem.ve--------------'
2.5#.1.1 POLICY DEFINITION
.----------------------.
.-*>*+----. V |
|-- -e -+---------+----+------------------+-+------------------->
| H=I | '- -r -RecipientDN-'
+-258-----+
+-$+S-----+
+-F$+S----+
+-A+S=8C--+
'-A+S8E7--'
.-----------------------.
V | .-*>*+---. .-A-.
>----+-------------------+-+-- -s -+--------+-- -t -+---+-------|
| H8I | +-M$E----+ '-=-'
'- -a -%uthorDN-----' +-S(A=---+
+-S(A8E7-+
+-S(AFCD-+
'-S(AE=8-'
Notas' !+ an encryption algorit*m is selected, a recipient %N must also be provided-
!+ an aut*or %N is provided, a signing algorit*m must also be selected-
Tabla 3+ SeJales !e coman!o !e setm*spl+
/e>al de
Comando
:&plicacin
-m
Queue manager name.
8!is flag is mandator$ for all actions on securit$ policies.
-p
6olic$ name.
et t!e polic$ name to t!e name of t!e queue $ou #is! t!e polic$ to appl$ to.
-s
Digital signature algorit!m.
Webp!ere- MQ Ad)anced Message ecurit$ supports t!e follo#ing )alues: MDG1 MA=1
MAHG;1 MAEAB1 and MAG=H. All must be in uppercase. 8!e default )alue is &D&E
Important:
7or t!e MAEAB and MAG=H cr$ptograp!ic !as! functions1 +e$s used for signing must be
longer t!an >;A bits.
Encr$ption algorit!ms[ name must be in uppercase
-e
Digital encr$ption algorit!m.
Webp!ere MQ Ad)anced Message ecurit$ supports t!e follo#ing encr$ption algorit!ms:
?0H1 DE1 EDE1 AE=HA1 AEHG;. 8!e default )alue is &D&E.
Important: Encr$ption algorit!ms[ name must be in uppercase
-r
Message recipient[s distinguis!ed name "D&( "certificate of a D& pro)ided is used to encr$pt
a gi)en message(. ?ecipients can be specified onl$ if encr$ption algorit!m is different from
&D&E. Multiple recipients can be included for a message. Eac! D& must be pro)ided #it! a
separate .r flag.
Important:
D& attribute names must be in uppercase.
0ommas must be used as a name separators.
8o a)oid command interpreter errors1 place quotation mar+s around t!e D&s.
7or e/ample:
.r Q0&Valice1 DVibm1 0V%Q
-a
ignature D& t!at is )alidated during message retrie)al. Dnl$ messages signed b$ a user
#it! a D& pro)ided are accepted during t!e retrie)al. ignature D&s can be specified onl$ if
t!e signature algorit!m is different from &D&E. Multiple aut!ors can be included. Eac!
aut!or needs to !a)e a separate .a flag.
Important: D& attribute name must be in uppercase.
-t
8oleration flag t!at indicates #!et!er a polic$ t!at is associated #it! a queue can be ignored
#!en an attempt to retrie)e a message from t!e queue in)ol)es a message #it! no securit$
polic$ set. 3alid )alues include:
C =defaultF
8oleration flag off.
1
8oleration flag on.
Tabla 3+ SeJales !e coman!o !e setm*spl+
/e>al de
Comando
:&plicacin
8oleration is optional and facilitates staged roll.out1 #!ere policies #ere applied to queues
but t!ose queues ma$ alread$ contain messages t!at !a)e no polic$1 or still recei)e
messages from remote s$stems t!at do not !a)e t!e securit$ polic$ set.
-
remove
Delete polic$.
If specified1 onl$ t!e .p flag remains )alid.
2.51 setmqprd
Enroll a Webp!ere- MQ production license.
A license is normall$ enrolled as part of t!e installation process.
&ote: Cou must !a)e t!e appropriate pri)ileges to run t!is command on $our s$stem. %&I'
requires root access1 and Windo#s #it! %A0 "%ser Account 0ontrol( requires Administrator access to
run t!is command.
2.51.1 Sintaxis
>>-setmq"rd--LicenseFile---------------------------------------><
Parmetro Descripcin
9icense;ile pecifies t!e full$.qualified name of t!e production license certificate file.
8!e full license file is amqpcert.lic. Dn %&I' and 2inu/1 it is in t!e <Media'oot:licences
director$ on t!e installation media. Dn Windo#s it is in t!e FMedia'ootSlicences director$ on
t!e installation media. It is installed into t!e bin director$ on t!e Webp!ere MQ installation
pat!.
2.51.3 Con$ersin de licencia (rial
A trial license installation is identical to a production license installation1 e/cept for t!e
Qcount.do#nQ message t!at is displa$ed #!en $ou start a queue manager on an installation #it! a
trial license. 6arts of Webp!ere MQ t!at are not installed on t!e ser)er1 suc! as t!e Webp!ere MQ
MQI client1 continue to #or+ after t!e e/pir$ of t!e trial license. Cou do not need to run setmqprd to
enroll t!em #it! a production license.
W!en a trial license e/pires1 $ou can still uninstall Webp!ere MQ. Cou can also reinstall
Webp!ere MQ #it! a full production license.
?un setmqprd to enroll a production license after installing and using a installation #it! a
trial license.
2.51.4 (areas relacionadas)
0on)erting a trial license on %&I'1 2inu/1 and Windo#s
2.52 setmqscp
6ublis! client connection c!annel definitions in an Acti)e Director$ "Windo#s onl$(.
2.52.1 Propsito
Note' T*e setmqscp command applies to .ebSp*ereG MQ +or .indo/s only-
%se t!e setmqscp command to configure and administer support for publis!ing client
connection c!annel definitions in an Acti)e Director$.
Initiall$1 t!is command is used b$ a domain administrator to:
6repare t!e Acti)e Director$ for Webp!ere MQ use
Lrant Webp!ere MQ users and administrators t!e rele)ant aut!orities to access and
update t!e Webp!ere MQ Acti)e Director$ ob5ects
Cou can also use t!e setmqscp command to displa$ all t!e currentl$ configured client
connection c!annel definitions a)ailable on t!e Acti)e Director$.
2.52.2 Sintaxis
>>-setmqs-"--+--------------------------+----------------------->
'- -a --+----------------+-'
'- -m --QMgrName-'
>--+--------------------------+--+------+----------------------><
'- -r --+----------------+-' '- -d -'
'- -m --QMgrName-'
Cou must specif$ one of .a "add(1 .r "remo)e( or .d "displa$(.
Parmetro Descripcin
-a Adds t!e Webp!ere MQ MQI client connections Acti)e Director$ container1 if it does not alread$
e/ist. Cou must be a user #it! t!e appropriate pri)ileges to create subcontainers in t!e System
container of $our domain. 8!e Webp!ere MQ folder is called 0&VI,M.MQ0lient0onnections. Do
not delete t!is folder in an$ ot!er #a$ t!an b$ using t!e setmqscp .r command.
-d Displa$s t!e ser)ice connection points.
-r ?emo)es t!e ser)ice connection points. If $ou omit .m1 and no client connection definitions e/ist
in t!e I,M.MQ0lient0onnections folder1 t!e folder itself is remo)ed from t!e Acti)e Director$.
-m 6 - , qmgr 8
Modifies t!e specified parameter ".a or .r( so t!at onl$ t!e specified queue manager is affected.
- , qmgr
- specifies t!at all queue managers are affected. 8!is enables $ou to migrate a specific client
connection table file from one queue manager alone1 if required.
2.52.4 Ejemplos
8!e follo#ing command creates t!e I,M.MQ0lient0onnections folder and allocates t!e
required permissions to Webp!ere MQ administrators for t!e folder1 and to c!ild ob5ects created
subsequentl$:
setmqs-" -a
8!e follo#ing command migrates e/isting client connection definitions from a local queue
manager1 6aint.queue.manager1 to t!e Acti)e Director$:
setmqs-" -a -m %aint.queue.manager
8!e follo#ing command migrates all client connection definitions on t!e local ser)er to t!e
Acti)e Director$:
setmqs-" -a -m 0
2.53 strmqcf%
Inicia E/plorador Webp!ere- MQ "solo plataformas Windo#s1 2inu/ /A;1 $ 2inu/ /A;.;B(.
2.53.1 Propsito
6ara Webp!ere MQ de Windo#s solamente1 obse)a que si usas runas para e5ecutar este
comando1 debes definir la )ariable de entorno A66DA8A.
Dn 2inu/1 to start Webp!ere MQ E/plorer successfull$1 $ou must be able to #rite a file to
$our !oueme director$1 and t!e !ome director$ must e/ist.
Nota' a +orma pre+erida para iniciar el 06plorador .ebSp*ere MQ en sistemas .indo/s
y inu6 es usar el menu de sistema, o el +ic*ero e,ecutable MQ06plorer-
2.53.2 Sintaxis
2a sint9/is de este comado es la siguiente:
>>-strmq-fg--+------+--+------+--+------+----------------------><
'- -- -' '- -i -' '- -, -'
Parmetro Descripcin
-c .clean is passed to Eclipse. 8!is parameter causes Eclipse to delete an$ cac!ed data used b$ t!e
Eclipse runtime.
-i .init is passed to Eclipse. 8!is parameter causes Eclipse to discard configuration information used
b$ t!e Eclipse runtime.
-& Dutput debug messages to t!e console.
2.54 strmqcsv
Inicia el ser)idor de comando para un administrador de cola.
2.54.1 Propsito
%se t!e strmqcs) command to start t!e command ser)er for t!e specified queue manager.
8!is enables Webp!ere- MQ to process commands sent to t!e command queue.
Cou must use t!e strmqcs) command from t!e installation associated #it! t!e queue
If t!e queue manager attribute1 0MDE?31 is specified as QML? t!en c!anging t!e state
of t!e command ser)er using strmqcs) does not effect !o# t!e queue manager acts upon t!e
0MDE?3 attribute at t!e ne/t restart.
2.54.2 Sintaxis
>>-strmq-sv--+-----+--+----------+-----------------------------><
'- -a-' '-QMgrName-'
&inguno
Parmetro Descripcin
-a ,loc+s t!e follo#ing 607 commands from modif$ing or displa$ing aut!orit$ information:
Inquire aut!orit$ records "MQ0MDNI&Q%I?ENA%8MN?E0(
Inquire entit$ aut!orit$ "MQ0MDNI&Q%I?ENE&8I8CNA%8M(
et aut!orit$ record "MQ0MDNE8NA%8MN?E0(.
Delete aut!orit$ record "MQ0MDNDE2E8ENA%8MN?E0(.
QMgrName El nombre del adminitrador de cola en el que iniciar el ser)idor de comando. i es omitido1
es usado el administrador de cola por defecto.
Cd. )et. Descripcin
2.54.6 Ejemplos
El comando siguiente inicia un ser)idor de comando para un administrador de cola eart-:
strmq-sv eart&
Comando Descripcin
endmqcs) End a command ser)er
dspmqcs) Displa$ t!e status of a command ser)er
2.55 strmqsvc ()niciar servicio )*+ ,eb-phere +.)
8!e strmqs)c command starts t!e I,M- Webp!ere- MQ ser)ice on Windo#s. ?un t!e
command on Windo#s onl$.
2.55.1 Propsito
El comndo inicia el ser)icio I,M Webp!ere MQ en Windo#s.
E5ecuta el comando para iniciar el ser)icio1 si no !a sido iniciado autom9ticamente1 o si el
ser)icio !a finali4ado.
?estaura el ser)icio Webp!ere MQ para recoger un &ue)o entorno1 incluido nue)as
definiciones de seguridad.
2.55.2 Sintaxis
strmqsvc
2.55.3 Parmetros
El comando strmqsvc no tiene par9metros.
Cou must set t!e pat! to t!e installation t!at contains t!e ser)ice. Eit!er ma+e t!e
installation primar$1 run t!e setmqen) command1 or run t!e command from t!e director$ containing
t!e strmqs)c binar$ file.
2.55.4 *e+erencia relacionada)
endmqs)c "end I,M Webp!ere MQ ser)ice(
2.5 strmqm
Inicia un administrador de cola lo adapta para operaciones de reser)a.
2.56.1 Propsito
%se 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 est9s traba5ando. 6uedes encontrar que un administrador de cola est9 asociado a la
instalacin usando el comando dspmq -o installation.
If a queue manager !as no associated installation and t!ere is no installation of
Webp!ere- MQ 3>.<.= on t!e s$stem1 t!e strmqm command #ill associate t!e queue manager
#it! t!e installation t!at issued t!e strmqm command.
If t!e queue manager startup ta+es more t!an a fe# seconds Webp!ere MQ s!o#s
intermittent messages detailing t!e startup progress.
2.56.2 Sintaxis
>>-strmqm--+----------------------+--+-----+--+-------+--------->
+- -- -----------------+ '- -f ' +- -si -+
+- -r -----------------+ '- -ss -'
+- -a -----------------+
+- -, -----------------+
'- -e 5M$4+V+4=--Level '
>--+------------------+--+------+--+------+--+-----------+-----><
'- -d -In"ormation ' '- -z -' '- -ns-' '- QMgrName '
Parmetro Descripcin
-a Acti)ate t!e specified bac+up queue manager. 8!e bac+up queue manager is not started.
W!en acti)ated1 a bac+up queue manager can be started using t!e control command
strmqm QMgr&ame. 8!e requirement to acti)ate a bac+up queue manager pre)ents
accidental startup.
W!en acti)ated1 a bac+up queue manager can no longer be updated.
7or more information about using bac+up queue managers1 see ,ac+ing up and restoring
Webp!ere MQ queue manager data.
-c tarts t!e queue manager1 redefines t!e default and s$stem ob5ects1 t!en stops t!e
queue manager. An$ e/isting s$stem and default ob5ects belonging to t!e queue
manager are replaced if $ou specif$ t!is flag1 and an$ non.default s$stem ob5ect )alues
are reset "for e/ample1 t!e )alue of M0A%E? is set to blan+(.
%se t!e crtmqm command to create t!e default and s$stem ob5ects for a queue manager.
-d +nformation pecifies #!et!er information messages are displa$ed. 6ossible )alues for Information
follo#:
3alor Descripcin
all All information messages are displa$ed. 8!is parameter is t!e default
)alue.
minimal 8!e minimal number of information messages are displa$ed.
none &o information messages are displa$ed. 8!is parameter is equi)alent to .4.
8!e ?z parameter ta+es precedence o)er t!is parameter.
-e
C!D9:":9=9evel
Enables a command le)el for t!is queue manager1 and t!en stops t!e queue manager.
8!e queue manager is no# able to use all functions pro)ided b$ t!e specified command
le)el. Cou can start t!e queue manager onl$ #it! an installation t!at supports t!e ne#
command le)el.
8!is option is onl$ )alid if t!e current command le)el used b$ t!e queue manager is
lo#er t!an t!e ma/imum command le)el supported b$ t!e installation. pecif$ a
command le)el t!at is greater t!an t!e current command le)el of t!e queue manager and
less t!an or equal to t!e ma/imum command le)el supported b$ t!e installation.
%se e/actl$ t!e command le)el as a )alue for 2e)el t!at is associated #it! t!e function
$ou #ant to enable.
8!is flag cannot be specified #it! .a1 .c1 .r or ./.
-f %se t!is option if $ou +no# a queue manager is not starting because its data directories
are missing or corrupted.
8!e strmqm .f qmname command attempts to re.create t!e queue manager data
director$ and reset file permissions. If it is successful1 t!e queue manager starts1 unless
t!e queue manager configuration information is missing. If t!e queue manager fails to
start because t!e configuration information is missing1 re.create t!e configuration
information1 and restart t!e queue manager.
In releases of Webp!ere MQ earlier t!an >.<.=1 strmqm1 #it! no .f option1 automaticall$
repaired missing data directories and t!en tried to start. 8!is be!a)ior !as c!anged.
7rom Webp!ere MQ 3ersion >.<.= on#ards1 t!e default be!a)ior of strmqm1 #it! no .f
option1 is not to reco)er missing or corrupted data directories automaticall$1 but to report
an error1 suc! as AMQ;HEG or AMQ><<=1 and not start t!e queue manager.
Cou can t!in+ of t!e .f option as performing t!e reco)er actions t!at used to be
performed automaticall$ b$ strmqm.
8!e reason for t!e c!ange to t!e be!a)ior of strmqm is t!at #it! t!e support for
net#or+ed file storage in Webp!ere MQ 3ersion >.<.=1 t!e most li+el$ cause of missing
or corrupted queue manager data directories is a configuration error t!at can be rectified1
rat!er t!an t!e data directories are corrupted or irretrie)abl$ una)ailable.
Cou must not use strmqm .f to re.create t!e queue manager data directories if $ou can
restore t!e directories b$ correcting t!e configuration.
6ossible solutions to problems #it! strmqm are to ma+e t!e net#or+ed file storage
location accessible to t!e queue manager1 or to ensure t!e gid and uid of t!e mqm group
and user ID on t!e ser)er !osting t!e queue manager matc! t!e gid and uid of t!e mqm
group and user ID on t!e ser)er !osting t!e queue manager data director$.
7rom Webp!ere MQ 3ersion >.<.=1 if $ou are performing media reco)er$ for a queue
manager1 t!en $ou must use t!e .f option to re.create t!e queue manager data
director$.
-ns 6re)ents an$ of t!e follo#ing processes from starting automaticall$ #!en t!e queue
manager starts:
8!e c!annel initiator
8!e command ser)er
2isteners
er)ices
-r %pdates t!e bac+up queue manager. 8!e bac+up queue manager is not started.
Webp!ere MQ updates t!e ob5ects of t!e bac+up queue manager b$ reading t!e queue
manager log and repla$ing updates to t!e ob5ect files.
7or more information about using bac+up queue managers1 see ,ac+ing up and restoring
Webp!ere MQ queue manager data.
-si Interacti)e "manual( queue manager startup t$pe. 8!is option is a)ailable on Webp!ere
MQ for Windo#s onl$.
8!e queue manager runs under t!e logged on "interacti)e( user. Queue managers
configured #it! interacti)e startup end #!en t!e user #!o started t!em logs off.
If $ou set t!is parameter1 it o)errides an$ startup t$pe set pre)iousl$ b$ t!e crtmqm
command1 t!e amqmdain command1 or t!e Webp!ere MQ E/plorer.
If $ou do not specif$ a startup t$pe of eit!er .si or .ss1 t!e queue manager startup t$pe
specified on t!e crtmqm command is used.
-ss er)ice "manual( queue manager startup t$pe. 8!is option is a)ailable on Webp!ere MQ
for Windo#s onl$.
8!e queue manager runs as a ser)ice. Queue managers configured #it! ser)ice startup
continue to run e)en after t!e interacti)e user !as logged off.
If $ou set t!is parameter1 it o)errides an$ startup t$pe set pre)iousl$ b$ t!e crtmqm
command1 t!e amqmdain command1 or t!e Webp!ere MQ E/plorer.
-& tart an instance of a multi.instance queue manager on t!e local ser)er1 permitting it to
be !ig!l$ a)ailable. If an instance of t!e queue manager is not alread$ running
else#!ere1 t!e queue manager starts and t!e instance becomes acti)e. 8!e acti)e
instance is read$ to accept local and remote connections to t!e queue manager on t!e
local ser)er.
If a multi.instance queue manager instance is alread$ acti)e on a di++erent ser)er t!e
ne# instance becomes a standb$1 permitting it to ta+eo)er from t!e acti)e queue
manager instance. W!ile it is in standb$1 it cannot accept local or remote connections.
Cou must not start a second instance of a queue manager on t!e same ser)er.
8!e default be!a)ior1 omitting t!e ./ optional parameter1 is to start t!e instance as a
single instance queue manager1 forbidding standb$ instances from being started.
8!is flag is used #it!in Webp!ere MQ to suppress un#anted information messages.
,ecause using t!is flag can result in loss of information1 do not use it #!en entering
commands on a command line.
8!is parameter ta+es precedence o)er t!e .d parameter.
!gr#ame 8!e name of a local queue manager. If omitted1 t!e default queue manager is used.
Cd. )et. Descripcin
< Queue manager started
HE 2og not a)ailable
HB
A process t!at #as using t!e pre)ious instance of t!e queue manager !as not $et
disconnected.
E<
A standb$ instance of t!e queue manager started. 8!e acti)e instance is running
else#!ere
E=
8!e queue manager alread$ !as an acti)e instance. 8!e queue manager permits
standb$ instances.
EF In)alid parameter specified
BE
8!e queue manager alread$ !as an acti)e instance. 8!e queue manager does not
permit standb$ instances.
B> 8!e queue manager alread$ !as t!e ma/imum number of standb$ instances
>= Error ine/perado
>B 8!e Webp!ere MQ ser)ice is not started.
F= 8!e command le)el is outside t!e range of acceptable )alues.
FH 8!e queue managerYs command le)el is greater or equal to t!e specified )alue.
=<< 2og location in)alid
==F %ser not aut!ori4ed to start t!e queue manager
2.56.5 Ejemplos
El siguiente comando inicia la cuenta del administrador de cola:
strmqm a--.unt
Command Descripcin
crtmqm
Define un administrador de cola
dltmqm
,orra un administrador de cola
dspmq)er
3isuali4a informacin de )ersion de MQ
endmqm
7inali4a un administrador de cola
2.5! strmqtrc
Enable trace at a specified le)el of detail1 or report t!e le)el of tracing in effect.
2.57.1 Propsito
%se t!e strmqtrc command to enable tracing.
Cou must use t!e strmqtrc command from t!e installation associated #it! t!e queue
2.57.2 Sintaxis
8!e s$nta/ of t!is command is as follo#s:
>>-strmqtr---+----------------+--+------+----------------------->
'- -m --QMgrName-' '- -e -'
.---------------------.
V |
>----+-----------------+-+--+-----------------+----------------->
'- -t --TraceType-' '- -, --TraceType-'
>--+---------------+--+----------------------+------------------>
'- -l --MaxSi/e-' '- -d--+- A----------+-'
+- -=---------+
'- Num("3ytes-'
>--+---------------+--+------------+--+------+------------------>
'- -i --Pi$Ti$s-' '- -" --%pps-' '- -s -'
>--+--------------------+--+-------------------+---------------><
'- -b --StartTrigger-' '- -- --StopTrigger-'
2.57.3 3escription
El comando strmqtrc acti)e el tra4ado. 8iene par9metros opcionales que especifican el
ni)el de tra4a que deseas:
%na o m9s administradores de cola
&i)eles de detalle de tra4a
%no o m9s procesos Webp!ere- MQ. El proceso o bien puede ser parte del product
Webp!ere MQ o aplicaciones personalidadas que usan la A6I Webp!ere MQ
Milos espec*ficos con aplicaciones personali4adas1 bien por n@mero de !ilo Webp!ere
MQ o por n@mero de !ilo del sistema operati)o
E)entos. Estos pueden ser o bien la entrada o salida desde funciones internas de
Webp!ere MQ o la ocurrencia de una primera captura de datos fallida "7D0(.
0ada combinacin de par9metros en una llamada indi)idual del comando es interpretada
por Webp!ere MQ seg@n tenga un A&D lgico entre ellos. 6uedes iniciar el comando strmqtrc
multiples )eces1 sin considerer si el tra4ado $a est9 acti)o. i el tra4ado est9 acti)e1 las opciones de
tra4a que est9n en efecto son modificadas para aquellos que son especificados en la llamada m9s
reciente del comando. Multiples llamadas del comando1 sin una inter)encin del comando
enqmqtrc1 son interpretadas por Webp!ere MQ como un lgico D? entre ellos. El m9/imo n@mero
de comandos strmqtrc concurrentes que pueden tener efecto a la )e4 es =;.
Parmetro Descripcin
-m !gr#ame El nombre del administrador de cola a tra4ar.
on permitidos los siguientes comodines: asterisco "J(1 reempla4a < m9s caracteres1 $
marca de interrogacin "W(1 reempla4a un car9cter simple. En entornos de comando tales
como el esquema %&I'1 donde los caracteres asterisco "J( $ marca de interrogacin "W(
tienen significado especial1 debes delimiter los caracteres comodin entre secuencia de
escape o entrecomillarlo para pre)enir el entorno de commando de la operacin en el
car9cter comodin.
-e ?equests earl$ tracing of all processes1 ma+ing it possible to trace t!e creation or startup
of a queue manager. If $ou include t!is flag1 an$ process belonging to an$ component of
an$ queue manager traces its earl$ processing. 8!e default is not to perform earl$ tracing.
Cou cannot use t!e .e flag #it! t!e .m flag1 .i flag1 t!e .p flag1 t!e .c flag1 or t!e .b flag. If
$ou tr$ to use t!e .e flag #it! t!e .m flag1 t!e .i flag1 t!e .p flag1 t!e .c flag1 or t!e .b flag1
t!en an error message is issued.
-t TraceT'pe 8!e points to trace and t!e amount of trace detail to record. ,$ default all trace points are
enabled and a default.detail trace is generated.
Alternati)el$1 $ou can suppl$ one or more of t!e options in t!e follo#ing list. 7or eac!
tracet$pe )alue $ou specif$1 including .t all1 specif$ eit!er .t parms or .t detail to obtain
t!e appropriate le)el of trace detail. If $ou do not specif$ eit!er .t parms or .t detail for
an$ particular trace t$pe1 onl$ a default.detail trace is generated for t!at trace t$pe.
If $ou suppl$ multiple trace t$pes1 eac! must !a)e its o#n .t flag. Cou can include an$
number of .t flags1 if eac! !as a )alid trace t$pe associated #it! it.
It is not an error to specif$ t!e same trace t$pe on multiple .t flags.
"alor Descripcin
all Dutput data for e)er$ trace point in t!e s$stem "t!e default(. 8!e all
parameter acti)ates tracing at default detail le)el.
api Dutput data for trace points associated #it! t!e MQI and ma5or queue
manager components.
commentar' Dutput data for trace points associated #it! comments in t!e Webp!ere
MQ components.
comms Dutput data for trace points associated #it! data flo#ing o)er
communications net#or+s.
csdata Dutput data for trace points associated #it! internal data buffers in
common ser)ices.
csflo*s Dutput data for trace points associated #it! processing flo# in common
ser)ices.
detail Acti)ate tracing at !ig!.detail le)el for flo# processing trace points.
:&plorer Dutput data for trace points associated #it! t!e Webp!ere MQ E/plorer.
7ava Dutput data for trace points associated #it! applications using t!e
Webp!ere MQ classes for Oa)aU A6I.
lqmdata Dutput data for trace points associated #it! internal data buffers in t!e
local queue manager.
lqmflo*s Dutput data for trace points associated #it! processing flo# in t!e local
queue manager.
ot(erdata Dutput data for trace points associated #it! internal data buffers in ot!er
components.
ot(erflo*s Dutput data for trace points associated #it! processing flo# in ot!er
components.
parms Acti)ate tracing at default.detail le)el for flo# processing trace points.
remotedata Dutput data for trace points associated #it! internal data buffers in t!e
communications component.
remoteflo*s Dutput data for trace points associated #it! processing flo# in t!e
communications component.
servicedata Dutput data for trace points associated #it! internal data buffers in t!e
ser)ice component.
serviceflo*s Dutput data for trace points associated #it! processing flo# in t!e ser)ice
component.
soap Dutput data for trace points associated #it! Webp!ere MQ 8ransport for
DA6.
ssl Dutput data associated #it! using LKit to enable ecure oc+ets 2a$er
"2( c!annel securit$.
versiondata Dutput data for trace points associated #it! t!e )ersion of Webp!ere MQ
running.
-& TraceT'pe 8!e points not to trace. ,$ default all trace points are enabled and a default.detail trace is
generated. 8!e trace points $ou can specif$ are t!ose listed for t!e .t flag.
Cou can use t!e ./ flag #it! tracet$pe )alues to e/clude t!ose entr$ points $ou do not #ant
to record. 8!is is useful in reducing t!e amount of trace produced.
If $ou suppl$ multiple trace t$pes1 eac! must !a)e its o#n ./ flag. Cou can include an$
number of ./ flags1 if eac! !as a )alid tracet$pe associated #it! it.
-l !a&/i4e 8!e ma/imum si4e of a trace file "AMQppppp.qq.8?0( in megab$tes "M,(. 7or e/ample1 if
$ou specif$ a Ma/i4e of =1 t!e si4e of t!e trace is limited to = M,.
W!en a trace file reac!es t!e specified ma/imum1 it is renamed to AMQppppp.qq.8? and
a ne# AMQppppp.qq.8?0 file is started. If a pre)ious cop$ of an AMQppppp.qq.8? file
e/ists1 it is deleted.
8!e !ig!est )alue t!at Ma/i4e can be set to is H<BA M,.
-d C 8race no user data.
-d -1 or all 8race all user data
-d #um%fB'tes 7or a communication traceR trace t!e specified number of b$tes of data including t!e
transmission segment !eader "8M(.
7or an MQ6%8 or MQLE8 callR trace t!e specified number of b$tes of message data !eld in
t!e message buffer.
3alues in t!e range = t!roug! =G are not allo#ed.
-i PidTids 6rocess identifier "6ID( and t!read identifier "8ID( to #!ic! t!e trace generation is
restricted. Cou cannot use t!e .i flag #it! t!e .e flag. If $ou tr$ to use t!e .i flag #it! t!e
.e flag1 t!en an error message is issued. 8!is parameter must onl$ be used under t!e
guidance of I,M- er)ice personnel.
8!is parameter is not supported for .&E8 clients if &MQNMQN2I, is set to managed1 so t!at
t!e client uses managed Webp!ere MQ problem diagnostics.
-p Apps 8!e named processes to #!ic! t!e trace generation is restricted. Apps is a comma.
separated list. Cou must specif$ eac! name in t!e list e/actl$ as t!e program name #ould
be displa$ed in t!e Q6rogram &ameQ 7D0 !eader. Asteris+ "J( or question mar+ "W(
#ildcards are allo#ed. Cou cannot use t!e .p flag #it! t!e .e flag. If $ou tr$ to use t!e .p
flag #it! t!e .e flag1 t!en an error message is issued.
8!is parameter is not supported for .&E8 clients if &MQNMQN2I, is set to managed1 so t!at
t!e client uses managed Webp!ere MQ problem diagnostics.
-s ?eports t!e tracing options t!at are currentl$ in effect. Cou must use t!is parameter on its
o#n #it! no ot!er parameters.
A limited number of slots are a)ailable for storing trace commands. W!en all slots are in
use1 t!en no more trace commands can be accepted unless t!e$ replace an e/isting slot.
lot numbers are not fi/ed1 so if t!e command in slot number < is remo)ed1 for e/ample b$
an endmqtrc command1 t!en all t!e ot!er slots mo)e up1 #it! slot = becoming slot <1 for
e/ample. An asteris+ "J( in a field means t!at no )alue is defined1 and is equi)alent to t!e
asteris+ #ildcard.
An e/ample of t!e output from t!is command is as follo#s:
4isting ra-e 5.ntr.l Arra!
6sed sl.ts = 8 .f =E
+arl!ra-e V><<X
imedra-e V><<X
ra-e6ser$ata VAX
Ma,Size VAX
ra-e !"e V=X
Sl.t ".siti.n =
6ntriggered
Queue Manager Vav.-etX
A""li-ati.n V0X
%;$.;$ V0X
ra-e>"ti.ns V=fDffffX
ra-e;nterval VAX
ra-e Start ime VAX
ra-e St." ime VAX
Start rigger V\*FD7AEA\X
Start rigger V\*FD7ACAX
Sl.t ".siti.n 8
6ntriggered
Queue Manager V0X
A""li-ati.n V0X
%;$.;$ V0X
ra-e>"ti.ns V=f-ffffX
ra-e;nterval VAX
ra-e Start ime VAX
ra-e St." ime VAX
Start rigger V\*FD7AEA\X
Start rigger V\*FD7ACAX
Este par9metro no est9 soportado para clientes .&E8 si &MQNMQN2I, est9 seleccionado
como administrado1 de forma que los \clientes usan diagnstico de problemas Webp!ere
MQ administrado.
-b /tart?Trigger 7D0 probe IDs for #!ic! tracing must be turned on. tartN8rigger is a comma.separated
list of 7D0 probe IDs. Cou can use asteris+ "J( and question mar+ "W( #ildcards in t!e
specification of probe IDs. Cou cannot use t!e .b flag #it! t!e .e flag. If $ou tr$ to use t!e
.b flag #it! t!e .e flag1 t!en an error message is issued. 8!is parameter must onl$ be used
under t!e guidance of I,M er)ice personnel.
/tart?Trigger :fecto
7D0Vcomma.separated list of
7D0 probe IDs.
8urns on tracing #!en an$ 7D0s #it! t!e specified 7D0
probe IDs are generated.
8!is parameter is not supported for .&E8 clients if &MQNMQN2I, is set to managed1 so
t!at t!e client uses managed Webp!ere MQ problem diagnostics.
-c /top?Trigger 7D0 probe IDs for #!ic! tracing must be turned off1 or inter)al in seconds after #!ic!
tracing must be turned off. topN8rigger is a comma.separated list of 7D0 probe IDs. Cou
can use asteris+ "J( and question mar+ "W( #ildcards in t!e specification of probe IDs. 8!is
parameter s!ould be used onl$ under t!e guidance of I,M er)ice personnel.
/top?Trigger :fecto
7D0Vcomma.separated list of 7D0
probe IDs.
8urns tracing off #!en an$ 7D0s #it! t!e specified
7D0 probe IDs are generated.
inter)alVn #!ere n is an unsigned
integer bet#een = and
EH1<<<1<<<.
8urns tracing off n seconds after it starts or1 if it
tracing is alread$ enabled1 turns tracing off n seconds
after t!is instance of t!e command is issued.
8!is parameter is not supported for .&E8 clients if &MQNMQN2I, is set to managed1 so
t!at t!e client uses managed Webp!ere MQ problem diagnostics.
Cd. )et. Descripcin
AMQ><HB &on.)alid arguments supplied to t!e command.
AMQAE<B &ine concurrent traces "t!e ma/imum( alread$ running.
2.57.6 Ejemplos
Este comando acti)a el tra4ado del flu5o de proceso desde los ser)icios communes $ el
administrador de cola local para un administrador de cola llamado !1 en Webp!ere MQ para
sistemas %&I'. El dato de la tra4a es generado en el ni)el de detalle por defecto.
strmqtr- -m QM= -t -sfl./s -t lqmfl./s -t "arms
Este comando desacti)a el tra4ado de acti)idad 2 en un administrador de cola llamado
!1. on generados otros datos de tra4ado en el ni)el de par9metros de detalle.
strmqtr- -m QM= -, ssl -t "arms
Este comando acti)e el tra4ado de alto.detalle de flu5o de proceso para todos los
componentes8!is command enables !ig!.detail tracing of t!e processing flo# for all components:
strmqtr- -t all -t detail
Este comando acti)e el tra4ado cuando ocurre 7D0 K&EB;<G< 7D0 K&EB;<A< en
cualquier proceso que est9 usando el administrador de cola !1:
strmqtr- -m QM= -b <$5=\*FD7AEA?\*FD7ACA
Este comando acti)e el tra4ado cuando ocurre 7D0 K&EB;G<1 $ para el tra4ado cuando
ocurre 7D0 K&EB;<A<. En ambos casos el 7D0 debe ocurrir en un proceso que est9 usando el
administrador de cola !1:
strmqtr- -m QM= -b <$5=\*FD7AEA -- <$5=\*FD7ACA
2os siguientes e5emplos usan las seales -p $ -m para mostrar lo siguiente:
0omo una combinacin de par9metros en una llamada indi)idual del comando son
interpretados por Webp!ere MQ seg@n un tengan un booleano entre ellos AND.
0omo multiples in)ocaciones del comando1 sin una inter)encin del comando enqmqtrc1
son interpretadas por Webp!ere MQ como un :R lgico entre ellos:
Este comando acti)e el tra4ado para todos los !ilos que resultan desde cualquier proceso
en e5ecucin llamado amq&&&.e&e:
strmqtr- -" amq,,,.e,e
i inicias el siguiente comando despus del paso =1 sin una inter)encin de comando
endmqtrc1 entonces el tra4ado est9 limitado a todos los !ilos que resultan desde
cualquier proceso de e5ecucin llamado amq&&&.e&e y que est9n usando el
administrador de cola !G:
strmqtr- -" amq,,,.e,e -m QM8
i inicias el siguiente comando despus del comando del paso =1 sin una inter)encin
del comando endmqtrc1 entonces el tra4ado est9 limitado a todos los procesos e !ilos
que resultan de la e5ecucin de amq&&&.e&e o que est9n usando el administrador de
cola !G:
strmqtr- -m QM8
Comando Descripcin
dspmqtrc 3isuali4a salida de tra4a formateada
endmqtrc 7inali4a la tra4a

Comandos de Control - MQ Series

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Comandos de Control - MQ Series

Enviado por

Direitos autorais:

Formatos disponíveis

Você também pode gostar