On IXGBRWSE REQUEST=READCURSOR requests, more than one log block
may be returned to the requestor. Logger may encounter different conditions
for different log blocks.
The following return and reason codes may be issued to indicate
the particular condition:
- IXGBRWSE MODE=SYNCECB or MODE=SYNCEXIT requests that are processed
asynchronously will result in a return code of X'04' and a
reason code of X'401', and will be handled in the same manner
as MULTIBLOCK=NO requests.
- When an IXGBRWSE request results in a return code of X'0' with
a reason code of X'0', then the return and reason codes are
always 0 for each IXGBMRLT for the log blocks, and data is always
returned.
- When an IXGBRWSE request results in a return code of X'04' with
a reason code of X'416', data is always returned. Any combination
of return code X'04' and reason code X'4xx' or return
code X'00' and reason code X'000' may be returned
in the output buffer area.
- If a return code of X'04' with a reason code of X'417' is
returned, then only the last IXGBMRLT has a return code of X'08'.
There may be an earlier log record with an IXGBMRLT return code X'04' and
reason code X'4xx'.
- It is possible to have some log records read back and then get
an IXGBRMLT return and reason code that requires a wait for an ENF
48 event. The IXGBRWSE return code would be X'04' with a reason
code of X'417', and the last IXGBRMLT would contain the ENF
48 condition (8/8xx).
- When the browse request reaches the end of log after moving some
data into the buffer, the last IXGBRMLT will have a return code of X'08' with
a reason code of X'848' and IXGBRWSE will have a return code
of X'04' with a reason code of X'417'. If another
IXGBRWSE is issued and there are still no more log records to read, the
IXGBRWSE service will have a return code of X'08' with a reason
code of X'848'. The buffer area is undefined for this return/reason
code, so you cannot trust its contents.