The Retrieve Journal Receiver Attributes command retrieves the
attributes of a journal receiver as well as the number of entries,
first and last sequence number, etc. The command may only be used in
a CL program.
A typical command would be:
DCL &NBRENT *DEC LEN(15 0)
.
RTVJRNRCVA JRNRCV(xxx) NBRENT(&NBRENT)
RTVJRNRCVA escape messages you can monitor for
-----------------------------------------------
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JRNRCV The qualified name of the journal receiver to be
retrieved. The library value defaults to *LIBL.
*CURLIB may also be used.
RTNLIB The library containing the journal receiver. This
return value may be helpful if *LIBL is used for the
qualified journal name. If specified, the return
variable must be declared as *CHAR LEN(10).
STATUS The status of the journal receiver. One of the
following values will be returned:
*ATTACHED Currently attached
*ONLINE On line, detached, but not saved
*SAVED On line, detached, and saved
*FREED On line, detached, saved and stg freed
*PARTIAL See note
*EMPTY Never attached
The *PARTIAL entry means 1) Restored from a version
that was saved while attached, but additional
entries have been added 2) One of a pair of dual
receivers that was damaged while attached 3)
Associated with a remote journal and does not
contain all of the entries.
If specified, the return variable must be declared
as *CHAR LEN(10).
ASP The ASP containing the journal receiver. If
specified, the return variable must be declared as
*DEC LEN(3 0).
THRESHOLD The value of the THRESHOLD parameter specified on
CRTJRNRCV. The value is specified and returned in
KB. If *NONE was specified on CRTJRNRCV, a value of
0 is returned. If the value is greater than
8,000,000 in KB, the return value will be 0 (use
THRESHOLD2). If specified, the return variable must
be declared as *DEC LEN(7 0).
THRESHOLD2 The value of the THRESHOLD parameter specified on
CRTJRNRCV. The value is specified and returned in
KB. If *NONE was specified on CRTJRNRCV, a value of
0 is returned. If specified, the return variable
must be declared as *DEC LEN(15 0).
SIZE The size of the journal receiver. The value is in
KB. If the value is greater than 9,000,000,000 in
bytes, the return value will be 0 (use SIZE2). If
specified, the return variable must be declared as
*DEC LEN(7 0).
SIZE2 The size of the journal receiver. The value is in
bytes. If specified, the return variable must be
declared as *DEC LEN(15 0).
NBRENT The number of entries in the journal receiver. If
specified, the return variable must be declared as
*DEC LEN(15 0).
MAXNULLIND The maximum number of null value indicators among
all journal entries in this journal receiver. *DEC
LEN(15 0).
MAXENTLEN The maximum length of the entry specific data for
any journal entry. If the value exceeds 99999, zero
will be returned (use MAXENTLEN2). If specified,
the return variable must be declared as *DEC LEN(5
0).
MAXENTLEN2 The maximum length of the entry specific data for
any journal entry. If specified, the return
variable must be declared as *DEC LEN(15 0).
RCVMAXOPT Indicates the journal receiver sequence number and
size options. Blank means the journal receiver has
not yet been attached. A description of the codes
can be found in the QjoRtvJrnReceiverInformation
API. If specified, the return variable must be
declared as *CHAR LEN(1).
MINFIXLEN Whether the receiver was attached when MINENTDTA
*FILE was in effect. 'No' means the journal entries
will have complete entry data. A description of the
other codes can be found in the
QjoRtvJrnReceiverInformation API. If specified, the
return variable must be declared as *CHAR LEN(3).
FSTSEQNBR The first journal sequence number in the receiver.
If specified, the return variable must be declared
as *DEC LEN(15 0).
LSTSEQNBR The last journal sequence number in the receiver.
If specified, the return variable must be declared
as *DEC LEN(15 0).
ATCDAT The date the journal receiver was attached in the
format CYYMMDD. If never attached, the value will
be blank. If specified, the return variable must be
declared as *CHAR LEN(7).
ATCTIM The time the journal receiver was attached in the
format HHMMSS. If never attached, the value will be
blank. If specified, the return variable must be
declared as *CHAR LEN(6).
DTCDAT The date the journal receiver was detached in the
format CYYMMDD. If never detached, the value will
be blank. If specified, the return variable must be
declared as *CHAR LEN(7).
DTCTIM The time the journal receiver was detached in the
format HHMMSS. If never detached, the value will be
blank. If specified, the return variable must be
declared as *CHAR LEN(6).
SAVDAT The last save date of the journal receiver in the
format CYYMMDD. If never saved, the value will be
blank. If specified, the return variable must be
declared as *CHAR LEN(7).
SAVTIM The last save time of the journal receiver in the
format HHMMSS. If never saved, the value will be
blank. If specified, the return variable must be
declared as *CHAR LEN(6).
JRN The journal the receiver is or was attached to. If
never attached, the value will be blank. If
specified, the return variable must be declared as
*CHAR LEN(10).
JRNLIB The library of the journal the receiver is or was
attached to. If never attached, the value will be
blank. If specified, the return variable must be
declared as *CHAR LEN(10).
TEXT The text description of the journal receiver. If
specified, the return variable must be declared as
*CHAR LEN(50).
Restrictions
------------
Because the command returns variables, it may only be used in a CL
program.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
RTVJRNRCVA *CMD TAAJRNT QATTCMD
TAAJRNTC *PGM CLLE TAAJRNTC QATTCL
|
