GET_USER_TOKEN_VALUE

유효 기간

추출 및 복제

설명

GET_USER_TOKEN_VALUE 함수를 사용하여 추적 레코드에서 사용자 토큰의 값을 가져옵니다. 토큰 값에 대해 문자 집합 변환이 수행되지 않습니다.

구문

#include "usrdecs.h"

버퍼

typedef struct
{
char *token_name;
char *token_value;
long max_length;
long actual_length;
short value_truncated;
} token_value_def;

입력

<token_name>

토큰 이름을 나타내는 버퍼에 대한 포인터입니다. 토큰 이름이 토큰이 구성된 Extract TABLE 문을 호스트하는 운영 체제의 기본 문자 집합으로 인코딩된다고 가정합니다. User Exit은 SET_SESSION_CHARSET로 지정된 문자 집합에서 토큰 이름을 준비하지만 일치하는 토큰 값을 검색하기 전에 해당 토큰 이름을 운영 체제 문자 집합으로 다시 변환합니다.

<max_length>

결과 토큰 값을 수락하기 위해 할당된 token_name 버퍼의 최대 길이입니다. NULL 종료된 문자열로 반환됩니다.

출력

<token_value>

토큰의 반환 값(있는 경우)을 나타내는 버퍼 포인터입니다. 토큰 값은 문자 집합 변환 없이 User Exit as-is로 다시 전달됩니다.

<actual_length>

반환되는 토큰 값의 실제 길이입니다. 토큰이 발견되고 값이 없는 경우 0 값이 반환됩니다.

<value_truncated>

토큰 값이 잘렸는지 여부를 나타내는 0 또는 1 플래그입니다. 테이블 이름과 널 종료자의 길이가 최대 버퍼 길이를 초과하는 경우 잘립니다.

반환 값

EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_TOKEN_NOT_FOUND
EXIT_FN_RET_OK