Sends data to a buffer for retrieval by the receive command
send [ bundle
bundleName] [ append ] data
- Optionally names the buffer, or bundle, in which to store the send data, where
bundleNamecan be a string constant or variable. Bundle names can be up to 31 characters long. By using names, you can maintain additional bundles of send data in memory. The number of available bundles (including the unnamed bundle) defaults to ten, but can be changed by setting the
max_bundlesproperty. For example, this command sends data to named bundle
empData:send BUNDLE "empData" DATA empno, dept, status
If an existing bundle is already named
bundleName, Panther frees the existing bundle and replaces it with the new one. If the named bundle exceeds the number of allowable bundles, Panther removes the oldest bundle from memory.
If no name is supplied, Panther stores the data in an unnamed bundle–that is, a bundle whose name is an empty string. Panther uses the unnamed bundle for receive calls that specify no bundle name.
- Optionally appends the send data to the specified or unnamed bundle.
- Specifies the data to send from this screen, where
dataExprcan be a constant, JPL variable, or field expression. Refer to "Object Specification" in Application Development Guide for more information about valid field expressions. You can specify multiple data arguments delimited by commas.
dataExpris a non-subscripted array, send writes all its occurrences. You can specify a single occurrence or range of occurrences within an array by subscripting it with this format:array[
intExprevaluates to an integer. If you omit the last occurrence specifier, send writes all occurrences from the one specified to the end of the array. The following examples show different subscripts that are valid:send DATA @widget("empno") //get only occurrence 1
send DATA empno[1..10] //get occurrences 1-10
send DATA empno[ct..] //get all occurrences from ct to end
sendcommand writes screen data to a buffer that is accessible through the receive command.
sendcan send one or more values from fields and array occurrences on a screen. It can also send constant values and JPL variables, as well as parts of arrays or the current occurrence of an array.
Panther writes the send data to a temporary buffer, or bundle, which you can optionally name. Panther by default maintains up to ten named and unnamed bundles; the number of available bundles can be changed by setting the
max_bundlesproperty. If you omit a bundle name, Panther writes the data to an unnamed bundle; this data is accessed by the next
receivecommand that omits the
bundleNameargument or specifies it as the empty string.
The bundle retains no information about its data sources.
receivegets data in the order as it was sent. For example, the following
sendstatement sends to an unnamed bundle the value in
credit_acctno, the value
1000, and all values in occurrences of the array
receivecommand receives this data in the same order:send DATA credit_acctno, 1000, credit
receive DATA acctno, amount, references