.*-----------------------------------------------------------------------**
.*
.*  Compile options:
.*
.*    CrtPnlGrp PnlGrp( SEC106H )
.*              SrcFile( QPNLSRC )
.*              SrcMbr( *PNLGRP )
.*
.*-----------------------------------------------------------------------**
:PNLGRP.

:HELP NAME='RTVRCVRNG'.
Retrieve Receiver Range - Help
:P.
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.
:P.
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 consequense
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.
:P.
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.
:P.
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.
:P.
:HP2.Restrictions::EHP2.
:UL.
:LI.
You must have *OBJOPR and some data authority other than *EXECUTE
for the specified journal to run this command.
:EUL.
:EHELP.

:HELP NAME='RTVRCVRNG/JRN'.
Journal (JRN) - Help

:XH3.Journal (JRN)
:P.
Specifies the journal from which the journal entry information is
retrieved.
:P.
This is a required parameter.
:P.
:HP2.Qualifier 1: Journal:EHP2.
:PARML.
:PT.:PV.name:EPV.
:PD.
Specify the name of the journal.
:EPARML.
:P.
:HP2.Qualifier 2: Library:EHP2.
:PARML.
:PT.:PK DEF.*LIBL:EPK.
:PD.
All libraries in the library list for the current thread are
searched until the first match is found.
:PT.:PK.*CURLIB:EPK.
:PD.
The current library for the job is searched.  If no library is
specified as the current library for the job, QGPL is used.
:PT.:PV.name:EPV.
:PD.
Specify the name of the library to be searched.
:EPARML.
:EHELP.

:HELP NAME='RTVRCVRNG/BEGIN'.
Journal receiver beginning (BEGIN) - Help

:XH3.Journal receiver beginning (BEGIN)
:P.
Specifies the date and time used to locate the journal receiver
and journal entry sequence number to be returned as the
starting point for a journal entry retrieval process.
:P.
:HP2.Single values:EHP2.
:PARML.
:PT.:PK DEF.*AVAIL:EPK.
:PD.
The first journal receiver in the current receiver chain is selected
and the first journal entry sequence number in that receiver is
returned.
:EPARML.
:P.
:HP2.Element 1: Date:EHP2.
:PARML.
:PT.:PK.*CURRENT:EPK.
:PD.
The current date is used to identify the starting point.
:PT.:PV.date:EPV.
:PD.
Specify the date to be used as starting point.
:EPARML.
:P.
:HP2.Element 2: Time:EHP2.
:PARML.
:PT.:PK.*BEGIN:EPK.
:PD.
The beginning of the specified date is used as starting point.
:PT.:PK DEF.*CURRENT:EPK.
:PD.
The current time is used as starting point.
:PT.:PV.time:EPV.
:PD.
Specify the time to be used as starting point.
:EPARML.
:EHELP.

:HELP NAME='RTVRCVRNG/END'.
Journal receiver ending (END) - Help

:XH3.Journal receiver ending (END)
:P.
Specifies the date and time used to locate the journal receiver
and journal entry sequence number to be returned as the
ending point for a journal entry retrieval process.
:P.
:HP2.Single values:EHP2.
:PARML.
:PT.:PK DEF.*AVAIL:EPK.
:PD.
The current journal receiver in the current receiver chain is selected
and the last journal entry sequence number in that receiver is
returned.
:EPARML.
:P.
:HP2.Element 1: Date:EHP2.
:PARML.
:PT.:PK.*CURRENT:EPK.
:PD.
The current date is used to identify the ending point.
:PT.:PV.date:EPV.
:PD.
Specify the date to be used as ending point.
:EPARML.
:P.
:HP2.Element 2: Time:EHP2.
:PARML.
:PT.:PK.*END:EPK.
:PD.
The end of the specified date is used as ending point.
:PT.:PK DEF.*CURRENT:EPK.
:PD.
The current date is used to identify the ending point.
:PT.:PV.time:EPV.
:PD.
Specify the time to be used as ending point.
:EPARML.
:EHELP.

:HELP NAME='RTVRCVRNG/BEGRCV'.
CL var for BEGRCV       (10) (BEGRCV) - Help

:XH3.CL var for BEGRCV       (10) (BEGRCV)
:P.
Specifies the name of the program CL character variable into which the
journal receiver name from which the returned beginning journal entry
was retrieved is copied.
:P.
The specified variable must be a character variable with a minimum
length of 10 characters.
:P.
If the length of the variable is longer than 10 characters, it is
padded on the right with blanks.
:EHELP.

:HELP NAME='RTVRCVRNG/BEGRCVLIB'.
CL var for BEGRCVLIB    (10) (BEGRCVLIB) - Help

:XH3.CL var for BEGRCVLIB    (10) (BEGRCVLIB)
:P.
Specifies the name of the program CL character variable into which the
name of the library containing the receiver of the retrieved beginning
journal entry is copied.
:P.
The specified variable must be a character variable with a minimum
length of 10 characters.
:P.
If the length of the variable is longer than 10 characters, it is
padded on the right with blanks.
:EHELP.

:HELP NAME='RTVRCVRNG/BEGSEQNBR'.
CL var for BEGSEQNBR    (20) (BEGSEQNBR) - Help

:XH3.CL var for BEGSEQNBR    (20) (BEGSEQNBR)
:P.
Specifies the name of the program CL character variable into which the
journal entry sequence number of the retrieved beginning journal entry
is copied.
:P.
The specified variable must be a character variable that has a length
of twenty positions.
:P.
If the retrieved sequence number is shorter than the length of the
field, the number is left adjusted and padded on the right with blanks.
:EHELP.

:HELP NAME='RTVRCVRNG/ENDRCV'.
CL var for ENDRCV       (10) (ENDRCV) - Help

:XH3.CL var for ENDRCV       (10) (ENDRCV)
:P.
Specifies the name of the program CL character variable into which the
journal receiver name from which the returned ending journal entry was
retrieved is copied.
:P.
The specified variable must be a character variable with a minimum
length of 10 characters.
:P.
If the length of the variable is longer than 10 characters, it is
padded on the right with blanks.
:EHELP.

:HELP NAME='RTVRCVRNG/ENDRCVLIB'.
CL var for ENDRCVLIB    (10) (ENDRCVLIB) - Help

:XH3.CL var for ENDRCVLIB    (10) (ENDRCVLIB)
:P.
Specifies the name of the program CL character variable into which the
name of the library containing the receiver of the retrieved ending
journal entry is copied.
:P.
The specified variable must be a character variable with a minimum
length of 10 characters.
:P.
If the length of the variable is longer than 10 characters, it is
padded on the right with blanks.
:EHELP.

:HELP NAME='RTVRCVRNG/ENDSEQNBR'.
CL var for ENDSEQNBR    (20) (ENDSEQNBR) - Help

:XH3.CL var for ENDSEQNBR    (20) (ENDSEQNBR)
:P.
Specifies the name of the program CL character variable into which the
journal entry sequence number of the retrieved ending journal entry
is copied.
:P.
The specified variable must be a character variable that has a length
of twenty positions.
:P.
If the retrieved sequence number is shorter than the length of the
field, the number is left adjusted and padded on the right with blanks.
:EHELP.

:EPNLGRP.
