Retrieve next name-value pair in an HTML form.

WEB READNEXT FORMFIELD
>>-WEB--READNEXT--FORMFIELD(data-area)--NAMELENGTH(data-area)--->
>--VALUE(data-area)--VALUELENGTH(data-area)--------------------><
Conditions: ENDFILE, INVREQ, LENGERR
This command is threadsafe.
Description
WEB READNEXT FORMFIELD retrieves the
next name-value pair in an HTML form.
The data is returned in its unescaped
form (see the CICS
Internet Guide for an explanation of this).
Options
- FORMFIELD(data-area)
- specifies
the buffer to contain the name of the form field being retrieved. The case
of the name is as it is stored in the form.
- NAMELENGTH(data-area)
- specifies
the length, as a fullword binary value, of the form field name. If the length
of the form field value is less than the size of the buffer, the form field
value is placed in the leftmost byte positions.
- VALUE(data-area)
- specifies
the buffer to contain the value corresponding to the name returned in the
FORMFIELD data area. CICS® unescapes any escaped characters before placing
them in the buffer.
- VALUELENGTH(data-area)
- specifies
the length, as a fullword binary value, of the buffer that is to contain the
form field value. If the value exceeds the buffer length, it is truncated.
If the length of the form field value is less than the size of the buffer,
the form field value is placed in the leftmost byte positions.
Conditions
- ENDFILE
- The
end of the list of name-value pairs has been reached.
- INVREQ
- RESP2
values are:
- 1
- The command is being issued in a non-CICS Web support application.
- 3
- The command is being issued for a non-HTTP request.
- 4
- The command is being issued before a WEB STARTBROWSE FORMFIELD has been
issued.
- 6
- A form field has been found that is not in the format NAME:VALUE.
- LENGERR
- RESP2
values are:
- 1
- NAMELENGTH or VALUELENGTH is less than or equal to zero.
- 4
- The form field name has been truncated during a browse operation because
the receiving buffer is too small.
- 5
- The form field value has been truncated because the receiving buffer is
too small.