Previous Page | Next Page

The DQSCHEME Procedure

APPLY Statement


Applies a scheme to transform the values of a single variable.
See also: Applying Schemes

APPLY LOCALE=<locale-name>
MATCHDEF=<match-definition>
MODE=PHRASE|ELEMENT
SCHEME=<scheme-name>
SCHEME_LOOKUP=EXACT|IGNORE_CASE |USE_MATCHDEF
SENSITIVITY=<sensitivity-level>
VAR=<variable-name>;

Options

LOCALE=locale-name

specifies the name of the match definition, in the specified locales, that is used to create match codes running the application of the scheme.

MATCH-DEFINITION=match-definition

specifies the name of the match definition, in the specified locales, that is used to create match codes running the application of the scheme.

MODE=ELEMENT | PHRASE

specifies a mode of scheme application. This information is stored in the scheme as metadata, which specifies a default mode when the scheme is applied. The default mode is superseded by a mode in the APPLY statement, or in the DQSCHEMEAPPLY function or CALL routine. See Applying Schemes.

ELEMENT

specifies that each element in each value of the input character variable is compared to the data values in the scheme. When SCHEME_LOOKUP=USE_MATCHDEF, the match code for each element is compared to match codes generated for each element, in each DATA variable value in the scheme.

PHRASE

this default value specifies that the entirety of each value of the input character variable is compared to the data values in the scheme. When SCHEME_LOOKUP=USE_MATCHDEF, the match code for the entire input value is compared to match codes that are generated for each data value in the scheme.

SCHEME=scheme-name

identifies the scheme to apply to the input data set. In all the operating environments other than z/OS, schemes using BFD format are identified by specifying a fileref or a fully qualified name that ends in .sch.bfd

SCHEME_LOOKUP=EXACT | IGNORE_CASE | USE_MATCHDEF

specifies the method of applying the scheme to the data values of the input variable.

SENSITIVITY=sensitivity-level

defines the amount of information in the resulting match codes.

VAR=variable-name

specifies the name of the variable that is analyzed and transformed.

Previous Page | Next Page | Top of Page