Storing WebDocs Documents on an IBM Tivoli Storage Manager or DR550 Server
From Support
The following instructions will allow you to store and retreive documents from an IBM Tivoli Storage Manager Server or IBM DR550 Storage and Compliance Server.
Installation 1.) Install WebDocs iSeries Edition Library Version 2.17 or above..
2.) Install and Configure RJS Tivoli Storage Manager API's and the IBM Tivoli Storage Manager API's. Contact RJS for assistance.
Enabling WebDocs iSeries Edition to Store Documents to an IBM Tivoli/DR550 Server WebDocs storage to the IBM Tivoli/DR550 server is enabled at the document folder level. All folders enabled for Tivoli/DR550 archival will be processed the next time the document archive programs DOCTSM01 and DOCTSM03 are run. Sub-folders of a level 1 folder must also be selected for archival if you want the contents archived to your Tivoli/DR550 server.
1.) Log in to the iSeries and go to the WebDocs iSeries Edition Main Menu.
ADDLIBLE RJSIMAGE GO RJSIMAGE
2.) Select Option 11, Edit Document Folders to open the edit document folders program and then select Opt 2 to edit an existing folder entry.
3.) Enter a Y in the Archive Folder to Tivoli Storage Manager/DR550 setting to enable the selected folder to be archived to a Tivoli/DR550 server. Any setting other than Y, disables this folder for archival to Tivoli/DR550.
4.) Set the RJSTSMPWD data area to WEBDOCS in the RJSIMAGE and RJSTSM libraries via the following commands:
CHGDTAARA DTAARA(RJSTSM/RJSTSMPWD) VALUE(WEBDOCS) CHGDTAARA DTAARA(RJSIMAGE/RJSTSMPWD) VALUE(WEBDOCS)
Archiving Documents to a Tivoli/DR550 Server
1.) Log in to the iSeries and add the WebDocs library to your library list.
ADDLIBLE RJSIMAGE
2.) Run or submit the DOCTSM01 command to select ALL unarchived documents or document versions in all Tivoli/DR550 archive enabled WebDocs folders for processing
Ex: DOCTSM01 CONFIRM1(*NO) CONFIRM2(*NO)
After the command completes, you may run DOCTSM03 to archive all selected documents or DOCTSM02 if you would like to de-select all documents for processing.
3.) Run or submit the DOCTSM03 command to perform the physical archiving from IFS disk to the IBM Tivoli/DR550 server of all documents selected for processing by DOCTSM01.
Ex: DOCTSM03 CONFIRM1(*NO) CONFIRM2(*NO) DLTIFS(*NO)
**Note: Run the DOCTSM03 command with the DLTIFS parameter set to *NO so that the audit process DOCTSM04 can be run to verify and delete selected files from the IFS after they have been archived.
This archival step will create an audit report during processing.
4.) Run or submit the DOCTSM04 command to perform the after archival audit to compare the documents stored on the Tivoli/DR550 against the original IFS documents to make sure the documents were archived appropriately. You must specify a valid WebDocs document date range to be audited based on the document checkin dates in WebDocs.
Tip: If you use a date range such as 1/1/1940 - 1/1/2030, you will run an audit against all docs that could possibly have been archived to Tivoli/DR550. This type of audit should be run periodically to make sure all docs still exist on the Tivoli/DR550 server and have not been inadvertently expired by the Tivoli/DR550 policies.
Checks performed during the audit: - Checks to see if there is an original WebDocs IFS file still on disk. (It may or may not exist, depending on whether the doc got purged from the IFS. This is OK.) - Checks to see if the doc exists on the Tivoli/DR550 server. (This check always happens. The document should exist on the Tivoli/DR550 server always in this audit.) - If both IFS and Tivoli/DR550 versions of a document exist, we compare the physical contents of both IFS and Tivoli/DR550 versions to make sure they match exactly.) - If the delete IFS (DLTIFS) option was set to *YES and the IFS version of the file exists and matches the Tivoli/DR550 version, the IFS file will be deleted. After the deletion the document will still be accessible via WebDocs. WebDocs will read it from the Tivoli/DR550 server.
Example to run audit report and delete original IFS files if doc exists on Tivoli/DR550 server and matches IFS file DOCTSM04 BEGINDATE('1/1/2007') ENDDATE('1/1/2007') DLTIFS(*YES) CONFIRM1(*YES) CONFIRM2(*YES)
Example to simply run audit report without deleting original IFS file if it exists. DOCTSM04 BEGINDATE('1/1/2007') ENDDATE('1/1/2007') DLTIFS(*NO) CONFIRM1(*YES) CONFIRM2(*YES)
The DOCTSM04 program will create an audit report during processing.
After processing, review the audit report text and search for the word ERROR in the DOCTSM04P spool file to insure no errors occurred.
The following summary total counts display at the bottom of the audit report and show if any errors occurred
Report Total Counts
Total documents read: 000000000000009 This is the total number of documents just read during the audit pass. This is mainly informational only, however it should match the Total found on Tivoli/DR550.
Total with orig IFS: 000000000000000 This is the total number of documents read that still exist in the IFS because they have been archived to the Tivoli/DR550 server but have not been deleted yet. This is mainly informational only.
Total mismatch errors: 000000000000000 This is the total number of docs where the IFS file does not match the Tivoli/DR550 version of the document.
If not 0, this is a problem and should be investigated. Review the audit report closely for the word ERROR to find the errors. If delete is set to *YES, the original IFS file will not be deleted if there is a mismatch.
Total found on Tivoli/DR550: 000000000000009 This is the total number of docs read that should exist on the Tivoli/DR550 server. This value should match the Total documents read.
Total deleted from IFS: 000000000000000 This is the total number of docs just deleted from the IFS. This should match the Total with orig IFS value.
Total errors: 000000000000000 This is the total number of errors that occurred.
If not 0, this is a problem and should be investigated. Review the audit report closely for the word ERROR to find the errors.
