GET_ENV_VALUE

Valido per

Estrai e Replicat

Descrizione

Utilizzare la funzione GET_ENV_VALUE per restituire informazioni sull'ambiente Oracle GoldenGate. Le informazioni fornite sono le stesse della funzione di conversione colonna @GETENV e vengono specificate utilizzando gli stessi valori di input. Per ulteriori informazioni sui tipi di informazioni validi, sulle variabili di ambiente e sui valori restituiti, vedere "@GETENV".

Se la sessione dei caratteri dell'uscita utente è impostata con SET_SESSION_CHARSET su un valore diverso dal set di caratteri predefinito del sistema operativo, come definito in ULIB_CS_DEFAULT nel file ucharset.h, i dati dei caratteri scambiati tra l'uscita utente e il processo vengono interpretati nel set di caratteri della sessione.

Sintassi

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

Buffer

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;

Input

<information_type>

Tipo di informazioni da restituire, ad esempio 'GGENVIRONMENT' o 'GGHEADER'. Il tipo di informazioni deve essere fornito tra virgolette doppie. Per un elenco dei tipi di informazioni e delle descrizioni dettagliate successive, vedere "@GETENV".

<env_value_name>

Il valore dell'ambiente desiderato dal tipo di informazioni. Il valore dell'ambiente deve essere fornito tra virgolette doppie. Per informazioni sui valori validi, vedere "@GETENV". Ad esempio, se si utilizza il tipo di informazioni 'GGENVIRONMENT', il valore di ambiente valido sarà 'GROUPNAME'.

<max_return_length>

La lunghezza massima del buffer per questi dati.

Output

<return_value>

Valore restituito valido per il valore di ambiente fornito.

<actual_length>

La lunghezza effettiva dei dati in questo buffer.

<value_truncated>

Flag (0 o 1) per indicare se il valore è stato troncato o meno. La troncatura si verifica se la lunghezza del valore più il terminatore nullo supera la lunghezza massima del buffer.

Valori restituiti

EXIT_FN_RET_OK
EXIT_FN_RET_ENV_NOT_FOUND
EXIT_FN_RET_INVALID_PARAM