7.68.1 GROUP_MAP Parameters

DESC

FOR

GROUP

HELP

PARAMETER_NAME

FOR

The FOR parameter may have one of the following values:

*INPUT

The GROUP specified will receive values

*OUTPUT

The values of the specified GROUP will be passed to the caller

*BOTH

The GROUP will receive a value and will return a value at the end of the routine

 

GROUP_MAPs defined as OUTPUT or BOTH will be forwarded to the subsequent webpage if the SRVROUTINE has a Response of *WebPage.

GROUP

Specifies the names of the GROUP_BY used in the GROUP_MAP.

When the SRVROUTINE is executed it is not necessary to use the same GROUP_BY name or definition in both the caller and the SRVROUTINE. GROUP_MAPs use name matching to move the data between the caller and the SRVROUTINE. Provided the fields are in the GROUP_BY and are compatible, the data will be passed.

Fields not specified in both will remain unaffected.

DESC

Use the DESC parameter to write a brief description for the SRVROUTINE. It can be 40 characters long. By default, this description will be displayed in the Feature Help (F2) for the routine.

HELP

256 byte string used to document the routine.

PARAMETER_NAME

PAREMETER_NAME allows for a more meaningful name to be provided for the parameter.

Rather than being limited to the name of the variable being used in the map, PARAMETER_NAME is used to make the parameter more readable when used. This is particularly useful for older systems where short field names and internal variables names are may not be overly user friendly.