The data ID associated with the data set to be read. The data
ID has been generated by the LMINIT service. The maximum length of
this parameter is 8 characters.
MOVE|LOCATE|INVAR|MULTX
Whether the data is to be moved, located, or stored into an ISPF
dialog variable, and whether the data should be read in single records
(default) or in segments containing multiple records (MULTX). A calling
program function can specify any mode, with information being passed
through the data location variable. A command dialog can use INVAR
and MULTX modes, with data being returned to the command in the data
location variable.
dataloc-var
The name of the data location variable. In MOVE mode, the variable
contains a binary virtual storage address at which the data read by
LMGET is to be stored. In LOCATE mode, the address of the data read
by LMGET is placed in the data location variable. In INVAR and MULTX
modes, the data read by LMGET is itself placed in the data location
variable. The maximum length of this parameter is 8 characters.
datalen-var
The name of the variable into which LMGET stores the actual length
of the record read. In MULTX mode ISPF stores the length of data returned
in the datalen-var. The maximum length of this parameter is 8 characters.
max-length
A fullword binary integer containing the maximum record length
to be read in bytes. This parameter must be a nonzero positive integer
value. In MOVE mode, the value is the maximum number of bytes of data
to be moved. In INVAR mode, the value is the maximum number of bytes
of data to be stored in the data location variable. The value is not
changed by LMGET in either mode. In MULTX mode, the value is the maximum
number of bytes to be stored from each record read, to make up the
segment that will be stored in the data location variable. The parameter
is ignored in LOCATE mode. If
the max-length specification causes a DBCS character string to be
divided in the middle, the result may be unpredictable.
buf-len
A fullword fixed binary integer containing the length of the buffer
parameter.
buffer
A buffer containing the name of the service and its parameters
in the same form as they would appear in an ISPEXEC invocation for
a command invocation.