.. highlightlang:: us

.. _aop_getvalval:

aop_getvalval
=============

.. index:: aop_getvalval

.. us.tag  aop_getvalval NOTREADYENGLISH New500 asam3

:ref:`aop_getvalval` returns the values of a measurement (AoSubMatrix).

.. function::  valValSeq = aop_getvalval(envId, elemId, pmatId, mPntBase, mPntCnt, nuSeq, cl)

.. us.return

**Return Value**

*valValSeq* is an object of the following form:

::

   valValSeq.n
   valValSeq[1].pmatId
   valValSeq[1].mPntBase
   valValSeq[1].mPntCnt
   valValSeq[1].vvSeq.n
   valValSeq[1].vvSeq[1].name
   valValSeq[1].vvSeq[1].qtyId
   valValSeq[1].vvSeq[1].unitId
   valValSeq[1].vvSeq[1].indepFl
   valValSeq[1].vvSeq[1].implFl
   valValSeq[1].vvSeq[1].valMap.dtyp
   valValSeq[1].vvSeq[1].valMap.val
   valValSeq[1].vvSeq[1].valFlags

In case of an error an error object is returned (see :ref:`error_create`).

.. us.params

**Parameters**

.. uparam:: envId

   *envId* is the environment Id, returned by :ref:`aop_openenv`.

.. uparam:: elemId

   *elemId* is a vector with two elements (AOP_ElemId). The first element the 
   "Application Element ID" (aid) and the second element is the instance id (iid). 

.. uparam:: pmatId

   *pmatId* is the submatrix id.

.. uparam:: mPntBase

   *mPntBase* is the index of the start position.

.. uparam:: mPntCnt

   *mPntCnt* is the number of records.

.. uparam:: nuSeq

   *nuSeq*.

.. uparam:: cl

   *cl* is the client pointer, returned by :ref:`rpc_clnt_create`.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.0.0
     - New

.. seealso::
   :ref:`overview-asam-ods`

:sub:`id-21583`