DQEXTTOKENPUT Function

Inserts a token into an extraction character value and returns the updated extraction character value.
Valid in: DATA step and SCL
Requirement: If specified, the locale must be loaded into memory as part of the locale list.

Syntax

DQEXTTOKENPUT ('extraction-char', 'token-value', 'token-name',
'extraction-definition' <,'locale'> )

Required Arguments

extraction-char
specifies a character constant, variable, or expression that contains the value that is the extraction character value that receives the new token value.
token-value
the value of the token that is to be inserted into extraction-char.
token-name
the name of the token. The specified token must be enabled by the extraction definition.
extraction-definition
the name of the extraction definition. The definition must exist in the locale that is used. The extraction definition must be the same definition that was used to extract the extraction-char value.

Optional Argument

locale
specifies a character constant, variable, or expression that contains the locale name.
Default:The default locale is the first locale in the locale list. If no value is specified, the default locale is used.

Details

The DQEXTTOKENPUT function enables you to insert a new value that is associated with a specified token into an extracted value. If a value exists for that token in the input value, the new value is inserted before the existing value. The existing value is retained.
You can specify a variable name for the value of extraction-char, and then assign the return value from DQEXTTOKENPUT to the same variable.