dspmqver (バージョン情報の表示)

IBM® MQ のバージョンおよびビルド情報を表示します。

目的

dspmqver コマンドを使用して、 IBM MQ のバージョン情報およびビルド情報を表示します。

デフォルトでは、 dspmqver コマンドは、呼び出されたインストールの詳細を表示します。他のインストールが存在する場合はノートが表示されます。-i パラメーターを使ってその詳細を表示します。

Syntax

オプション・パラメーター

-a

すべてのフィールドおよびコンポーネントの表示情報。

32 ビット・サポートが 64 ビット・システムから欠落している場合、 dspmqver -a コマンドは、32 ビット・バージョンの IBM Global Security Kit (GSKit) がインストールされていないことを示すメッセージを発行することがあります。詳しくは、このトピックの『コマンドの失敗』セクションを参照してください。

-p コンポーネント

component に指定されたコンポーネントの情報を表示します。コンポーネントは、単独でも複数でも指定できます。シングル・コンポーネントの値、またはすべての必須コンポーネントの値の合計のいずれかを入力します。使用可能なコンポーネントと関連する値は、以下のとおりです。

値	説明
1	IBM MQ サーバーまたはクライアント。
2	IBM MQ classes for Java.
4	IBM MQ classes for Java Message Service.
8	WebScale Distribution Hub
16 ¹	IBM MQ custom channel for Windows Communication Foundation
32	IBM Message Service Client for .NET (XMS .NET) - このコンポーネントは Windows でのみ使用可能です。
64	GSKit 、または HP Integrity NonStop Serverの場合は SSL 32 ビット・サポートが 64 ビット・システムから欠落している場合、 dspmqver -p 64 コマンドは、32 ビット・バージョンの GSKit がインストールされていないことを示すメッセージを発行することがあります。詳しくは、このトピックの『コマンドの失敗』セクションを参照してください。
128	IBM MQ Advanced Message Security
256	IBM MQ AMQP サービス
512	IBM MQ Telemetry サービス

注:

IBM MQ for Windows でのみサポートされます。 Microsoft.NET 3 以降をインストールしていない場合は、以下のエラー・メッセージが表示されます。
Title: WMQWCFCustomChannelLevel.exe - Application Error
The application failed to initialize properly (0x0000135).

デフォルト値は 1 です。

-f フィールド

field に指定されたフィールドの情報を表示します。シングル・フィールドまたは複数フィールドのいずれかを指定します。シングル・フィールドの値、またはすべての必須フィールドの値の合計のいずれかを入力します。使用可能なフィールドと関連する値は以下のとおりです。

値	説明
1	名前
2	`V.R.M.F`の形式のバージョン: ここで、 `V` = バージョン、 `R` = リリース、 `M` = モディフィケーション、および `F` = フィックスパック
4	レベル
8	ビルド・タイプ
16	プラットフォーム
32	アドレッシング・モード
64	オペレーティング・システム
128	インストール・パス
256¹	インストールの説明
512¹	インストール環境の名前
1024¹	最大コマンド・レベル
2048¹	プライマリー・インストール
4096	データ・パス
8192	ライセンス・タイプ

注:

HP Integrity NonStop Serverには適用されません。

dspmqver コマンドが実行されると、選択された各フィールドの情報が個別の行に表示されます。

デフォルト値は 8191 です。これにより、すべてのフィールドの情報が表示されます。

-b

レポートからヘッダー情報を省略します。

-v

詳細出力を表示します。

-i

すべてのインストールに関する表示情報。このオプションは、他のオプションと使用することはできません。 dspmqver コマンドの実行元となるインストールが最初に表示されます。これ以外のインストールについては、「名前」、「バージョン」、「インストール名」、「インストールの説明」、「インストール・パス」、および「1 次インストール」のフィールドのみが表示されます。 HP Integrity NonStop Serverには適用されません。

戻りコード

戻りコード	説明
0	コマンドは正常に終了しました。
10	コマンドは終了しましたが、予期しない結果が出ました。
20	処理中にエラーが発生しました。

例

以下のコマンドは、 -p および -fのデフォルト設定を使用して、 IBM MQ のバージョンおよびビルド情報を表示します。


dspmqver

次のコマンドは、すべてのフィールドとコンポーネントに関する情報を表示します。これは、 dspmqver -p 63 -f 4095を指定するのと同等です。


dspmqver -a

以下のコマンドは、 IBM MQ classes for Javaのバージョンおよびビルド情報を表示します。


dspmqver -p 2

次のコマンドは、Java Platform Standard Edition、IBM MQ、Java Message Service Client、および IBM MQ classes for Java Message Service の共通サービスを表示します。


dspmqver -p 4

次のコマンドを実行すると、WebScale Distribution Hub のビルド・レベルが表示されます。


dspmqver -p 8 -f 4

以下のコマンドは、 Windows Communication Foundation 用の IBM MQ カスタム・チャネルの名前とビルド・タイプを表示します。


dspmqver -p 16 -f 9

以下のコマンドは、 IBM MQのインストールに関する情報を表示します。


dspmqver -i

コマンドの失敗

64 ビット・システムから 32 ビット・サポートが欠落しているときの障害

IBM MQ バージョン 8.0、 9.0 、および 9.1では、32 ビット・バージョンと 64 ビット・バージョンの IBM Global Security Kit (GSKit) が一緒にバンドルされています。 dspmqver -a または dspmqver -p 64を実行すると、このコマンドは両方のバージョンの GSKitを検査します。 64 ビット・システムで 32 ビット・サポートが欠落している場合、32 ビット・バージョンの GSKit がインストールされていないことを示すメッセージが表示されることがあります。デフォルトで 32 ビット・アプリケーションをサポートしなくなった可能性がある 64 ビット Linux® ディストリビューションについて、およびこれらのプラットフォーム用の 32 ビット・ライブラリーを手動でロードするためのガイダンスについては、 UNIX および Linux システムでのハードウェア要件とソフトウェア要件を参照してください。

IBM MQ classes for Javaの表示中に障害が発生する

IBM MQ classes for Javaのバージョン情報またはビルド情報を表示しようとして、環境が正しく構成されていない場合、 dspmqver コマンドが失敗することがあります。例えば、次のようなメッセージが表示されることがあります。


[root@blade883 ~]# dspmqver -p2
AMQ8351: IBM MQ Java environment has not been configured correctly.

この問題を解決するには、JRE を組み込むようにパスが構成されていることと、正しい環境変数が設定されている (例えば、setjmsenv または setjmsenv64 を使用) ことを確認します。以下に例を示します。


export PATH=$PATH:/opt/mqm/java/jre/bin
cd /opt/mqm/java/bin/
. ./setjmsenv64

[root@blade883 bin]# dspmqver -p2
Name:       WebSphere MQ classes for Java
Version:    8.0.0.0
Level:      k000-L110908
Build Type: Production

[UNIX] setjmsenv コマンドおよび setjmsenv64 コマンドは、 UNIX プラットフォームにのみ適用されることに注意してください。

[Windows] Windows では、 setmqenv コマンドを発行してエラー AMQ8351を解決する必要があります。