5.35.5 NEXT

The NEXT command reads the next streaming event.

Each event will return a status code to identify the type of event received.

When all events have been received a status code of NONEXT is returned to identify the end of the stream.

All events do not need to be read before closing the stream reader.

Element attribute names and values can be accessed by using a two-field working list argument. The working list is cleared, and attributes are added when an ELEMENTSTART event is received.

Possible status and message values

Status

Message

NONEXT

 

ELEMENTSTART

Qualified element name.
For example: {http://www.cars.com/xml}part

ELEMENTEND

Qualified element name.
For example: {http://www.cars.com/xml}part

COMMENT

Comment text.

INSTRUCTION

Processing Instruction.

 

Syntax:

Command

Keyword

Value

Developer notes

NEXT

COMMENT

*YES

Optional. Include comment events.

*NO

Default.

INSTRUCTION

*YES

Optional. Include processing instruction events.

*NO

Default.

 

Example

NEXT