7.123.1 TRANSFER Parameters
Specifies the name of the function that is to receive control. The current function ends when this command is executed and the function nominated in this parameter receives control.
*NEXT, which is the default value, indicates that the function name input from the screen should receive control next. Usually this is the function nominated in the function control table as the default next function. However, dependent upon the menu selection style and the SHOW_NEXT parameter of the DISPLAY or REQUEST commands used, it may have been changed by the user. Refer to Function Control Table for information about the function control table before attempting to use this parameter.
*LAST indicates that control should be transferred to the function that was in use immediately prior to this one.
*EXIT indicates that control should be passed out of the LANSA system to the application that invoked LANSA. Using this option is identical to using the EXIT command.
*MENU indicates that control should be passed to the process's main menu. Using this option is identical to using the MENU command.
*HELP indicates that control should be passed to the online HELP facility. Using this option is similar to using the HELP function key.
*EOJ indicates that a batch function should end. Using this option is similar to using the *EXIT option in an interactive function.
If one of the previous values is not used then the name of another function that is defined within the same process must be specified.
Specifies the name of the field(s) to be exchanged or the name of a group that defines the field(s) to be exchanged. When an expandable expression is used, the expanded field list must not exceed the maximum number of substitution variables allowed in the parameter.
Refer to Field Groups and Expandable Groups for more information of how field and group names can be specified. Refer to the 7.54 EXCHANGE command for more information about how information is exchanged between functions.
The EXCHANGE parameter on this command is provided for convenience only. Using it is identical to using one or more EXCHANGE commands before the TRANSFER command. Thus:
TRANSFER TOFUNCTION(INPUT) EXCHANGE(#A #B #C #D)
is functionally identical to:
EXCHANGE FIELDS(#A #B #C #D)
TRANSFER TOFUNCTION(INPUT)
which is functionally identical to:
EXCHANGE FIELDS(#A)
EXCHANGE FIELDS(#B)
EXCHANGE FIELDS(#C)
EXCHANGE FIELDS(#D)
TRANSFER TOFUNCTION(INPUT)
Specifies 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 (for example #MyWAM.MyWebRtn). Unlike a CALL command, after a transfer control does not return to the WEBROUTINE making the transfer.
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.
Is valid when transferring to another WEBROUTINE only. For WEBROUTINE information, refer to WEBROUTINE.
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.