The Retrieve Receiver Range command

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.

Download the zip file containing the source code.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s