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

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

目的

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

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

Syntax

Read syntax diagramSkip visual syntax diagram dspmqver   -a   -p components  -f fields-b-v-i

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

-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 1 Windows Communication Foundation 用の [Windows] IBM MQ カスタム・チャネル
32 [Windows] IBM Message Service Client for .NET (XMS .NET)-このコンポーネントは、 Windows でのみ使用可能です。
64 GSKit

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

128 Advanced Message Security
256 IBM MQ AMQP サービス
512 IBM MQ Telemetry サービス
1024 IBM MQ によって使用されるその他のバンドル・コンポーネント
[V9.1.0 2018 年 7 月]2048 [V9.1.0 2018 年 7 月]WebSphere® Liberty プロファイル
[V9.1.0 2018 年 7 月]4096 [V9.1.0 2018 年 7 月]IBM MQ Java ランタイム環境
[V9.1.0 2018 年 7 月]8192 [V9.1.0 2018 年 7 月]IBM MQ 複製データ・キュー・マネージャー
注:
  1. [Windows]サポートしているのは 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 ライセンス・タイプ
dspmqver コマンドが実行されると、選択された各フィールドの情報が個別の行に表示されます。

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

-b
レポートからヘッダー情報を省略します。
-v
詳細出力を表示します。
-i
すべてのインストールに関する表示情報。 このオプションは、他のオプションと使用することはできません。 dspmqver コマンドの実行元となるインストールが最初に表示されます。 これ以外のインストールについては、「名前」、「バージョン」、「インストール名」、「インストールの説明」、「インストール・パス」、および「1 次インストール」のフィールドのみが表示されます。

戻りコード

表 1. 戻りコードの ID と説明
戻りコード 説明
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 MQJava Message Service Client、および IBM MQ classes for Java Message Service の共通サービスを表示します。

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

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

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

dspmqver -i
[V9.1.1 2018 年 11 月]MQ.NET Standard クラスの出力例:

Name:        IBM Message Service Client for .NET Standard
Version:     9.1.1.0
Level:       p911-LXXXX
Build Type:  Production

コマンドの失敗

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

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

[V9.1.0 2018 年 7 月] IBM MQ classes for Javaの表示中に障害が発生する

[V9.1.0 2018 年 7 月] IBM MQ classes for Javaのバージョン情報またはビルド情報を表示しようとして、ご使用の環境が正しく構成されていない場合、または IBM MQ JRE コンポーネントがインストールされていないために代替 JRE が見つからない場合、 dspmqver コマンドは失敗する可能性があります。

[V9.1.0 2018 年 7 月]例えば、次のようなメッセージが表示されることがあります。

[root@blade883 ~]# dspmqver -p 2
AMQ8351: IBM MQ Java environment has not been configured 
correctly, or the IBM MQ JRE feature has not been installed.
この問題を解決するには、 IBM MQ JRE コンポーネントがまだインストールされていない場合はそれをインストールするか、JRE を含むようにパスが構成されていること、および正しい環境変数が設定されていることを確認します。例えば、 setjmsenv または setjmsenv64を使用します。
以下に例を示します。

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

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

[UNIX] setjmsenv および setjmsenv64 コマンドは UNIX にのみ適用されることに注意してください。

[V9.1.0 2018 年 7 月][Windows] Windowsでは、 IBM MQ JRE コンポーネントがインストールされている場合、 setmqenv コマンドを発行してエラー AMQ8351を解決する必要があります。