Skip to Content

MV GETDATAN

This command returns some or all of the collected view data.

Warning

Important

The IMFEXEC MV GETDATA and IMFEXEC MV GETDATAN commands cannot be used together on the same channel. If you attempt to use both commands on the same channel, you will receive a return code of 28.

Related topic

Using-the-MV-API


Command

Parameters

MV GETDATAN

[COUNT(nnnnn)]

[STEM(variableName)]

[REFRESH]

CHANNEL(channelName)

The following table describes the parameters:

Parameter

Function

Notes

COUNT

Number of rows of data to retrieve

When used, specify a numeric value between 1-65500.

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

See the information for RC 4 in Stem-variables-returned-by-IMFEXEC-MV-GETDATAN for more information about retrieving more rows of data.

STEM

Name of the REXX stem variable to hold the returned data

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

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

Warning

Important

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 BMC AMI Ops

The first request for data from a view, in a given channel, requires the REFRESH parameter

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.

This section contains the following topic: 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.3.01