PQEdit User's Guide CCC Admin Pac for MQSeries - Capitalware

200 Pages·1998·1.73 MB·English

by  Candle Information Development

PQEdit™ User’s Guide

Candle Command Center® Admin Pac
for MQSeries™
Version 120
Document Number MD54-5413-0
March 1998
Candle Corporation
2425 Olympic Boulevard
Santa Monica, California 90404-4030
5HJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)&DQGOH(cid:253)&RUSRUDWLRQª(cid:253)$)(cid:238)23(5$725æ(cid:253)$)(cid:238)3(5)250(5æ(cid:253)$)(cid:238)5(027(æ(cid:253)$YDLODELOLW\(cid:253)&RPPDQG(cid:253)&HQWHUæ(cid:253)&DQGOH(cid:253)&RPPDQG(cid:253)&HQWHUæ(cid:253)
&DQGOH(cid:253)(OHFWURQLF(cid:253)&XVWRPHU(cid:253)6XSSRUWæ(cid:253)&DQGOH(cid:253)0DQDJHPHQW(cid:253)6HUYHUæ(cid:253)&DQGOH(cid:253)0DQDJHPHQW(cid:253):RUNVWDWLRQæ(cid:253)&DQGOH(cid:253)7HFKQRORJLHVæ(cid:253)&/(cid:238)&21)(5(1&(æ(cid:253)&/(cid:238)683(56(66,21æ(cid:253)
&7æ(cid:253)&7(cid:238)’DWD(cid:253)6HUYHUæ(cid:253)&7(cid:238)’6æ(cid:253)(cid:252)’%æ(cid:253)(cid:252)’%(cid:238)48,&.&+$1*(æ(cid:253)’(/7$021æ(cid:253)20(*$&(17(5æ(cid:253)20(*$021æ(cid:253)20(*$021(cid:238)Hæ(cid:253)20(*$021,,æ(cid:253)20(*$021(cid:253)
0RQLWRULQJ(cid:253)$JHQWæ(cid:253)20(*$9,(:æ(cid:253)20(*$9,(:,,æ(cid:253)DQG(cid:253)7UDQVSOH[(cid:239)
7UDGHPDUNV(cid:253)RI(cid:253)&DQGOH(cid:253)&RUSRUDWLRQª(cid:253)$OHUW(cid:253)$GDSWHUæ(cid:253)$OHUW(cid:253)$GDSWHU(cid:253)3OXVæ(cid:253)$OHUW(cid:253)(PLWWHUæ(cid:253)$06æ(cid:253)$PV\Væ(cid:253)$8720$7(’(cid:253))$&,/,7,(6æ(cid:253)$YDLODELOLW\(cid:253)0DQDJHPHQW(cid:253)
6\VWHPVæ(cid:253)&DQGOHæ(cid:253)&&&æ(cid:253)&,&$7æ(cid:253)&/(cid:238)(1*,1(æ(cid:253)&/(cid:238)*$7(:$<æ(cid:253)&/(cid:238)7(&+12/2*<æ(cid:253)&06æ(cid:253)&0:æ(cid:253)&RPPDQG(cid:253)(cid:247)(cid:253)&RQWUROæ(cid:253)&RQQHFW(cid:240)1RWHVæ(cid:253)&RQQHFW(cid:240)7ZRæ(cid:253)&6$(cid:253)
$1$/<=(5æ(cid:253)&7(cid:238)$/6æ(cid:253)&7(cid:238)$SSOLFDWLRQ(cid:253)/RJLF(cid:253)6HUYLFHVæ(cid:253)&7(cid:238)’&6æ(cid:253)&7(cid:238)’LVWULEXWHG(cid:253)&RPSXWLQJ(cid:253)6HUYLFHVæ(cid:253)&7(cid:238)(QJLQHæ(cid:253)&7(cid:238),PSOHPHQWDWLRQ(cid:253)6HUYLFHVæ(cid:253)&7(cid:238),;æ(cid:253)
&7(cid:238):RUNEHQFKæ(cid:253)&7(cid:238):RUNVWDWLRQ(cid:253)6HUYHUæ(cid:253)&7(cid:238):6æ(cid:253)(cid:252)’%(cid:238)’$6’æ(cid:253)(cid:252)’%(cid:238)(;3/$,1æ(cid:253)(cid:252)’%(cid:238)0,*5$725æ(cid:253)(cid:252)’%(cid:238)48,&.&203$5(æ(cid:253)(cid:252)’%(cid:238)608æ(cid:253)(cid:252)’%(cid:238)7RROVæ(cid:253)
(cid:252)’%(cid:238):25.%(1&+æ(cid:253)’HVLJQ(cid:253)1HWZRUNæ(cid:253)’(;$1æ(cid:253)(QG(cid:240)WR(cid:240)(QGæ(cid:253)(QWHUSULVH(cid:253)&DQGOH(cid:253)&RPPDQG(cid:253)&HQWHUæ(cid:253)(QWHUSULVH(cid:253)&DQGOH(cid:253)0DQDJHPHQW(cid:253):RUNVWDWLRQæ(cid:253)(3,/2*æ(cid:253)(65$æ(cid:253)
+RVW%ULGJHæ(cid:253),QWHOOL:DWFKæ(cid:253)0HVVDJLQJ(cid:253)0DVWHUHGæ(cid:253)04$’0,1æ(cid:253)04(GLWæ(cid:253)04(;3(57æ(cid:253)04021æ(cid:253)046HFXUHæ(cid:253)049LHZæ(cid:253)1HWZRUNHG(cid:253)$SSOLFDWLRQVæ(cid:253)20$æ(cid:253)1HWZRUNHG(cid:253)
%XVLQHVVHVæ(cid:253)20&(cid:253)*DWHZD\æ(cid:253)20&(cid:253)6WDWXV(cid:253)0DQDJHUæ(cid:253)20(*$&(17(5(cid:253)%ULGJHæ(cid:253)20(*$&(17(5(cid:253)*DWHZD\æ(cid:253)20(*$&(17(5(cid:253)6WDWXV(cid:253)0DQDJHUæ(cid:253)20(*$021(cid:253)
0DQDJHPHQW(cid:253)&HQWHUæ(cid:253)260æ(cid:253)3&(cid:253)&203$1,21æ(cid:253)3HUIRUPDQFH(cid:253)3DFæ(cid:253)3RZHU4æ(cid:253)34&RQILJXUDWLRQæ(cid:253)34(GLWæ(cid:253)346FRSHæ(cid:253)57$æ(cid:253)6ROXWLRQV(cid:253)IRU(cid:253)1HWZRUNHG(cid:253)$SSOLFDWLRQVæ(cid:253)6ROXWLRQV(cid:253)
IRU(cid:253)1HWZRUNHG(cid:253)%XVLQHVVHVæ(cid:253)6WDWXV(cid:253)0RQLWRUæ(cid:253)DQG(cid:253)8QLILHG(cid:253)’LUHFWRU\(cid:253)6HUYLFHV(cid:239)
6HUYLFH(cid:253)PDUNV(cid:253)RI(cid:253)&DQGOH(cid:253)&RUSRUDWLRQª(cid:253)&(&6(cid:239)
3URGXFWV(cid:253)DQG(cid:253)WHUPV(cid:253)XVHG(cid:253)KHUHLQ(cid:253)PD\(cid:253)EH(cid:253)WUDGHPDUNV(cid:253)RU(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)WKHLU(cid:253)UHVSHFWLYH(cid:253)KROGHUV(cid:239)(cid:253)7KLV(cid:253)GRFXPHQWDWLRQ(cid:253)VHW(cid:253)PD\(cid:253)FRQWDLQ(cid:253)UHIHUHQFHV(cid:253)WR(cid:253)VRPH(cid:253)RU(cid:253)DOO(cid:253)RI(cid:253)
WKH(cid:253)IROORZLQJ(cid:253)SURGXFWV(cid:239)
5HJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253),QWHUQDWLRQDO(cid:253)%XVLQHVV(cid:253)0DFKLQHV(cid:253)&RUSRUDWLRQª(cid:253)$,;æ(cid:253)$SSOLFDWLRQ(cid:253)6\VWHP(cid:238)Ø(cid:237)(cid:237)æ(cid:253)
$6(cid:238)Ø(cid:237)(cid:237)æ(cid:253)%RRN0DQDJHUæ(cid:253)’%ºæ(cid:253),%0æ(cid:253)70((cid:253)(cid:236)(cid:237)(cid:253)1HW9LHZæ(cid:253)26(cid:238)ºæ(cid:253)26(cid:238)Ø(cid:237)(cid:237)æ(cid:253)6$$æ(cid:253)6\VWHPV(cid:253)$SSOLFDWLRQ(cid:253)$UFKLWHFWXUHæ(cid:253)6\VWHP9LHZæ(cid:253)6\VWHP(cid:253)3HUIRUPDQFH(cid:253)0RQLWRU(cid:238)ºæ(cid:253)
7+(6(86ºæ(cid:253)90(cid:238)(6$æ(cid:253)DQG(cid:253)97$0(cid:239)
7UDGHPDUNV(cid:253)RI(cid:253),QWHUQDWLRQDO(cid:253)%XVLQHVV(cid:253)0DFKLQHV(cid:253)&RUSRUDWLRQª(cid:253)$&)(cid:238)97$0æ(cid:253)&,&6æ(cid:253)&,&6(cid:238)(6$æ(cid:253)&,&6(cid:238)096æ(cid:253)&,&6(cid:238)96(æ(cid:253)&,&6(cid:238)7UDQVDFWLRQ(cid:253)6HUYHU(cid:253)IRU(cid:253)26(cid:238)Œ(cid:228)(cid:237)(cid:253)
5HOHDVH(cid:253)(cid:236)æ(cid:253)&RPPRQ(cid:253)8VHU(cid:253)$FFHVVæ(cid:253)&8$æ(cid:253)’$7$%$6((cid:253)ºæ(cid:253)’DWD+XEæ(cid:253)’)606æ(cid:253)’)606GISæ(cid:253)’)606GVVæ(cid:253)’)606KVPæ(cid:253)’)606UPPæ(cid:253)(6$(cid:238)Œ(cid:230)(cid:237)æ(cid:253)(6&21æ(cid:253)*’’0æ(cid:253)
+LSHUVSDFHæ(cid:253),,1æ(cid:253),06(cid:238)(6$æ(cid:253),QIRUPDWLRQ(cid:253):DUHKRXVHæ(cid:253)046HULHVæ(cid:253)096(cid:238)’)3æ(cid:253)096(cid:238)(6$æ(cid:253)096(cid:238)63æ(cid:253)096(cid:238);$æ(cid:253)2IILFH9LVLRQæ(cid:253)2SHQ(GLWLRQæ(cid:253)35(cid:238)60æ(cid:253)40)æ(cid:253)5$&)æ(cid:253)
90(cid:238);$æ(cid:253)96((cid:238)(6$æ(cid:253)96((cid:238)32:(5æ(cid:253)DQG(cid:253)Œ(cid:237)(cid:228)(cid:237)(cid:239)
5HJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)&RPSXWHU(cid:253)$VVRFLDWHV(cid:253),QWHUQDWLRQDOæ(cid:253),QF(cid:239)ª(cid:253)&$(cid:240)$&)ºæ(cid:253)&$(cid:240)’$7$&20æ(cid:253)&$(cid:240)’$7$&20(cid:238)’%æ(cid:253)&$(cid:240),’($/æ(cid:253)&$(cid:240)723(cid:253)6(&5(7æ(cid:253),’06æ(cid:253)DQG(cid:253)
526&2((cid:239)
7UDGHPDUNV(cid:253)RI(cid:253)&RPSXWHU(cid:253)$VVRFLDWHV(cid:253),QWHUQDWLRQDOæ(cid:253),QF(cid:239)ª(cid:253)&$(cid:240)0$=’$021æ(cid:253)&$(cid:240)(cid:230)æ(cid:253)DQG(cid:253)706(cid:239)
5HJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)6$6(cid:253),QVWLWXWHæ(cid:253),QF(cid:239)ª(cid:253)6$6æ(cid:253)6$6(cid:238)*5$3+æ(cid:253)DQG(cid:253)6$6(cid:238)(76(cid:239)
7UDGHPDUNV(cid:253)DQG(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)RWKHU(cid:253)FRPSDQLHVª(cid:253)$FUREDW(cid:253)DQG(cid:253)$GREH(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)DQG(cid:253)WKH(cid:253)$FRUEDW(cid:253)/RJR(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)$GREH(cid:253)6\VWHPV(cid:253)
,QFRUSRUDWHG(cid:239)(cid:253)$’$%$6(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)6RIWZDUH(cid:238)$*(cid:253)RI(cid:253)1RUWK(cid:253)$PHULFDæ(cid:253),QF(cid:239)(cid:253)$GYDQWLV(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)$GYDQWLV(cid:239)(cid:253)$%(1’(cid:240)$,’(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)&RPSXZDUHæ(cid:253),QF(cid:239)(cid:253)
’(&(cid:253)DQG(cid:253)’(&(cid:253)32/<&(17(5(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)’LJLWDO(cid:253)(TXLSPHQW(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)*(1(5(cid:238)2/(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)3DQVRSKLF(cid:253)6\VWHPVæ(cid:253),QF(cid:239)(cid:253)+3(cid:240)8;æ(cid:253)
+3(cid:253)2SHQ9LHZæ(cid:253)DQG(cid:253)+3(cid:253)2SHQ9LHZ(cid:253),7(cid:238)2SHUDWLRQV(cid:253)DUH(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)+HZOHWW(cid:240)3DFNDUG(cid:253)&RPSDQ\(cid:239)(cid:253),QVWDOO6KLHOG(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)DQG(cid:253)VHUYLFH(cid:253)PDUN(cid:253)RI(cid:253),QVWDOO6KLHOG(cid:253)
&RUSRUDWLRQ(cid:239)(cid:253)(cid:253),W(cid:253)$OO(cid:253)6WDUWV(cid:253)+HUH(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253),QVWDOO6KLHOG(cid:253)&RUSRUDWLRQ(cid:239)(cid:253).H\(cid:253)7URQLF(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253).H\(cid:253)7URQLF(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)/RWXVæ(cid:253)(cid:236)(cid:240)º(cid:240)Œæ(cid:253)/RWXV(cid:253)1RWHVæ(cid:253)
DQG(cid:253)1RWHV(cid:253)0DLO(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)DQG(cid:253)1RWHV(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)/RWXV(cid:253)’HYHORSPHQW(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)0LOOHQQLXP(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)’XQ(cid:253)(cid:247)(cid:253)%UDGVWUHHW(cid:253)
6RIWZDUH(cid:253)6HUYLFHVæ(cid:253),QF(cid:239)(cid:253)0XOWL(cid:240),PDJH(cid:253)0DQDJHU(cid:253)DQG(cid:253)1HW6S\(cid:253)DUH(cid:253)WUDGHPDUNV(cid:226)(cid:253)DQG(cid:253)73;(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)/HJHQWæ(cid:253),QF(cid:239)(cid:253)0XOWLSOH(cid:253)’RPDLQ(cid:253))DFLOLW\(cid:253)DQG(cid:253)$PGDKO(cid:253)DUH(cid:253)
WUDGHPDUNV(cid:253)RI(cid:253)$PGDKO(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)0;*(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)0HUULOO(cid:253)&RQVXOWDQWV(cid:239)(cid:253)1HW:DUH(cid:253)DQG(cid:253)1RYHOO(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)1RYHOOæ(cid:253),QF(cid:239)(cid:253)25$&/((cid:253)LV(cid:253)D(cid:253)
UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)2UDFOH(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)5RDG5XQQHU(cid:253)DQG(cid:253)0DHVWUR(cid:253)DUH(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)8QLVRQ(cid:253)6RIWZDUH(cid:239)(cid:253)6$3(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)6$3(cid:253)$*æ(cid:253)5(cid:238)Œ(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)
RI(cid:253)6$3(cid:253)$*æ(cid:253)$SSOLFDWLRQV(cid:253)DQG(cid:253)3URGXFWV(cid:253)LQ(cid:253)’DWD(cid:253)3URFHVVLQJ(cid:239)(cid:253)6RODULVæ(cid:253)6XQ26æ(cid:253)DQG(cid:253)-DYD(cid:253)DUH(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)6XQ(cid:253)0LFURV\VWHPVæ(cid:253),QF(cid:239)(cid:253)6835$(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)
&LQFRP(cid:253)6\VWHPVæ(cid:253),QF(cid:239)(cid:253)7DQGHP(cid:253)LV(cid:253)D(cid:253)WUDGHPDUN(cid:253)RI(cid:253)7DQGHP(cid:253)&RPSXWHUVæ(cid:253),QF(cid:239)(cid:253)7LYROL(cid:253)0DQDJHPHQW(cid:253)(QYLURQPHQW(cid:253)DQG(cid:253)70((cid:253)(cid:236)(cid:237)(cid:253)DUH(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)7LYROL(cid:253)6\VWHPVæ(cid:253)DQ(cid:253),%0(cid:253)
&RPSDQ\(cid:239)(cid:253)8)2(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)2Q(cid:240)/LQH(cid:253)6RIWZDUH(cid:253),QWHUQDWLRQDOæ(cid:253),QF(cid:239)(cid:253)81,;(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)LQ(cid:253)WKH(cid:253)8(cid:239)6(cid:239)(cid:253)DQG(cid:253)RWKHU(cid:253)FRXQWULHVæ(cid:253)OLFHQVHG(cid:253)H[FOXVLYHO\(cid:253)
WKURXJK(cid:253);(cid:238)2SHQ(cid:253)&RPSDQ\(cid:253)/WG(cid:239)(cid:253)86$’LUHFW(cid:253)LV(cid:253)D(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUN(cid:253)RI(cid:253)$7(cid:247)7(cid:239)(cid:253)906(&85((cid:253)DQG(cid:253)62/9(ª1HWPDVWHU(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)6WHUOLQJ(cid:253)6RIWZDUHæ(cid:253),QF(cid:239)(cid:253)
:LQGRZV(cid:253)17(cid:253)DQG(cid:253),QWHUQHW(cid:253)([SORUHU(cid:253)DUH(cid:253)WUDGHPDUNV(cid:226)(cid:253)DQG(cid:253)0LFURVRIW(cid:253)DQG(cid:253):LQGRZV(cid:253)DUH(cid:253)UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)RI(cid:253)0LFURVRIW(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)$OO(cid:253)RWKHU(cid:253)WUDGHPDUNV(cid:253)DQG(cid:253)
UHJLVWHUHG(cid:253)WUDGHPDUNV(cid:253)DUH(cid:253)WKH(cid:253)SURSHUW\(cid:253)RI(cid:253)WKHLU(cid:253)UHVSHFWLYH(cid:253)FRPSDQLHV(cid:239)
&RS\ULJKW(cid:253)(cid:139)(cid:253)(cid:236)(cid:228)(cid:228)(cid:229)æ(cid:253)&DQGOH(cid:253)&RUSRUDWLRQ(cid:239)(cid:253)$OO(cid:253)ULJKWV(cid:253)UHVHUYHG(cid:239)(cid:253),QWHUQDWLRQDO(cid:253)ULJKWV(cid:253)VHFXUHG(cid:239)
127,&(ª(cid:253)7KLV(cid:253)GRFXPHQWDWLRQ(cid:253)LV(cid:253)SURYLGHG(cid:253)ZLWK(cid:253)5(675,&7(’(cid:253)5,*+76(cid:239)(cid:253)8VHæ(cid:253)GXSOLFDWLRQæ(cid:253)RU(cid:253)GLVFORVXUH(cid:253)E\(cid:253)WKH(cid:253)*RYHUQPHQW(cid:253)LV(cid:253)VXEMHFW(cid:253)WR(cid:253)UHVWULFWLRQV(cid:253)VHW(cid:253)IRUWK(cid:253)LQ(cid:253)WKH(cid:253)
DSSOLFDEOH(cid:253)OLFHQVH(cid:253)DJUHHPHQW(cid:253)DQG(cid:238)RU(cid:253)WKH(cid:253)DSSOLFDEOH(cid:253)JRYHUQPHQW(cid:253)ULJKWV(cid:253)FODXVH(cid:239)
2 Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide
Preface
P
About this Document
This guide shows you how to use PQEdit© for MQSeries on systems running
Windows 95, Windows NT™, OS/2®, AIX®, Solaris™, HP-UX™, or OS/390 (MVS).
These instructions include:
n Starting PQEdit
n Opening a queue
n Editing in PQEdit including finding, replacing and filtering messages
n Creating a new queue
n Using PQEdit tools
n Managing queues
Installation Note:
If you are purchasing this product through IBM, in addition to the product you will
receive an Installation Guide. If you are purchasing this product via the Internet, the
installation and customization instructions are included in your Readme file.
n IBM bibliography
You may find the following IBM manuals useful when installing and configuring
MQSeries and PQEdit.
7LWOH 2UGHU(cid:253)1XPEHU
,QWHUDFWLYH(cid:253)6\VWHP(cid:253)3URGXFWLYLW\(cid:253))DFLOLW\(cid:253)8VHUV(cid:246)V(cid:253)*XLGH 6&ØŒ(cid:240)ØØ(cid:229)Ø(cid:240)(cid:237)(cid:237)
046HULHV(cid:253)$SSOLFDWLRQ(cid:253)3URJUDPPLQJ(cid:253)*XLGH 6&ŒŒ(cid:240)(cid:237)(cid:229)(cid:237)(cid:230)
046HULHV(cid:253)&OLHQWV *&ŒŒ(cid:240)(cid:236)(cid:231)Œº
046HULHV(cid:253)&RPPDQG(cid:253)5HIHUHQFH 6&ŒŒ(cid:240)(cid:236)Œ(cid:231)(cid:228)
046HULHV(cid:253)3URJUDPPLQJ(cid:253)5HIHUHQFH 6&ŒŒ(cid:240)(cid:236)(cid:231)(cid:230)Œ
Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide 3
Candle Command Center Admin Pac for MQSeries
Candle Command Center Admin Pac for MQSeries
Candle Command Center™ Admin Pac for MQSeries provides valuable functionality
for every MQSeries user. The CCC Admin Pac for MQSeries combines specially
engineered versions of Candle’s MQSeries reporting tool, CCC for MQSeries and
Candle’s MQSeries configuration tool, CCC for MQSeries Configuration, which are
bundled along with your PQEdit product.
To derive the maximum value from MQSeries implementations, users of CCC Admin
Pac for MQSeries will be able to upgrade to Candle Command Center™ Management
Pac for MQSeries which adds the following functionality:
n For CCC for MQSeries, visual programming for alerts, automation and integration
with other Candle products
n For CCC for MQSeries Configuration, a multiple user interface, prototyping
n Candle full service support and maintenance
4 Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide
Customer Support
Customer Support
n CCC Admin Pac for MQSeries Customer Support
The Candle Command Center™ Admin Pac for MQSeries product does not include
Candle Electronic Customer Support® (CECSSM), telephone support, or
maintenance upgrades. However, you can obtain answers to frequently asked
questions (FAQ) about the CCC Admin Pac for MQSeries from the Candle Web site at
http://www.candle.com/mq/admin_pac/faq
n CCC Management Pac for MQSeries Customer Support
If you choose to upgrade to the Candle Command Center™ Management Pac for
MQSeries product, Candle provides electronic support and telephone support to
assist you when you have questions about Candle products. In these cases, customer
support is available 24 hours a day, seven days a week.
See the Candle Command Center Admin Pac for MQSeries Installation Guide for
more information on upgrading to CCC Management Pac for MQSeries.
Preface 5
Documentation Set
Documentation Set
n Introduction
Candle provides a complete set of documentation for Candle Command Center®
Admin Pac for MQSeries. Each manual in this documentation set contains a specific
type of information to help you use the product.
Table 1. Documentation Set
Document
Number Title Description
Z251-5412-0 Candle Command Contains installation and
(cid:138)
Center Admin Pac for configuration instructions for
MQSeries Installation Candle Command
(cid:138)
Guide Center Admin Pac for
MQSeries on all supported
platforms.
Z254-5434-0 Candle Command Describes how to set up
®
Center Admin Pac for session connections for
MQSeries User’s Guide monitoring, how to us the
Admin Pac icons to create
reports, and how to use the
configuration interface to
manage your MQSeries
configuration.
Candle welcomes your comments and suggestions for changes or additions to the
documentation set. A user comment form, located at the back of each manual,
provides simple instructions for communicating with the Candle Information
Development department.
6 Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide
Documentation Conventions
Documentation Conventions
n Introduction
Candle documentation adheres to accepted typographical conventions for command
syntax. Conventions specific to Candle documentation are discussed in the following
sections.
n Conventions
The windows and figures in this document are representative. Actual product
windows may differ.
In examples of command syntax, uppercase letters are actual values (literals) that the
user types; lowercase letters are used for variables that represent data supplied by the
user.
n Platform Icons
Because PQEdit operates on both GUI platforms and under ISPF, the following
symbols are used to label platform-specific documentation:
,FRQ 3ODWIRUP
34(GLW(cid:253)YHUVLRQV(cid:253)GHVLJQDWHG(cid:253)DV(cid:253)*8,(cid:253)YHUVLRQV(cid:253)LQFOXGHª
(cid:135) 34(GLW(cid:253)IRU(cid:253)26(cid:238)º
(cid:135) 34(GLW(cid:253)IRU(cid:253):LQGRZV(cid:253)17(cid:238):LQGRZV(cid:253)(cid:228)Ł
(cid:135) 34(GLW(cid:253)IRU(cid:253)81,;(cid:253)ı$,;æ(cid:253)6RODULVæ(cid:253)+3(cid:240)8;(cid:244)(cid:239)
*8,
7KH(cid:253)34(GLW(cid:253)YHUVLRQ(cid:253)GHVLJQDWHG(cid:253)DV(cid:253)34(GLW(cid:253)IRU(cid:253)096(cid:253)UXQV(cid:253)XQGHU(cid:253)26(cid:238)Œ(cid:228)(cid:237)(cid:253)
ı096(cid:244)(cid:239)
,63)
The platform symbols are used at the beginning of the section that includes the
platform-specific text. All other sections apply to PQEdit regardless of operating
environment.
Preface 7
Documentation Conventions
8 Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide
Contents
About this Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Candle Command Center Admin Pac for MQSeries . . . . . . . . . . . . . . 4
Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Documentation Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Using PQEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
PQEdit and MQSeries Connections. . . . . . . . . . . . . . . . . . . . . . . . . . 17
Queue Window (GUI environments). . . . . . . . . . . . . . . . . . . . . . . . . 18
Queue Window (ISPF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
How Messages are Displayed Before and After Editing . . . . . . . . . . . 27
Chapter 2. Installing PQEdit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Installing PQEdit (GUI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Installing PQEdit (ISPF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Chapter 3. The FORMATS File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Formats File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Message-based Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
How PQEdit Uses FORMATS.INI . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
How to Modify FORMATS.INI (GUI). . . . . . . . . . . . . . . . . . . . . . . . . 52
How to Modify the FORMATS Dataset (ISPF). . . . . . . . . . . . . . . . . . 53
Chapter 4. Starting PQEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Starting or Connecting to a Queue Manager. . . . . . . . . . . . . . . . . . . 56
Starting PQEdit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Chapter 5. PQEdit and the MQI Client Connection . . . . . . . . . . . . . . . . . .59
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
9
MQI Clients and PQEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Using Clients with PQEdit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Setting Up Your Client Connection . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Chapter 6. Opening a Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
The File Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Open Queue Dialog Box (GUI). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Open Queue Panel (ISPF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Open Queue Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
How to Open a Queue (GUI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
How to Open a Queue (ISPF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Editing Under Syncpoint Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Chapter 7. Editing Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
The Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Cut, Copy, and Paste Commands (GUI). . . . . . . . . . . . . . . . . . . . . . 79
Insert and Delete Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Editing Options Under ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Insert (I) Line Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Replicate (R) Line Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
GO (G) Line Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Delete (D) Line Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Zoom (Z) Line Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Chapter 8. Editing Messages in Hexadecimal. . . . . . . . . . . . . . . . . . . . . . .95
Field in Hex and Message in Hex Commands (GUI) . . . . . . . . . . . . . 96
HexEdit (H) Line Command (ISPF) . . . . . . . . . . . . . . . . . . . . . . . . . 98
Chapter 9. Forwarding Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Using the Forward Command (GUI) . . . . . . . . . . . . . . . . . . . . . . . . 102
Forward (F) Line Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Using the Forward Command with Dead-letter Queues. . . . . . . . . . 106
Chapter 10. Finding and Changing Messages. . . . . . . . . . . . . . . . . . . . . . .109
Finding Message Data (GUI). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Replacing Message Data (GUI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Finding Message Data (ISPF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
10 Candle Command Center Admin Pac for MQSeries PQEdit User’s Guide