MV GETDATAN

MainView | MV GETDATAN

[COUNT(nnnnn)]

[STEM(variable_name)]

[REFRESH]

CHANNEL(channelname)

COUNT

number of rows of data to retrieve

(optional ) When used, specify a numeric value between 1-99999.

If you do not specify a value, the default is 500.

STEM

name of the REXX stem variable to hold the returned data

(optional) When used, specify a value from 1 to 31 alphanumeric characters. If you do not specify a value, the default is MV.

Refer to Stem-variables-returned-by-IMFEXEC-MV-GETDATAN for more information about how this keyword's value is used.

Note: If only one set of data is retrieved and used at a time, there is no requirement to adjust this value. However, if multiple sets of data from different views need to be referenced simultaneously, use this keyword to uniquely name each set of returned data.

REFRESH

specifies that new view data will be retrieved from MainView

first request for data from a view in a given channel requires REFRESH

In addition:

• Always specify REFRESH on the first call to a particular channel.
• When using the COUNT keyword and the count has been exceeded, do not specify REFRESH on subsequent GETDATAN commands. When you receive a return code of 0, all of the lines have been retrieved.
• When you want a new result set to be obtained (which you always want to unless you are in the situation above), specify REFRESH.

CHANNEL

token that identifies a previously connected channel

1- to 32-characters alphanumeric

This value is the token returned in the CHANNEL variable supplied on the IMFEXEC MV CONNECT command.