説明
GET_CATALOG_NAME_ONLY
ファンクションでは、処理中のレコードに関連付けられているソースまたはターゲット・オブジェクトの、所有者(スキーマなど)やオブジェクトの名前ではなく、SQL/MXカタログまたはOracle CDBコンテナの名前を取得します。このファンクションは、DMLおよびDDL操作に有効です。
表の完全修飾表名を返すには、次を参照してください。
表以外のオブジェクト(ユーザー、ビュー、索引など)の完全修飾表名を返すには、次を参照してください。
表またはオブジェクトの修飾されていない名前のみを返すには、次を参照してください。
表またはオブジェクト名のその他の部分を返すには、次を参照してください。
データベース・オブジェクト名は、大/小文字の区別を含め、ホストしているデータベースで定義されているとおりに、正確に返されます。
構文
#include "usrdecs.h" short result_code; env_value_def env_value; ERCALLBACK (GET_CATALOG_NAME_ONLY, &env_value, &result_code);
バッファ
typedef struct { char *buffer; long max_length; long actual_length; short value_truncated; short index; short source_or_target; } env_value_def;
入力
buffer
返されたカタログ名を受け付けるバッファへのポインタ。名前はNULLで終了します。
ユーザー・イグジットの文字セッションが、SET_SESSION_CHARSET
を使用して、オペレーティング・システムのデフォルトのキャラクタ・セット以外の値に設定されている場合、ucharset.h
ファイルのULIB_CS_DEFAULT
で定義されているように、カタログ名はセッションのキャラクタ・セットで解釈されます。
max_length
名前を受け付けるために割り当てたバッファの最大長。NULL
終了文字列として返されます。
source_or_target
ソースまたはターゲット表のどちらのカタログを返すかを示す次の一方。
EXIT_FN_SOURCE_VAL EXIT_FN_TARGET_VAL