dmpmqmsg (佇列載入及卸載)

用途

從 IBM MQ 8.0開始，先前在 IBM MQ Supportpac MO03中隨附的 qload 公用程式已整合至 IBM MQ 作為 dmpmqmsg 公用程式。

在 AIX® and Linux® 平台上，此公用程式可在 <installdir>./bin 中使用

在 Windows 平台上，此公用程式在 <installdir>./bin64 中可作為伺服器檔案集的一部分使用。

如需相關資訊，請參閱 使用 dmpmqmsg 公用程式。

選用參數

-m QueueManager名稱

存在一或多個佇列的佇列管理程式名稱。

-i 或 -I 輸入佇列名稱

輸入佇列的名稱。

附註: 使用 -i 會瀏覽佇列，而使用 -I 會從佇列取得訊息。

-f 或 -F 檔名

指定來源或目標檔名稱。

附註：

• 在目標檔上使用 -F 會強制輸出至檔案 (如果已存在的話)。 程式不會詢問您是否應該改寫檔案。
• 請小心確保在輸出檔上設定適當的存取控制，因為不允許存取佇列上訊息的使用者可能有權讀取輸出檔。

  在 AIX and Linux上，當執行公用程式時，會根據現行 umask 來設定新檔案的許可權。

  在 Windows上，新檔案的許可權繼承自上層目錄 ACL。

-o 輸出佇列名稱

指定輸出佇列的名稱。

-a

透過將下列其中一個值新增至關鍵字，控制以附加或二進位模式開啟檔案:

a

附加模式

b

二進位模式

-c

以用戶端模式連接。

如果您沒有選取這個旗標，公用程式會以本端模式執行，這是預設值。

在 z/OS®上無法使用此選項。

-P

控制是否轉換從佇列取得的訊息。

使用指令

-P CCSID [ : X 'Encoding' ]

例如 -P850:111

-C

控制環境定義選項，方法是將下列其中一個值新增至關鍵字:

A

設定所有環境定義。 這是預設值。

I

設定身分環境定義。

a

傳遞所有環境定義。

p

傳遞身分環境定義。

如果在佇列上瀏覽來源訊息，則使用 pass 選項不適用。

d

預設環境定義。

n

沒有環境定義。

-d

透過將下列一或多個值新增至關鍵字，控制一或多個顯示選項。 例如 -dsCM:

a

將 ASCII 直欄新增至檔案中的十六進位輸出，以協助可讀性。

A

盡可能寫入 ASCII 資料行。

在 EBCDIC 平台上，資料改為以 EBCDIC 撰寫。

c

以字元輸出 ApplicationOrigin資料 及 ApplicationIdentity資料

C

在佇列摘要中顯示 相關性 ID 。

H

請勿寫入檔案標頭。

程式無法載入以這個選項建立的檔案，因為程式無法辨識檔案格式。 不過，必要的話，您可以使用編輯器來手動新增適當的標頭，使檔案可載入。

i

在輸出中包含訊息索引。

p

可列印字元輸出格式。

此格式不是安全的字碼頁。 以新字碼頁執行時載入以這種格式撰寫的檔案，並不保證會產生相同的訊息。

s

撰寫在輸入上找到的訊息簡式摘要。

M

在佇列摘要中顯示 訊息 ID 。

N

請勿寫出訊息描述子內容，只寫出訊息有效負載。

t

文字行輸出格式。

此格式不是安全的字碼頁。 以新字碼頁執行時載入以這種格式撰寫的檔案，並不保證會產生相同的訊息。

T

顯示訊息已在佇列上的時間。

週 Length

設定輸出的資料寬度。

-D

在將訊息寫入輸出目的地之前，將下列其中一個值新增至關鍵字，以新增延遲 (以毫秒表示)。 例如：

-Dpositive_value

在放置訊息之前新增固定延遲。 例如， -D500 會將每則訊息相隔半秒。

-Dnegative_value

在放置訊息之前新增隨機延遲，直到指定的值為止。 例如， -D-10000 會在放置訊息之前新增最多 10 秒的隨機延遲。

r值

以訊息原始放置速度的百分比來重播訊息。 例如：

r

以原始速度重播訊息。

r50

以原始速度的一半來重播訊息。

r200

以原始速度兩倍的速度重播訊息。

-g

透過將下列其中一個值新增至關鍵字，依「訊息 ID」、「相關性 ID」或「群組 ID」過濾。

cvalue

依字元相關性 ID 取得。

m值

依字元訊息 ID 取得。

gvalue

依字元群組 ID 取得。

xcvalue

依十六進位相關性 ID 取得。

xmvalue

依十六進位訊息 ID 取得。

xgvalue

依十六進位群組 ID 取得。

-h

刪除標頭。

在寫入訊息之前，會從訊息中移除任何「無法傳送的郵件佇列」標頭 (MQDLH) 或「傳輸佇列」標頭 (MQXQH)。

-o

輸出佇列名稱。

-p

當訊息複製到目標目的地時，會清除來源佇列。

-q

設定無聲模式。 設定時，程式不會輸出其一般活動摘要。

-r

附註: 如果 dmpmqmsg 指令在 -r 選項設為 0的情況下執行，則不論該目的地是檔案或佇列，該指令都會將所有訊息複製到目的地。

將下列其中一個值新增至關鍵字，以設定適用的訊息範圍。

x

僅限訊息 x，例如 -r10。 如果 r 是 0，則會將所有訊息複製到目的地。

x..y

從訊息 x 到訊息 y。 例如，-r 10..20。 -r0..9 會將 1 到 9 則訊息複製到目的地。

x#y

輸出 y messages starting at message x。 例如，-r 100#10。 ,-r0#4 會將一到四則訊息複製到目的地。

#x

輸出前 x 則訊息，例如 -r #100。 -r \#0 會將所有訊息複製到目的地。

-t

設定交易訊息限制。 如果未設定選用 n 旗標，則會在單一交易中完成所有訊息。

n

訊息作業會分割成 n 個訊息群組。 例如， -t1000 在單一交易中處理 1000 則訊息。

-T

容許根據訊息經歷時間來選取訊息。

如需使用訊息經歷時間進行選取的相關資訊，請參閱 使用訊息經歷時間 。

-s 或 -e

容許根據訊息內容來選取訊息。

在 ASCII 平台 (AIX, Linux, and Windows) 上，使用 -s 選項來搜尋原生編碼字串。

在 EBCDIC 平台 (z/OS) 上，請使用 -e 選項來搜尋原生編碼的字串。

如需使用訊息內容進行選取的相關資訊，請參閱 使用訊息內容 。

-u

如果您使用 -u 參數來提供使用者 ID ，則系統會提示您輸入相符的密碼。

如果您已使用 CHCKLOCL (REQUIRED) 或 CHCKLOCL (REQDADM) 配置 CONNAUTH AUTHINFO 記錄，則必須使用 -u 參數，否則將無法複製或移動佇列內容。

如果您指定此參數並重新導向 stdin ，則不會顯示提示，且重新導向輸入的第一行應該包含密碼。

-w

耗用訊息的等待間隔 (以秒為單位)。 如果已指定，則在結束之前，程式會在指定的期間內等待訊息到達。