Reclaim Report for OnDemand (RCLRPTRDAR)

The Reclaim Report for OnDemand (RCLRPTRDAR) command reclaims (recovers) the specified report from disk, tape, or optical and optionally re-runs STRCDSRDAR. The reclaimed report is placed in the job's output queue. The RCLRPTRDAR command is only used to recover lost OnDemand reports and should only be used with caution or with assistance from the support center.

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	1-999	Required, Positional 4
FROM	Reclaim report from	DASD, OPTICAL, TAPE, TAPEMGR	Required, Positional 5
ACCTYPE	Default optical volume type	HFS, RDARLAN	Optional
OPTVOL	Optical volume	Values (up to 10 repetitions): Element list	Optional
	Element 1: Name	Character value
	Element 2: Library	Name, *NONE
	Element 3: Type	ACCTYPE, HFS, *RDARLAN
TAPDEV	Tape device	Name	Optional
MLB	Media device library	Name	Optional
SEQNBR	Tape sequence number	1-9999, *SEARCH	Optional
TAPVOL	Tape volume	Values (up to 10 repetitions): Character value	Optional
ENDOPT	End of tape option	REWIND, LEAVE, *UNLOAD	Optional
AUTOSTORE	Automatically store 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 to reclaim.

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.

Report date (RPTDATE)

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.

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.

This is a required parameter.

Reclaim report from (FROM)

Specifies where the report should be reclaimed from.

*DASD: The report is reclaimed from disk.
*OPTICAL: The report is reclaimed from the optical volumes specified in the OPTVOL parameter.
*TAPE: The report is reclaimed from the tape volumes specified in the TAPVOL parameter.
*TAPEMGR: The report is reclaimed from tape using an external tape manager such as BRMS.

This is a required parameter.

Default optical volume type (ACCTYPE)

Specify the optical volume type to use as the default.

*HFS: Use the operating system's optical support. Specify this for all optical libraries (direct or LAN attached) unless it is known that OnDemand LAN optical support was used to archive the report to optical.
*RDARLAN: Use the OnDemand LAN optical support. Use this only if it is known that OnDemand LAN optical support was used to archive the report to optical.

Optical volume (OPTVOL)

Specifies the identifiers of up to ten optical volumes containing the report to be reclaimed.

You can enter multiple values for this parameter.

Element 1: Name

identifier: Specify the volume identifier of the optical volume.

Element 2: Library

name: Specify the optical library name that contains the optical volume. This parameter is only needed when the ACCTYPE parameter is *RDARLAN or when the Type element is *RDARLAN.

Element 3: Type Specify the type of optical volume.

*ACCTYPE: Use the value specified in the ACCTYPE parameter.
*HFS: Use the operating system's optical support. Specify this for all optical libraries unless it is known that OnDemand LAN optical support was used to archive the report to optical.
*RDARLAN: Use the OnDemand LAN optical support. Use this only if it is known that OnDemand LAN optical support was used to archive the report to optical.

Media device library (MLB)

Specifies the name of the media device library that the tape device specified for the Tape device (TAPDEV) parameter is located in. This parameter should only be used when the tape device is located in a media device library.

Tape sequence number (SEQNBR)

Specifies the tape sequence number of the report to reclaim.

*SEARCH: The tape is searched for the report, when a match is found, the report is reclaimed. If the last operation on the tape unit specified *LEAVE for the End of tape (ENDOPT)parameter, indicating that the tape is positioned at the location where the last operation ended, the file search starts with the first report beyond the current tape position. If *LEAVE was not used for the End of tape option prompt (ENDOPT parameter) of the last operation or if the tape was manually rewound since the operation, the search starts with the first report on the volume.
file-sequence-number: Specify the sequence number of the file used for the reclaim report operation.

Tape volume (TAPVOL)

Specify the volume names of one to ten volumes in the order in which they are to be mounted in the tape device and used to reclaim the report.

You can enter multiple values for this parameter.

End of tape option (ENDOPT)

Specifies, when tape is used, what positioning operation is automatically done on the tape volume after the reclaim operation ends. If more that one tape volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.

*REWIND: The tape is automatically rewound, but not unloaded, after the operation has ended.
*LEAVE: The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
*UNLOAD: The tape is automatically rewound and unloaded after the operation ends.

Automatically store reports (AUTOSTORE)

Specifies if the reclaimed report should also be stored using the Start Coded Data Store (STRCDSRDAR) command.

*NO: The reclaimed report is not automatically stored.
*YES: The reclaimed report is stored again using the STRCDSRDAR command.

Submit to batch (SBMJOB)

Specify if you want to reclaim this report in this current job 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.

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.

Examples

Example 1: Simple Example

RCLRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
             RPTSEQ(001)FROM(*OPTICAL) OPTVOL((OD0000000012))

This command submits a job to batch to respool a particular OnDemand Spool File Archive archived report named CHECKSTMTS from optical volume OD0000000012. The reclaimed spooled file is placed in the job's output queue. This command is most often used when a problem is encountered with an archived report and the spooled file needs to be rearchived.

Example 2: More Complex Example

RCLRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
             RPTSEQ(001)FROM(*OPTICAL) OPTVOL((OD0000000012))
             AUTOSTORE(*YES)SBMJOB(*NO)

This command is similar to Example 1 but runs interactively and automatically stores the reclaimed spooled file back into OnDemand Spool File Archive.

Error messages

*ESCAPE Messages

CPF1338: Errors occurred on SBMJOB command.
RDR0101: Processing of STRCDSRDAR failed for &1. Rerun STRCDSRDAR and specify RESTART(&2).
RDR0168: Error was detected for Report &1/&2/&3.&4. The report was not printed.