REMOVE REPORT (RMVRPTOND)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| APPGRP | APPLICATION GROUP | Character value | Required, Positional 1 |
| RPTID | REPORT ID | Character value | Required, Positional 2 |
| HLDTHLD | HOLD THRESHOLD | 1-100, *NONE | Optional |
| INSTANCE | INSTANCE | Character value, *DFT | Optional |
| STRSVR | START INSTANCE SERVER | *NO, *YES | 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 |
| Top |
APPLICATION GROUP (APPGRP)
SPECIFIES THE NAME OF THE APPLICATION GROUP THAT CONTAINS THE REPORT TO BE REMOVED.
THIS IS A REQUIRED PARAMETER.
Note: POSITION THE CURSOR IN THE APPLICATION GROUP PARAMETER ENTRY AND USE THE PROMPT (F4) KEY TO VIEW THE LIST OF APPLICATION GROUP VALUES THAT ARE AVAILABLE FOR THE DEFAULT (*DFT) INSTANCE.
THE DEFAULT INSTANCE IS SPECIFIED IN THE QDFTINST DATA AREA. THE QDFTINST DATA AREA CAN EXIST IN MULTIPLE LIBRARIES. A SEARCH FOR THE QDFTINST DATA AREA IS PERFORMED USING THE LIBRARY LIST. THE FIRST DATA AREA FOUND WILL BE USED. IF THE QDFTINST DATA AREA IS NOT FOUND USING THE LIBRARY LIST, THE QUSRRDARS LIBRARY WILL BE SEARCHED FOR THE DATA AREA. IF THE DATA AREA EXISTS IN THE QUSRRDARS LIBRARY IT WILL BE USED. IF THE QDFTINST DATA AREA IS NOT FOUND, INSTANCE QUSROND IS USED.
IF THE VALUE TO BE ENTERED CONTAINS LOWER CASE LETTERS, BLANKS, OR SPECIAL CHARACTERS, IT MUST BE ENCLOSED IN SINGLE QUOTATION MARKS.
| Top |
REPORT ID (RPTID)
SPECIFIES THE REPORT ID OF THE REPORT TO BE REMOVED.
THIS IS A REQUIRED PARAMETER.
THE REPORT ID IS ALSO KNOWN AS THE LOAD ID AND CAN BE FOUND IN THE CONTENT MANAGER ONDEMAND SYSTEM LOAD FOLDER OR THE SYSTEM LOG FOLDER IN THE MESSAGE TEXT FOR MESSAGE NUMBER 87, BOTH GENERATED WHEN AN INPUT FILE IS SUCCESSFULLY LOADED INTO THE SYSTEM. THE REPORT ID CONTAINS THE VALUE THAT CONTENT MANAGER ONDEMAND GENERATES TO UNIQUELY IDENTIFY AN INPUT FILE, SUCH AS 5547-4-0-2FAA-20130313000000-20130313000000-5548. THE REPORT ID CONTAINS THE FOLLOWING PARTS:
AGID-PRI_NID-SEC_NID-DOCID-START_DATE-STOP_DATE-AID
- AGID
- APPLICATION GROUP IDENTIFIER.
- PRI_NID
- PRIMARY STORAGE NODE.
- SEC_NID
- SECONDARY STORAGE NODE.
- DOCID
- DOCUMENT IDENTIFIER.
- START_DATE
- FIRST DATE IN THE REPORT. THE FORMAT OF THE DATE IS YYYYMMDDHHMMSS. LOADS CREATED WITH VERSIONS OF CONTENT MANAGER ONDEMAND PRIOR TO SERVER VERSION 9.0 USE AN OLDER, INTERNAL DATE FORMAT FOR THIS PART.
Note: IF YOU DO NOT KNOW THE START DATE, THE VALUE OF THIS PART CAN ALSO BE SPECIFIED AS 0.
- STOP_DATE
- LAST DATE IN THE REPORT. THE FORMAT OF THE DATE IS YYYYMMDDHHMMSS. LOADS CREATED WITH VERSIONS OF CONTENT MANAGER ONDEMAND PRIOR TO SERVER VERSION 9.0 USE AN OLDER, INTERNAL DATE FORMAT FOR THIS PART.
Note: IF YOU DO NOT KNOW THE STOP DATE, THE VALUE OF THIS PART CAN ALSO BE SPECIFIED AS 0.
- AID
- APPLICATION IDENTIFIER. THIS PART IS OPTIONAL.
| Top |
HOLD THRESHOLD (HLDTHLD)
WHEN USING ENHANCED RETENTION MANAGEMENT, SPECIFIES A THRESHOLD VALUE THAT DETERMINES IF AND WHEN YOU WANT CONTENT MANAGER ONDEMAND TO RELOAD LOADS DURING DELETE PROCESSING. THE RELOAD WOULD RETAIN ONLY THE DOCUMENTS IN A LOAD THAT CURRENTLY HAVE A HOLD ASSOCIATED WITH THEM. ANY DOCUMENTS IN THE LOAD THAT ARE ELIGIBLE FOR DELETION THAT DO NOT HAVE A HOLD WOULD BE DELETED. IF A HIGH PERCENTAGE OF THE DOCUMENTS IN THE LOAD ARE HELD, THEN RELOADING THE DATA IS NOT RECOMMENDED BECAUSE VERY LITTLE SPACE IS RECLAIMED AFTER THE RELOAD. IF A LOW PERCENTAGE OF THE DOCUMENTS IN THE LOAD ARE HELD, CONSIDER SETTING THE HOLD THRESHOLD (HLDTHLD) PARAMETER TO A VALUE THAT CAN CAUSE A RELOAD TO OCCUR, WHICH CAN REDUCE THE SPACE USED DUE TO THE SMALLER LOAD SIZE. THE RELOAD TAKES TIME AND SYSTEM RESOURCES, BUT THE RESULT IS A SMALLER LOAD STORED IN CONTENT MANAGER ONDEMAND.
WHEN CONTENT MANAGER ONDEMAND PROCESSES A LOAD, IT CALCULATES THE PERCENTAGE OF DOCUMENTS WITHIN THE LOAD THAT HAVE A HOLD. IF THE PERCENTAGE OF HELD DOCUMENTS FALLS BELOW THE THRESHOLD VALUE SPECIFIED, CONTENT MANAGER ONDEMAND RELOADS THE LOAD AND GENERATES A NEW LOAD ID OR REPORT ID TO IDENTIFY THE SMALLER LOAD. FOR EXAMPLE, IF YOU SPECIFY HLDTHLD(20), AND LESS THAN 20 PERCENT OF DOCUMENTS IN A LOAD HAVE A HOLD, THEN CONTENT MANAGER ONDEMAND RELOADS THE LOAD.
FOR A MORE COMPLEX EXAMPLE, ASSUME YOU HAVE A LOAD WITH 100 DOCUMENTS AND YOU SPECIFY HLDTHLD(50). WHEN CONTENT MANAGER ONDEMAND PROCESSES A LOAD, IF THE PERCENTAGE OF DOCUMENTS WITH A HOLD IS LESS THAN 50 PERCENT, CONTENT MANAGER ONDEMAND RELOADS THE LOAD. THE FOLLOWING LIST DESCRIBES HOW CONTENT MANAGER ONDEMAND FUNCTIONS AS THE NUMBER OF DOCUMENTS WITH HOLDS INCREASES FOR THIS EXAMPLE:
- ONE DOCUMENT HAS A HOLD. THE ACTUAL PERCENTAGE IS 1 PERCENT. CONTENT MANAGER ONDEMAND RELOADS THE LOAD. ONLY ONE DOCUMENT BELONGS TO THE NEW LOAD.
- FORTY NINE DOCUMENTS HAVE A HOLD. THEREFORE, THE ACTUAL PERCENTAGE IS 49 PERCENT. CONTENT MANAGER ONDEMAND RELOADS THE LOAD. FORTY NINE DOCUMENTS BELONG TO THE NEW LOAD.
- FIFTY DOCUMENTS HAVE A HOLD. THE ACTUAL PERCENTAGE IS 50 PERCENT. CONTENT MANAGER ONDEMAND DOES NOT RELOAD THE LOAD.
- FIFTY ONE DOCUMENTS HAVE A HOLD. THE ACTUAL PERCENTAGE IS 51 PERCENT. CONTENT MANAGER ONDEMAND DOES NOT RELOAD THE LOAD.
- NO DOCUMENTS HAVE A HOLD. THE ACTUAL PERCENTAGE IS 0 PERCENT. THIS IS A SPECIAL CASE. EVEN THOUGH 0 PERCENT IS LESS THAN 50 PERCENT, CONTENT MANAGER ONDEMAND DOES NOT RELOAD THE LOAD, BECAUSE ALL DOCUMENTS ARE ELIGIBLE FOR DELETION, AND THERE WOULD BE NOTHING LEFT TO RELOAD.
- *NONE
- CONTENT MANAGER ONDEMAND WILL NOT RELOAD ANY LOADS.
- 1 - 100
- SPECIFY THE PERCENTAGE OF HELD DOCUMENTS WITHIN A LOAD, BETWEEN 1 AND 100 PERCENT, UNDER WHICH A RELOAD OF THE LOAD SHOULD BE PERFORMED.
| Top |
INSTANCE (INSTANCE)
SPECIFIES THE NAME OF THE CONTENT MANAGER ONDEMAND INSTANCE TO USE.
- *DFT
- THE DEFAULT CONTENT MANAGER ONDEMAND INSTANCE IS USED. THE DEFAULT INSTANCE IS SPECIFIED IN THE QDFTINST DATA AREA. THE QDFTINST DATA AREA CAN EXIST IN MULTIPLE LIBRARIES. A SEARCH FOR THE QDFTINST DATA AREA IS PERFORMED USING THE LIBRARY LIST. THE FIRST DATA AREA FOUND WILL BE USED. IF THE QDFTINST DATA AREA IS NOT FOUND USING THE LIBRARY LIST, THE QUSRRDARS LIBRARY WILL BE SEARCHED FOR THE DATA AREA. IF THE DATA AREA EXISTS IN THE QUSRRDARS LIBRARY IT WILL BE USED. IF THE QDFTINST DATA AREA IS NOT FOUND, INSTANCE QUSROND IS USED.
- INSTANCE-NAME
- SPECIFY THE NAME OF THE INSTANCE THAT IS TO BE USED. BY DEFINITION, THE INSTANCE MUST BE ON THE SYSTEM WHERE THE COMMAND IS RUN.
| Top |
START INSTANCE SERVER (STRSVR)
SPECIFY TO START THE INSTANCE SERVER IF IT IS NOT CURRENTLY ACTIVE.
- *NO
- THE INSTANCE SERVER FOR THIS INSTANCE WILL NOT BE STARTED.
- *YES
- THE INSTANCE SERVER FOR THIS INSTANCE WILL BE STARTED.
| Top |
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.
| Top |
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.
- JOBD-NAME
- SPECIFY THE 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.
- LIBRARY-NAME
- SPECIFY THE NAME OF THE LIBRARY WHERE THE JOB DESCRIPTION NAME IS LOCATED.
| Top |
Examples
EXAMPLE 1: SIMPLE EXAMPLE
RMVRPTOND APPGRP(CHECKSTMTS)
RPTID('1220-1-0-8FAA-20130420120000-20130421120000')
THIS COMMAND SUBMITS A JOB TO BATCH TO REMOVE AN ARCHIVED SPOOLED FILE FROM THE CONTENT MANAGER 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-20130420120000-20130421120000')
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.
| Top |
Error messages
*ESCAPE MESSAGES
- CPF1338
- ERRORS OCCURRED ON SBMJOB COMMAND.
- OND0222
- RMVRPTOND ENDED IN ERROR. THE REPORT WAS NOT REMOVED.
| Top |