Find by Key using OnDemand (FNDKEYRDAR)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Find by Key using OnDemand (FNDKEYRDAR) command allows you to search for a particular document or segment that has been stored in the report specified in the REPORT parameter. If more than one document or segment satisfies the search, a list is shown and you can select which document or segment should be viewed. You can limit the documents or segments that are found by specifying a date range or by entering more that one key field. A value must be specified for at least one of the key fields on this command. This is intended as an API for the OnDemand key search function.

Top

Parameters

Keyword Description Choices Notes
REPORT Report name Character value Required, Positional 1
RPTKEY1 Key 1 value Character value Optional
RPTKEY2 Key 2 value Character value Optional
RPTKEY3 Key 3 value Character value Optional
RPTKEY4 Key 4 value Character value Optional
RPTKEY5 Key 5 value Character value Optional
GROUP Group search *NO, *YES Optional
RPTDATE Report date range Element list Optional
Element 1: From date Character value, *AVAIL
Element 2: To date Character value, *CURRENT
OUTPUT Output *, *PRINT, *FAX Optional
Top

Report name (REPORT)

Specify the name of the report to search.

This is a required parameter.

Note: If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.

Top

Key 1 value (RPTKEY1)

Specify the key one of the report to find.

Top

Key 2 value (RPTKEY2)

Specify the key two of the report to find.

Top

Key 3 value (RPTKEY3)

Specify the key three of the report to find.

Top

Key 4 value (RPTKEY4)

Specify the key four of the report to find.

Top

Key 5 value (RPTKEY5)

Specify the key five of the report to find.

Top

Group search (GROUP)

Specifies if the search is for this report only or for all reports in the report group.

*NO
The search is only for the report specified in the REPORT parameter.
*YES
The search is performed across all reports in the report group. The report group used is that of the report specified on the REPORT parameter.
Top

Report date range (RPTDATE)

Specifies the earliest and latest dates of the reports that should be searched.

Element 1: From date

*AVAIL
The date of the earliest available report is used.
date
Specify a date using the format YYYYMMDD where YYYY represents the year, MM the month, and DD the day. Do not use any type of special characters to separate year, month, and day values.

Element 2: To date

*CURRENT
Today's date is used.
date
Specify a date using the format YYYYMMDD where YYYY represents the year, MM the month, and DD the day. Do not use any type of special characters to separate year, month, and day values.
Top

Output (OUTPUT)

Specifies what should be done with the report when it is found.

*
The found documents or segments are shown on the display where this command is run.
*PRINT
The document or segment is printed. A selection list is shown if a single document or segment is not found.
*FAX
The document or segment is faxed. A selection list is shown if a single document or segment is not found.
Top

Examples

Example 1: Simple Example 

FNDKEYRDAR REPORT(CHECKSTMTS) RPTKEY1(251000022)

This command allows you to search for a particular OnDemand Spool File Archive document that is archived using the report definition name of CHECKSTMTS. The key value that you enter must correspond with the keys (keys 1 through 5) defined in the OnDemand Spool File Archive report definition.

Example 2: More Complex Example 

FNDKEYRDAR REPORT(CHECKSTMTS) RPTKEY1(251000022)
             RPTKEY3(KATIE*)RPTDATE(19880616 20020816)
             OUTPUT(*PRINT)

This command is similar to Example 1 but shows the use of more than one key field/value and the *PRINT option.

Top

Error messages

*ESCAPE Messages

RDR0001
Report definition not found.
RDR0006
No documents found with this key.
RDR0007
From Date must be entered with To Date.
RDR0010
Page number must not exceed 999999.
RDR0011
Page number must be numeric.
RDR0013
Segment number must not exceed 999999.
RDR0053
Access denied. Not authorized to access this report.
RDR0054
Severe directory problem.
RDR0055
Report access denied. You are not enrolled in the System Directory.
RDR0104
From date not valid.
RDR0105
To date not valid.
RDR0124
Cannot perform a more than one key search with this key combination.
RDR0183
You are not authorized to the document with this key value.
RDR9999
No more licenses for OnDemand are available.
Top