The Retrieve Receiver Range (RTVRCVRNG) command returns the qualified journal receiver name and journal entry sequence number associated with the specified journal and the date and time specified for the beginning and ending date and time, respectively.
A date and time does not uniquely identify a specific journal entry sequence number. The journal entry sequence number returned therefore is the first one found for the date and time provided. As a consequence this command should be used to identify a range of journal entries to be selected for processing by other journal commands, rather than controlling the continued processing of
sequential journal entries.
Journal commands lock all the journal receivers specified or implied on the journal command until the command ends. To avoid locking journal receivers unnecessarily and speed up processing, you can use this command to narrow the journal receiver selection precisely to the date and time interval specified, and then use the returned journal receiver and journal entry sequence number range as input to the journal command.
Using a date and time interval is also useful to handle duplicate journal entry sequence numbers, in the event that a journal entry sequence number reset occurs in the receiver chain associated with the specified journal.
The Retrieve Receiver Range (RTVRCVRNG) command is created from the following sources:
SEC106 RPGLE Retrieve Receiver Range SEC106H PNLGRP Retrieve Receiver Range - Help SEC106M CLP Retrieve Receiver Range - Build command SEC106T CLP Retrieve Receiver Range - Test SEC106V RPGLE Retrieve Receiver Range - VCP SEC106X CMD Retrieve Receiver Range
All details about the command and its function are included in the command help text. The SEC106T CL program allows you to test the RTVRCVRNG command and send its output to your user message queue.