WEB READNEXT QUERYPARM
Retrieve next name and value pair in query string data in a URL.
Description
WEB READNEXT QUERYPARM retrieves the next keyword parameter (name and value pair) in a query string in a URL.
The data is returned in its unescaped form (see Reserved and excluded characters for an explanation of this).
Options
- QUERYPARM(data-area)
- Specifies the buffer to contain the name of the keyword parameter being retrieved. The case of the name is as it is stored in the keyword parameter.
- NAMELENGTH(data-area)
- Specifies the length, as a fullword binary value, of the keyword parameter name. The actual length of the name is returned in this data area. If the length of the keyword parameter name is less than the size of the buffer, the keyword parameter name is placed in the leftmost byte positions.
- VALUE(data-area)
- Specifies the buffer to contain the value corresponding to the name returned in the QUERYPARM 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 keyword parameter value. The actual length of the value is returned in this data area. If the value exceeds the buffer length, it is truncated. If the length of the keyword parameter value is less than the size of the buffer, the keyword parameter value is placed in the leftmost byte positions.
Conditions
- 20 ENDFILE
- The end of the list of keyword parameters has been reached.
- 16 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 has been issued.
- 6
- A keyword parameter has been found which is not in the format NAME=VALUE.
- 22 LENGERR
- RESP2 values are:
- 1
- NAMELENGTH or VALUELENGTH is less than or equal to zero.
- 4
- The keyword parameter name has been truncated during a browse operation because the receiving buffer is too small.
- 5
- The keyword parameter value has been truncated because the receiving buffer is too small.