Remove Report from OnDemand (RMVRPTOND)

Parameters

Keyword	Description	Choices	Notes
APPGRP	Application group	Character value	Required, Positional 1
RPTID	Report ID	Character value	Required, Positional 2
INSTANCE	Instance	Character value, QUSROND	Optional
SBMJOB	Submit to batch	YES, NO	Optional
JOBD	Job description	Qualified object name	Optional
	Qualifier 1: Job description	Name, QOND400
	Qualifier 2: Library	Name, QRDARS, LIBL, CURLIB
ERROPT	Error option	FRCRMV, NOFRCRMV	Optional

Top

Application group (APPGRP)

Specifies the name of the application group that contains the report to be removed.

This is a required parameter.

Note: If you press the F4 key for this parameter while prompting the command, a list of the valid entries is presented to you. The entries listed may not be valid if the parameter INSTANCE is not QUSROND.

If the value to be entered contains lower case letters, blanks, or special characters, it must be enclosed in apostrophes.

Report ID (RPTID)

Specifies the report ID of the report to be removed.

The report ID is in the form of "1220-1-0-8FAA-9939-9345", where the "1220" is the internal application group identifier, "1" is the primary storage node, "0" is the secondary storage node, "8FAA" is a counter, "9339" is the first (internal) date in the report file and "9345" is the last (internal) date in the report file. The report ID is also known as the load ID.

Note: The report id can be found in the system log file.

This is a required parameter.

Instance (INSTANCE)

Specifies the name of the instance to use.

QUSROND: The default OnDemand instance is used.
instance-name: Specify the name of the instance that is to be used. By definition, the instance must be on the system that the command is run.
library-server-name: Specify the TCP/IP host name of the library server. The name can also be specified as a TCP/IP dotted decimal address in the form of nnn.nnn.nnn.nnn.
When a server name or TCP/IP address is entered, OnDemand uses the instance on that server that is using the default port. In most cases, this will also use the default instance.

Submit to batch (SBMJOB)

Specify if you want to remove 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.

Job description (JOBD)

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

Qualifier 1: Job description

QOND400: The QOND400 job description is used as the job description for the submitted job.
name: Specify the name (name/name) of the job description used for the job.

Qualifier 2: Library

QRDARS: Library QRDARS is used as the job description's 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.

Error option (ERROPT)

Force the removal of the report even if the report ID is not found in the system log.

*FRCRMV: Remove the report if the report ID is not found in the system log.
*NOFRCRMV: Do not remove the report if the report ID is not found in the system log.

Examples

Example 1: Simple Example

RMVRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')

This command submits a job to batch to remove an archived spooled file from the OnDemand Common Server application group called CHECKSTMTS with a load id (also known as report id) as shown. The command assumes the archived data is to be removed from the QUSROND instance since no instance name was specified.

Example 2: More Complex Example

RMVRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')
            INSTANCE(ACCTING) SBMJOB(*NO)

This command is similar to Example 1 but runs interactively and specifies a specific instance from which to remove the archived report.