HARDWARE_RESOURCE_INFO 表関数
HARDWARE_RESOURCE_INFO 表関数は、構成済みのハードウェア・リソースに関する情報を戻します。
返される情報は、STRSSTハードウェア・サービス・マネージャ・インターフェースや、ハードウェア・リソース・リストの取得（QGYRHRL、QgyRtvHdwRscList）、ハードウェア・リソース情報の取得（QGYRHRI、QgyRtvHdwRscInfo）APIから取得できる詳細情報と同様です。
権限: 不要です。
- リソース・カテゴリー
- 戻されるリソース情報のカテゴリーを識別する文字ストリング式またはグラフィック・ストリング式。
- ADAPTER
- 結合されたシステム・アダプター・リソース
- ALL
- すべてのリソース・カテゴリーの情報
- COMM
- 通信リソース
- 暗号
- 暗号リソース
- 光ディスク
- 光ディスク資源
- プロセッサー
- プロセッサー・リソース
- STORAGE
- ストレージ・デバイス・リソース (テープ・リソースおよび光ディスク・リソースを含む)
- テープ
- テープ・リソース
- WORKSTATION
- ローカル・ワークステーション・リソース
- 詳細情報
- 返す情報のタイプを識別する文字ストリング式またはグラフィック・ストリング式。
- NO
- リソースの基本情報のみが返されます。 これは、SERIAL_NUMBER 列の前の列の情報です。 これはデフォルト値。
- YES
- リソースに使用可能なすべての情報が返されます。
- 無視エラー
- エラーの発生時に実行する内容を識別する文字ストリング式またはグラフィック・ストリング式。
- NO
エラーが戻されます。
- YES
- 警告が戻されます。
この関数の結果は、以下の表に示された形式の複数行を含むテーブルです。 列はすべて NULL 可能です。
| 列名 | データ・タイプ | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ID | INTEGER | 結果セット内のこの行に対して生成された固有 ID。 | ||||||||||||||||
| 親 ID | INTEGER | このリソースに対する親の ID。 このリソースが別のリソースの子でない場合は、NULL 値が入ります。 |
||||||||||||||||
| リソース・カテゴリー | VARCHAR(11) | 情報が戻されるリソースのハードウェア・リソース・カテゴリー。
|
||||||||||||||||
| RESOURCE_NAME | VARCHAR(10) | 資源の名前。 | ||||||||||||||||
| 状況 | VARCHAR(12) | リソースが操作可能かどうか。
STATUS がこのリソースに適用されない場合、または判別できない場合は、NULL 値が入ります。 |
||||||||||||||||
| EXTENDED_STATUS | VARCHAR(14) | リソースの拡張ハードウェア状況です。
STATUS がこのリソースに適用されない場合、または判別できない場合は、NULL 値が入ります。 |
||||||||||||||||
| DEVICE_TYPE | VARCHAR(4) | このリソースのオブジェクト・タイプを表す ID。 自己構成磁気テープ装置の場合、これはエミュレートされた装置タイプ番号を表します。 値 *TAP は, 自己構成テープ装置が 0 から 9 および A から Z の範囲外の文字を含む装置タイプをエミュレートしていることを示します。 値が使用できない場合は、NULL 値が入ります。 |
||||||||||||||||
| DEVICE_MODEL | VARCHAR(3) | リソースの型式番号です。 自己構成磁気テープ装置の場合、これはエミュレートされた装置の型式番号を表します。 値が使用できない場合は、NULL 値が入ります。 |
||||||||||||||||
| ADAPTER_SYSTEM | VARCHAR(8) | 結合システム・アダプターが接続されているシステム。 値が使用できない場合は、NULL 値が入ります。 |
||||||||||||||||
| LAN アダプター・アドレス (LAN_ADAPTER_ADDRESS) | VARCHAR(12) | LAN アダプター・リソースのネットワーク・アドレス。 値が使用できない場合は、NULL 値が入ります。 |
||||||||||||||||
| LINE_TYPE | VARCHAR(5) | LAN 資源の回線タイプです。
リソースに回線タイプがない場合は、NULL 値が入ります。 |
||||||||||||||||
| TEXT_DESCRIPTION | VARCHAR(50) | リソースの説明。 記述テキストがない場合は、NULL 値が入ります。 |
||||||||||||||||
| MESSAGE_ID | CHAR(7) | TEXT_DESCRIPTION の取得元となるメッセージ。 このメッセージは *LIBL の QCPFMSG メッセージ・ファイルにあります。 記述テキストがない場合は、NULL 値が入ります。 |
||||||||||||||||
| リソースの種類 | 2 進数 (24) | リソース種類フィールドは、24 バイトの 16 進数で構成されます。 これは、Kind 1、Kind 2、および Kind 3 という 3 つの 8 バイト・フィールドに分割できます。 システムは、Kind 1、Kind 2、および Kind 3 を使用してリソースを分類します。 | ||||||||||||||||
| RESOURCE_KIND1 | BINARY(8) | 種類 1 の値です。 | ||||||||||||||||
| RESOURCE_KIND2 | BINARY(8) | 種類 2 の値です。 | ||||||||||||||||
| RESOURCE_KIND3 | BINARY(8) | 種類 3 の値です。 | ||||||||||||||||
| DETAILED_INFO が YES の場合、以下の列に対して NULL 以外の値が返される可能性があります | ||||||||||||||||||
| SERIAL_NUMBER | VARCHAR(15) | リソースの製造シーケンスに基づく、拡張された固有番号。 | ||||||||||||||||
| シリアル番号 (SERIAL_NUMBER_SHORT) | VARCHAR(10) | リソースの製造順序に基づく固有番号。 | ||||||||||||||||
| PART_NUMBER (パラメーター番号) | VARCHAR(12) | 類似タイプのハードウェアを表す製造 ID。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| BUS_NUMBER | INTEGER | システム・プロセッサーのカードへのパス接続を表す数値。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| ボード番号 | INTEGER | カードが差し込まれているバスのセクションを表す数値。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| CARD_NUMBER (カード番号) | INTEGER | バス上のカードの位置を表す数値。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| カードの位置 | VARCHAR(5) | デバイスまたは機能がバスに接続されている物理的位置。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| FRAME_ID | VARCHAR(4) | フレーム・リソースの ID 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| LOCATION_CODE | VARCHAR (79) 型 | システム内のハードウェア・リソースの物理的位置。 ロケーション・コード・フィールドは、0 個以上のロケーション・ラベルのシーケンスです。このシーケンスに従うと、リソース・ロケーションにつながります。 これは
，担当者がハードウェアの部品を検討，除去，または取り替えるために出向くことがで
きる場所です。 位置ラベルは，ハードウェア上にエッチング，シルク・スクリーン，またはその他の方法でマークされています。 以下のロケーション・ラベルが、ロケーション・コード・フィールドに表示される場合があります (n は数値またはアルファベット順の ID を表します)。
|
||||||||||||||||
| LOCATION_CODE (続き) | 位置ラベルの説明は以下の通りです。
この列は、システムがロケーション・コード形式をサポートし、リソースに値が適用される場合にのみ使用可能です。それ以外の場合は、NULL 値が戻されます。 |
|||||||||||||||||
| 入出力バス・アドレス | INTEGER | リソースの入出力バス・アドレス。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| アダプター・アドレス | INTEGER | リソースのアダプター・アドレス。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| DEVICE_ADDRESS (装置アドレス) | INTEGER | リソースのデバイス・アドレス。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| デバイスの位置 | VARCHAR(5) | リソースの相対的デバイス位置。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| コントローラー・アドレス | INTEGER | リソースのコントローラー・アドレス。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
system_processor_
feature_code |
CHAR(4) | システムのプロセッサー機構コード・レベル。 この列に値が戻されるのは、ハードウェア・リソースの RESOURCE_KIND3 値が、リソースがシステム情報 (X'0000000000080000 ') を提供することを示している場合のみです。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| プロセス・フィーチャー・コード | CHAR(4) | プロセッサー・フィーチャー。これは、システムのプロセッサー・キャパシティーに対応します。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| 相互アクティブ・フィーチャー・コード | CHAR(4) | システムの対話式機能。 この機能は，対話式処理を実行するために使用できるプロセッサーの一部を定義します。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| 共有 SESSION_NUMBER | INTEGER | リソースの共有セッション番号。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| PORT_NUMBER | INTEGER | リソースのポート番号。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| LAN SPEED (LAN 速度) | VARCHAR(12) | 通信ポートの LAN 速度。
列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| リンク集約 | VARCHAR(3) | 集約リンクを構成するためにポートを集約できるかどうか。
列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
| デフォルト・アドレス (DEFAULT_MAC_ADDRESS) | 2 進数 (6) | LAN ポートのデフォルトの MAC アドレス。 列がリソースに適用されない場合は、NULL 値が入ります。 |
||||||||||||||||
例
- テープ・リソースに関する完全な情報を返します。
SELECT * FROM TABLE (QSYS2.HARDWARE_RESOURCE_INFO(RESOURCE_CATEGORY => 'TAPE', DETAILED_INFO => 'YES'));
