7.87.1 LIST_MAP Parameters

DESC

FOR

HELP

LIST

PARAMETER_NAME

FOR

The FOR parameter may have one of the following values:

*INPUT

The LIST specified will be populated

*OUTPUT

The content of the specified LIST will be passed to the caller

*BOTH

The LIST will be populated and will return its content at the end of the routine

 

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

LIST

Specifies the names of the working list used in the LIST_MAP.

When the SRVROUTINE is executed it is not necessary to use the same working list or definition in both the caller and the SRVROUTINE. LIST_MAPs use name matching to move the data between the caller and the SRVROUTINE. Provided the same field is specified somewhere in both working lists, 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.