COLLECTDATA

The COLLECTDATA statement is used to retrieve data passed from the PASSDATA clause of an EXECUTE statement.

COMMAND SYNTAX

COLLECTDATA variable

SYNTAX ELEMENTS

variable is the name of the variable which is to store the retrieved data.

NOTES

The COLLECTDATA statement can be used in any program which is EXECUTEd (or PERFORMed) by another program where the calling program uses a PASSDATA clause. The EXECUTEd program uses a COLLECTDATA statement to retrieve the passed data.

If a PASSDATA clause is not in effect, variable will be assigned a value of null.

EXAMPLE

FIRST
001 EXECUTE "RUN JBC_PROGS SECOND" PASSDATA "Handover"

SECOND
001 COLLECTDATA PassedMessage
002 CRT PassedMessage

In the above example, program FIRST will EXECUTE program SECOND and will pass the string "Handover" in the PASSDATA clause. Program SECOND retrieves the string to a variable PassedMessage and prints the string on the Terminal screen.

jBC