GET_USER_TOKEN_VALUE

Durée de validité

Extraction et réplication

Description

Utilisez la fonction GET_USER_TOKEN_VALUE pour obtenir la valeur d'un jeton utilisateur à partir d'un enregistrement de trace. Aucune conversion de jeu de caractères n'est effectuée sur la valeur de jeton.

Syntaxe

#include "usrdecs.h"

Tampon

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

Entrée

<token_name>

Pointeur vers un tampon représentant le nom d'un jeton. Il est supposé que le nom du jeton est codé dans le jeu de caractères par défaut du système d'exploitation qui héberge l'instruction Extract TABLE dans laquelle le jeton est configuré. L'exit utilisateur prépare le nom de jeton dans le jeu de caractères spécifié avec SET_SESSION_CHARSET, mais le convertit en jeu de caractères du système d'exploitation avant d'extraire la valeur de jeton correspondante.

<max_length>

Longueur maximale du tampon token_name alloué pour accepter toute valeur de jeton obtenue. Cette valeur est renvoyée sous la forme d'une chaîne de fin NULL.

Sortie

<token_value>

Pointeur vers un tampon représentant la valeur de retour (le cas échéant) d'un jeton. La valeur du jeton est transmise à l'exit utilisateur tel quel, sans aucune conversion de jeu de caractères.

<actual_length>

Longueur réelle de la valeur de jeton renvoyée. Une valeur de 0 est renvoyée si le jeton est trouvé et qu'aucune valeur n'est présente.

<value_truncated>

Indicateur 0 ou 1 indiquant si la valeur de jeton a été tronquée. La troncature se produit si la longueur du nom de la table plus la terminaison NULL dépasse la longueur maximale du tampon.

Valeurs retournées

EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_TOKEN_NOT_FOUND
EXIT_FN_RET_OK