Delete Report for OnDemand (DLTRPTRDAR)

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

The Delete Report for OnDemand (DLTRPTRDAR) command deletes the specified report.

Top

Parameters

Keyword Description Choices Notes
REPORT Report name Character value Required, Positional 1
VERSION Version 1-99 Required, Positional 2
RPTDATE Report date Character value Required, Positional 3
RPTSEQ Report sequence number AAA-999 Required, Positional 4
CLEANUP Remove partial reports *NO, *YES Optional
SBMJOB Submit to batch *YES, *NO Optional
JOBD Job description Qualified object name Optional
Qualifier 1: Job description Name, QRDARS400
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Report name (REPORT)

Specifies the name of the report.

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

Version (VERSION)

Specifies the version of the report that should be deleted. This value must be between 01 and 99.

This is a required parameter.

Top

Report date (RPTDATE)

Specifies the report date of the report to delete.

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.

The report date can be found in the QPRLRCDS printer file from STRCDSRDAR or on the OnDemand displays which show the report date for a given report.

This is a required parameter.

Top

Report sequence number (RPTSEQ)

Specifies the report sequence number of the report to be deleted. This value must be between 001 and 999 unless this is an AnyStore report. AnyStore reports allow sequence numbers from AAA to 999.

This is a required parameter.

Top

Remove partial reports (CLEANUP)

Specifies whether partial reports should be deleted.

*NO
Partial reports are not deleted.
*YES
Partial reports are deleted.

Note: A report is a partial report when some portion of the report is missing. If you tried to delete a report and it failed, you can specify *YES here and the pieces of the report that are found will be deleted.

Top

Submit to batch (SBMJOB)

Specify if you want to delete the specific report interactively or in a batch job.

*YES
This command should be submitted to run in a different job.
*NO
This command should be run within the current job. If you are entering this command from a terminal, this will prevent you from doing any other work from this terminal session until this command completes.
Top

Job description (JOBD)

Specifies the name of the job description used for the submitted job.

Qualifier 1: Job description

QRDARS400
The QRDARS400 job description is used as the job description for the submitted job.
name
Specify the name of the job description used for the job.

Qualifier 2: Library

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the job description name is located.
Top

Examples

Example 1: Simple Example

DLTRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
             RPTSEQ(001)

This command submits a job to batch that will delete an OnDemand Spool File Archive report called CHECKSTMTS for Version 01/Sequence number 001 for the date specified.

Example 2: More Complex Example

DLTRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
             RPTSEQ(001)CLEANUP(*YES) SBMJOB(*NO)

This command runs interactively to delete all or part of an OnDemand Spool File Archive report called CHECKSTMTS for Version 01/Sequence number 001 for the date specified. The CLEANUP(*YES) parameter is used to delete parts of an archived spooled file that may have been created during a previous archive attempt that was unsuccessful.

Top

Error messages

*ESCAPE Messages

RDR0153
Error was detected for Report &1/&2/&3.&4. The report was not deleted.
Top