Parameters

name-list
Specifies an area containing the names of dialog variables to be copied. The standard name-list format is used.
length-array
Specifies an array of fullword fields containing the lengths of the data areas for the dialog variable values. The array can consist of a single item. In move mode, each element of the array is set by the caller to the output area size. In move or locate mode, each element of the array is set by the service to the number of bytes of data for the corresponding variable. The length does not include trailing blanks unless the variable is defined to maintain blanks. For example:
  • VCOPYing a variable that was defined using VDEFINE with the NOBSCAN option
  • VCOPYing a REXX variable that was explicitly set with trailing blanks and then VPUT to the SHARED or PROFILE pool.
value-array
In locate mode, specifies the name of an array that contains pointers to fields into which the copied variables are placed. The array can consist of a single item. In move mode, specifies the name of a structure that is mapped by the length array.
LOCATE
Specifies locate mode. The address of the copied value is returned to the user invoking the service. This is the default mode.
MOVE
Specifies move mode. The copied value is returned to the user invoking the service.