_gaiDLVDel() ― 配布状況ファイルの任意のレコードの削除
形式
#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVDel(int *cnt_inf,unsigned int *status,char *key_kind,char *key);
OSがHP-UX(IPF)の場合の形式を次に示します。
#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVDel(void **cnt_inf,unsigned int *status,char *key_kind,char *key);
機能
配布状況ファイルから,指定した任意のキーに該当するレコードを削除します。
プログラムで値を設定する引数
- cnt_inf
- 配布状況ファイルへのアクセスの開始関数(_gaiDLVStart())の第1引数を設定します。
- key_kind
- 削除するキーの種別を次の形式で指定します(ヘッダファイルで定義済み)。
- DMWGAI_DLV_KEY_KIND_ADR
- 配布先名をキーにして削除します。
- DMWGAI_DLV_KEY_KIND_RSC
- 完全資源名をキーにして削除します。
- DMWGAI_DLV_KEY_KIND_STS
- 配布状況のステータスで削除します。
- key
- 入力する配布状況の配布名,パッケージ名,または配布状況のステータスを次の形式で指定します。
- 入力するキーの種別がDMWGAI_DLV_KEY_KIND_ADRの場合
- ホスト名[.ホスト名.ホスト名.…ホスト名]
- 入力するキーの種別がDMWGAI_DLV_KEY_KIND_RSCの場合
- 完全資源名
- 入力するキーの種別がDMWGAI_DLV_KEY_KIND_STSの場合
- DMWGAI_DLV_KEEPING
指令ファイル受信の完了(KEEPING)
- DMWGAI_DLV_KEEP
指令保管の完了(KEEP)
- DMWGAI_DLV_KEEP_ERROR
パッケージ保管の失敗(KEEP_ERROR)
- DMWGAI_DLV_CLT_START
クライアント起動の完了(CLT_START)
- DMWGAI_DLV_CLT_START_ERROR
クライアント起動の失敗(CLT_START_ERROR)
- DMWGAI_DLV_CLT_WAIT
クライアント起動待ち(CLT_WAIT)
- DMWGAI_DLV_INS_WAIT
組み込み待ち(INS_WAIT)
- DMWGAI_DLV_GEN_START
ゼネレータの起動(GEN_START)
- DMWGAI_DLV_COMPLETE
実行完了(COMPLETE)
- DMWGAI_DLV_ERROR
実行失敗(ERROR)
- DMWGAI_DLV_SETUP_ERROR
セットアップエラー(SETUP_ERROR)
- deliv_inf
- 配布状況の受信領域のポインタを設定します。受信領域はサイズに変数名 DMWGAI_DLV_SIZE(ヘッダファイルで定義済み)を指定して確保します。
JP1/NETM/DM Clientから値が返される引数
- status
- 処理結果の詳細情報を格納するエリアを設定します。
リターン値
0:正常終了
1:配布状況サーバが起動していない
-1:異常終了
注意事項
- 配布状況ファイル内のレコードは,配布先-資源名-配布先指令番号の組み合わせで,昇順に並んでいます。
- 処理結果の詳細情報格納エリアを参照するときは,処理結果を参照する関数(_gaiDLVGetMainCode(),_gaiDLVGetSubCode())を使います。