Skip to Content
Information
Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

MV GETDATAN

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

Warning

Note

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.

Command

Parameters

MainView | 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

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 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: 

Related topic

Using-the-MV-API

 

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

BMC AMI Ops Automation 8.3