********************************************************
** NAME: n3sgus **
** DESCRIPTION: USA Service Group definition **
** LAST MOD DATE: **
** LEVEL: Comprehensive **
********************************************************
SERVICE-GROUP-DEFINITION
ALLOW-DEBUG
NAME=N3SGUS
* ******
SCHEME-DEFINITIONS=N3MAUS
PASSING-WORKAREA-SIZE
*

The Service Group definition defines the name of and some controlling options for the Service Group. There is only one such definition in a Service Group definition file. This section describes the keywords used to define the Service Group.

SERVICE-GROUP-DEFINITION

The file starts with definitions that relate to the entire Service Group. The first line identifies the file.

ALLOW-DEBUG

If you intend using the Debug Service it must be enabled at this level. This is done with the

ALLOW-DEBUG

directive. If this is not present the DEBUG Service cannot be accessed by your application.

NAME=

This directive names the Service Group, for example,

NAME=N3SGUS

defines

N3SGUS

as the name that you will use in any subsequent

CALL

statement, such as,

CALL ’N3SGUS’ USING ...

It is recommended that the name is the same as the file/member name of the definition file.

SCHEME-DEFINITIONS=

The name of the Matching Scheme definition file to be used, for example:

SCHEME-DEFINITIONS=N3MAUS

specifies that this Service Group uses the Matching Scheme Definition file

N3MAUS

. If you are not using the Matching Service you still require the directive, however, it has no argument,

SCHEME-DEFINITIONS=
PASSING-WORKAREA-SIZE

Informs the SSA-NAME3 Services that the explicit size of the Work-area is to be passed by the Calling program. This is to prevent unwanted memory overruns when the Work-area passed is not large enough. Instead of a memory overrun, an SSA-NAME3 response code will be returned. For more information on the Work-area size value and how to pass it, refer to the

Introduction/Calling a Service

section of the

APPLICATION REFERENCE FOR SSA-NAME3 SERVICE GROUPS

guide.