Sun Java System Message Queue 3.7 UR1 管理指南

新增受管理物件

imqobjmgr 指令的 add 子指令,會將連線工廠和主題或佇列目標的受管理物件增加至物件存放區。儲存在 LDAP 物件存放區中的受管理物件必須擁有以 cn= 字首開頭的查找名稱;檔案系統物件存放區中的查找名稱則不需要有特定的字首,但是絕對不能包含斜線字元 (/)。


備註 –

物件管理員僅會列出與顯示 Message Queue 受管理物件。如果物件存放區中包含非 Message Queue 物件,而且其查找名稱與您想增加的受管理物件名稱相同,則當您嘗試執行增加作業時會出現錯誤。


新增連線工廠

若要讓用戶端應用程式能建立代理程式連線,請為要建立的連線類型增加連線工廠受管理物件:佇列連線工廠或主題連線工廠。範例 8–1 中顯示的指令,會將佇列連線工廠 (受管理物件類型 qf) 增加至 LDAP 物件存放區。物件具有查找名稱 cn=myQCF,並使用 jms 連線服務連線至連接埠號 7272 之主機 myHost 上所執行的代理程式。


範例 8–1 新增連線工廠


imqobjmgr add
   -l "cn=myQCF"
   -j "java.naming.factory.initial=com.sun.jndi.ldap.LdapCtxFactory"
   -j "java.naming.provider.url=ldap://mydomain.com:389/o=imq"
   -j "java.naming.security.principal=uid=homerSimpson,ou=People,o=imq"
   -j "java.naming.security.credentials=doh"
   -j "java.naming.security.authentication=simple"
   -t qf
   -o "imqAddressList=mq://myHost:7272/jms"

新增目標

建立代表目標的受管理物件時,最好先建立實體目標,再將受管理物件增加至物件存放區中。使用指令公用程式 (imqcmd ) 建立實體目標,如建立實體目標中所述。

範例 8–2 中顯示的指令,會將受管理物件增加至代表主題目標之 LDAP 物件存放區,且該目標的查找名稱為 myTopic,實體目標名稱為 physTopic增加佇列目標的指令很類似,不同之處在於受管理物件類型 (-t 選項) 為 q (表示「佇列目標」),而非 t (表示「主題目標」)。


範例 8–2 將目標新增至 LDAP 物件存放區


imqobjmgr add
   -l "cn=myTopic"
   -j "java.naming.factory.initial=com.sun.jndi.ldap.LdapCtxFactory"
   -j "java.naming.provider.url=ldap://mydomain.com:389/o=imq"
   -j "java.naming.security.principal=uid=homerSimpson,ou=People,o=imq"
   -j "java.naming.security.credentials=doh"
   -j "java.naming.security.authentication=simple"
   -t t
   -o "imqDestinationName=physTopic"

範例 8–3 中顯示相同的指令,但是受管理物件存放區在 Solaris 檔案系統中,而不是在 LDAP 伺服器中。


範例 8–3 將目標新增至檔案系統物件存放區


imqobjmgr add
   -l "cn=myTopic"
   -j "java.naming.factory.initial=
           com.sun.jndi.fscontext.RefFSContextFactory"
   -j "java.naming.provider.url=file:///home/foo/imq_admin_objects"
   -t t
   -o "imqDestinationName=physTopic"