Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Property

Description

TOROUTINE

Specify the name of a WEBROUTINE to transfer to. You can specify another WAM, in this case the WAM name followed by a WEBROUTINE name separated by a dot (e.g. #MYWAM.Browse).

A Service Name can also be specified, if prefixed with the *SERVICE modifier.

The value can also be provided from a field, if prefixed with the *EVALUATE modifier.

OnEntry

This property is used for mapping incoming fields and lists into the target WEBROUTINE. This property can be one of:

*MAP_NONE (does not map any fields or lists),

*MAP_ALL (maps all required fields and lists),

*MAP_LOCAL (only fields and lists on WEBROUTINE's WEB_MAPs are mapped),

*MAP_SHARED (only WAM level WEB_MAP fields and lists are mapped, not WEBROUTINE level).

The default value is *MAP_ALL.

 
 
When a TRANSFER is performed, the target WEBROUTINE assumes control of execution and the source WEBROUTINE does not regain control. When the target WEBROUTINE is exited, that WEBROUTINE's page is returned, as if the WEBROUTINE was invoked directly from the browser.

The following are some examples of TRANSFER statement:

TRANSFER TOROUTINE     TRANSFER TOROUTINE(Browser) 
TRANSFER TOROUTINE TRANSFER TOROUTINE(#MYWAM.Browser)
TRANSFER TOROUTINE TRANSFER TOROUTINE(*SERVICE EmployeeBrowseSERVICE EmployeeBrowse)
change #WEBRTN  change #WEBRTN 'wam1.routine1'
TRANSFER TOROUTINE TRANSFER TOROUTINE(*EVALUATE #WEBRTNEVALUATE #WEBRTN)