GET_ENV_VALUE

유효 기간

추출 및 복제

설명

GET_ENV_VALUE 함수를 사용하여 Oracle GoldenGate 환경에 대한 정보를 반환합니다. 제공되는 정보는 @GETENV 열 변환 함수의 정보와 동일하며 동일한 입력 값을 사용하여 지정됩니다. 유효한 정보 유형, 환경 변수 및 반환 값에 대한 자세한 내용은 "@GETENV"을 참조하십시오.

User Exit의 문자 세션이 SET_SESSION_CHARSET로 운영 체제의 기본 문자 집합이 아닌 다른 값으로 설정되면(ucharset.h 파일의 ULIB_CS_DEFAULT에 정의됨) User Exit과 프로세스 간에 교환되는 문자 데이터가 세션 문자 집합에서 해석됩니다.

구문

#include "usrdecs.h"
short result_code;
getenv_value_def env_ptr;
ERCALLBACK (GET_ENV_VALUE, &env_ptr, &result_code);

버퍼

typedef struct
{
char *information_type;
char *env_value_name;
char *return_value;
long max_return_length;
long actual_length;
short value_truncated;
} getenv_value_def;

입력

<information_type>

반환될 정보 유형(예: 'GGENVIRONMENT' 또는 'GGHEADER')입니다. 정보 유형은 큰 따옴표로 묶어야 합니다. 정보 유형 목록 및 후속 세부 설명은 "@GETENV"을 참조하십시오.

<env_value_name>

정보 유형에서 원하는 환경 값입니다. 환경 값은 큰 따옴표로 묶어야 합니다. 적합한 값은 "@GETENV"를 참조하십시오. 예를 들어, 'GGENVIRONMENT의 정보 유형을 사용하는 경우 적합한 환경 값은 'GROUPNAME입니다.

<max_return_length>

이 데이터 버퍼의 최대 길이입니다.

출력

<return_value>

제공된 환경 값에 대해 적합한 반환 값입니다.

<actual_length>

이 버퍼의 실제 데이터 길이입니다.

<value_truncated>

값이 잘렸는지 여부를 나타내는 플래그(0 또는 1)입니다. 값의 길이에 널 종료자를 더한 값이 최대 버퍼 길이를 초과하는 경우 잘립니다.

반환 값

EXIT_FN_RET_OK
EXIT_FN_RET_ENV_NOT_FOUND
EXIT_FN_RET_INVALID_PARAM