*VLEN

*VLEN, NROW, NINC
Specifies the number of rows to be used in array parameter operations.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Argument Descriptions

NROW

Number of rows to be used with the *VXX or *MXX operations. Defaults to the number of rows needed to fill the result array.

NINC

Perform the operation on every NINC row (defaults to 1).

Command Default

Fill all locations of the result array from the specified starting location.

Notes

Specifies the number of rows to be used in array parameter operations. The size of the submatrix used is determined from the upper left starting array element (defined on the operation command) to the lower right array element (defined by the number of rows on this command and the number of columns on the *VCOL command). NINC allows skipping row operations for some operation commands. Skipped rows are included in the row count. The starting row number must be defined on the operation command for each parameter read and for the result written.

The default NROW is calculated from the maximum number of rows of the result array (the *DIM row dimension) minus the starting location + 1. For example, *DIM,R,,10 and a starting location of R(7) gives a default of 4 loops (filling R(7), R(8), R(9), and R(10)). Repeat operations automatically terminate at the last row of the result array. Existing values in the rows and columns of the results matrix remain unchanged where not overwritten by the requested input or operation values.

The stride (NINC) allows operations to be performed at regular intervals. It has no effect on the total number of row operations. Skipped operations retain the previous result. For example, *DIM,R,,6, with a starting location of R(1), NROW = 10, and NINC = 2 calculates values for locations R(1), R(3), and R(5) and retains values for locations R(2), R(4), and R(6). A more general skip control may be done by masking (*VMASK). The row control settings are reset to the defaults after each *VXX or *MXX operation. Use *VSTAT to list settings.

This command is valid in any processor.

Menu Paths

Utility Menu>Parameters>Array Operations>Operation Settings