7 129 1 WEB_MAP Parameters

You are here:

7.129.1 WEB_MAP Parameters

FOR

The FOR parameter may have one of the following values:

*INPUT	Incoming data
*OUTPUT	Outgoing data
*BOTH	Both incoming and outgoing data
*NONE	Neither incoming nor outgoing data, used to declare session state.

If an attribute is not specified, a default of *INPUT is assumed.

When a FOR(*NONE) declaration is used, the declared fields and lists will not be mapped in or out of WEBROUTINEs. If OPTIONS(*PERSIST) is specified with FOR(*NONE), the values of the fields and lists so declared will be maintained as part of session data. Declaring fields and lists this way at the WAM level (that is, after BEGIN_COM) will make the values of those fields and lists available for all WEBROUTINEs in the WAM and will be maintained as part of session data (that is, spanning multiple WEBROUTINE executions).

FIELDS

Specifies the names of the field(s) or names of the lists which are used in the WEB_MAP.

All fields nominated in this parameter can be defined in the LANSA Repository or via a DEFINE FIELD command in the WAM.

Fields may have the following attributes assigned to them:

*INPUT – a field, which accepts input (i.e. an input box for HTML Technology Service)

*OUTPUT – a field, which displays output only

*HIDDEN – a field, which contains a value, but is hidden on display

*PRIVATE – a value for this field or list is available, but XSL generator does not generate it into the XSL Stylesheet. This is useful for fields or lists, which are used for purposes other than to be directly displayed or accept input. For example, a list that contains entries for a dropdown box can be used by the dropdown weblet. However, a browse list table for it will not be generated if it is marked with this attribute.

*INLINE – Generate the list using inline parsing instead of XSLT. Not required if the WAM default has been set to INLINE with the INLINE parameter of BEGIN_COM.

*NOINLINE – Generate the list using XSLT instead of inline parsing. Only required if the WAM default has been set to INLINE with the INLINE parameter of BEGIN_COM.

OPTIONS

The OPTIONS parameter may have the following values:

*PERSIST

Declares that fields and lists are to retain or persist data so that it is available across WEBROUTINE executions for the duration of a Web session

In addition to declaring an OPTIONS(*PERSIST), the WEBROUTINE needs to have an initial SessionStatus set to Active. This is done by, either setting it for the WAM or by setting OnEntry(*SessionStatus_Active) keyword for individual WEBROUTINE. By setting SessionStatus to Active, in this way, ensures that the WEBROUTINE will load the session state before it starts execution.