Service Group Application Reference

Back Next

The EXTRACT= Call

If the

VERBOSE

function keyword is used on a Call to the

MATCH

service to match two records, the results of that

MATCH

Call are returned in the Result parameter field as a series of

label=value

entries. For example,

SCORE=080,RULING=A*

A result value (in the above example the result values are 080 and A), can be extracted from the Result field by performing an extra Call to the

MATCH

service and specifying the

EXTRACT=label

function.

For a list of the available labels, see the

MATCH Function Descriptions

section.

For example, to extract the "ruling" value into a field on its own, the function keyword to use is,

*EXTRACT=RULING*

When

EXTRACT=

is used as a

MATCH

function keyword, the

MATCH

parameters take on a different meaning than for the standard

MATCH

Call.

The parameters are,

No.	Name	Size (bytes)	Filled in by
1	Service name	8	Application
2	Response code	20	MATCH
3	Function	32	Application
4	Dummy	1	Not accessed
5	Extra Result	1000	MATCH
6	Verbose result	Verbose result from a previous MATCH CALL	Application
7	Dummy	1	Not accessed
8	Dummy	1	Not accessed
9	Work-area	100,000 (minimum)	MATCH

SERVICE-NAME (8 bytes): As described in the parameter list for the standard
MATCH
Call.

RESPONSE-CODE (20 bytes): As described in the parameter list for the standard
MATCH
Call.

FUNCTION (32 bytes): The Function parameter is used to control what result value is extracted from a verbose Result field. It is of the form
EXTRACT=label
.

EXTRACT RESULT (1000 bytes): The value of the extracted result. For example, if the
VERBOSE RESULT
parameter contained,
SCORE=080,RULING=A*
and the
FUNCTION
parameter contained,
*EXTRACT=RULING*
then after the Call, this parameter will contain the value A.

VERBOSE RESULT (1000 bytes): This is the Result parameter from the previous
MATCH
Call. For example,
SCORE=080,RULING=A*

WORK-AREA (30,000 bytes): As described in the parameter list for the standard
MATCH
Call.
The
DUMMY
parameters must be provided in this Call.