Message Queue 使用者管理員公用程式 (imqusermgr) 可讓您編輯或寫入平面檔案使用者儲存庫。本節介紹使用者管理員公用程式。後續各節介紹如何使用 imqusermgr 子指令完成特定的工作。
如需 imqusermgr 指令的完整參考資訊,請參閱第 13 章, 指令行參照。
操作使用者管理員之前,請注意以下事項:
如果代理程式專用的使用者儲存庫不存在,您必須啟動對應的代理程式實例來建立儲存庫。
必須在安裝代理程式的主機上執行 imqusermgr 指令。
您必須擁有寫入儲存庫的適當權限:也就是說,在 Solaris 和 Linux 上,您必須是超級使用者或是第一個建立代理程式實例的使用者。
以下各節中的範例均假設為預設的代理程式實例。
imqusermgr 指令有子指令 add、delete、list 和 update。
add 子指令可以將使用者和相關密碼增加到指定的 (或預設的) 代理程式實例儲存庫,並可選擇性指定使用者的群組。子指令語法如下:
add [-i instanceName] -u userName -p passwd [-g group] [ -s]
delete 子指令可以從指定的 (或預設的) 代理程式實例儲存庫刪除指定的使用者。子指令語法如下:
delete [-i instanceName] -u userName [ -s] [-f]
list 子指令可以顯示有關指定的 (或預設的) 代理程式實例儲存庫中,指定的使用者或所有使用者的資訊。子指令語法如下:
list [ -i instanceName] [-u userName]
update 子指令可以更新指定的 (或預設的) 代理程式實例儲存庫中,指定使用者的密碼和 (或) 狀態。子指令語法如下:
update [ -i instanceName] -u userName -p passwd [ -a state] [-s] [ -f]
update [-i instanceName] -u userName -a state [-p passwd] [-s] [-f]
表 7–2 列出了 imqusermgr 指令的選項。
表 7–2 imqusermgr 選項
選項 |
說明 |
---|---|
-a activeState |
指定使用者的狀態是否應為使用中 (true/false)。值 true 表示狀態為使用中。這是預設值。 |
-f |
未經使用者確認即執行動作。 |
-h |
顯示用法說明。不執行指令行上的其他任何指令。 |
-i instanceName |
指定要套用指令的代理程式實例名稱。如果未指定,則使用預設實例名稱 imqbroker。 |
-p passwd |
指定使用者密碼。 |
-g group |
指定使用者群組。有效值為 admin、user 和 anonymous。 |
-s |
設定無訊息模式。 |
-u userName |
指定使用者名稱。 |
-v |
顯示版本資訊。不執行指令行上的其他任何指令。 |