Some Services accept pre-defined Function definitions as parameters when called by applications. Predefined Function definitions are defined in either the Service Group definition or the Algorithm definition, or both, depending on the Service. This section deals with those Services which can have Function definitions defined at the Service Group level. Those Services are

NAMESET

and

MATCH

.

A NAMESET Function is used by an application program to control the type of key building or search strategy returned by the NAMESET Service to the calling program. The following example shows a predefined Function definition called

BLDKEY

which uses a NAMESET Function keyword called

NOSTAB

(which specifies that no search strategy (table) should be returned):

FUNCTION-DEFINITIONS
BLDKEY:NOSTAB

An application would Call the NAMESET Service specifying a Function definition name of

BLDKEY

, and this in turn would invoke the

NOSTAB

functionality.

A MATCH Function is used by an application program to control the results that are returned by the MATCH Service to the calling program. The following example shows an additional pre-defined Function definition called

SCORE

which uses a MATCH Function keyword called

SCORE-ONLY

(which specifies that only a 3-byte Score should be returned in the Result field).

FUNCTION-DEFINITIONS
BLDKEY:NOSTAB
SCORE:SCORE-ONLY

An application would Call the MATCH Service specifying a Function definition name of

SCORE

, and this in turn would invoke the

SCORE

functionality.

Both NAMESET and MATCH Function keywords can either be passed by reference to a Function definition name defined in the Service Group definition, as shown above, or can be passed explicitly by the calling program, as shown in the

NAMESET

and

MATCH

chapters of the

APPLICATION REFERENCE FOR SSA-NAME3 SERVICE GROUPS

guide.

In the case of MATCH, Function keywords can also be defined in the Matching Scheme – these take precedence over a Function definition defined in the Service Group, or Function keywords supplied by an application. See the

Matching Scheme Definition

section.

In the case of NAMESET, the pre-defined Function Definitions can also be defined at the Algorithm level or the Service Level. When a NAMESET Function Definition name is used by the calling program, the NAMESET Service searches in a particular order, this being Service, Algorithm and finally the Service Group itself. If the requested function is not found an error is produced, otherwise NAMESET will use the first definition it finds with that name. For more information, see the

Matching Scheme Definition

section.