Show TOC

 WriteLocate this document in the navigation structure

Use

In the Write view you can centrally schedule the write sessions for any archiving set that supports this function. During a write session data is written from the database to a collection in the form of resources-the first phase of an archiving session. After the write phase, the archiving session appears with the status incomplete in the archive hierarchy . The second phase of an archiving session is the delete phase, which is described under Delete .

Prerequisites

Before you start archiving, familiarize yourself with the different elements involved in service-oriented archiving. See Administration Functions for Information Lifecycle Management for a diagram of the different scenarios and systems involved. Furthermore, use the XML Data Archiving Service Administration to prepare the XML Data Archiving Service (XML DAS) and the connected storage system or systems for archiving.

Note

An archiving set supports the write function if it has implemented Job Beans (for more information see Job Definition under SAP NetWeaver Scheduler for Java). If not, the system issues the following error message: Starting archiving sessions for archiving set "XXX" is not supported. If an archiving set does not support this write function, its sessions can still be viewed under Monitor and Hierarchy , and its properties can be changed under Configure .

Procedure

Scheduling of Write Sessions:

  1. Choose the desired archiving set from the drop down list under Archiving Set.
    Note
    Note If you called the write function directly from the archive hierarchy view, the appropriate archiving set is already selected for you under Archiving Set.

    The corresponding selection criteria options for selecting the data set to be archived appear.

    Note  

    The drop down list contains all archiving sets that exist in your system. However, not all archiving sets support the central Java Archiving Cockpit functions. If this is the case, the application to which the archiving set belongs provides its own UI for scheduling archiving sessions.

  2. Selection Criteria: Enter the appropriate selection criteria for the data set you want to archive, based on your information retention policies.
    Note

    If you do not enter any selection criteria, ALL archivable data for that archiving set is archived.

  3. Technical Settings: Make the appropriate technical settings for the archiving sessions.
    1. XML Parsing: Here you can determine whether you want to parse or validate the resources that are written during the write phase. Both settings serve as safety checks to ensure that the resources are archived in an uncorrupted state.

      If you select Parse, the system checks, whether the resource is syntactically correct-well-formed. If you select Validate, the system checks the resource against the corresponding XML schema to make sure the resource is valid. You can also select Nothing. The default setting is Parse.

      Note

      In case you are archiving resources of a format other than XML, choose Nothing.

      If you have archived only XML resources without an XML schema, validation fails.

    2. Simulation: Here you determine whether the write session run is merely simulated, or if the data is actually archived. The default setting is No, meaning that data is actually archived. A simulation run (setting Yes) is recommended for test purposes.
    3. Path Extension: Here you can enter an extension to the home path to which you want the resources written. The path extension creates one or several new collections under the home path, and herewith extends the archive hierarchy. The default extension is the current date expressed in YYYY-MM-DD/, but you can enter any extension you like.

      Adhere to the following naming convention when entering the path extension:

      • The path extension field may not be empty (the field is mandatory).
      • The path extension may not begin with a slash "/".
      • The entered path may consist of several subpaths, separated by a slash. However, the extension may not contain double slashes or several slashes in immediate succession.
      • For each of the subpaths the same naming conventions apply as under Create Collection (see Create Collection under Hierarchy ).
        Tip

        For archiving set bc_xmla_sbook, the home path collection is bc_xmla_sbook. For the path extension you enter 2006-10-30/aaa/bbb/. During the write phase the system creates two new subcollections under the bc_xmla_sbook home collection and writes the resources into the collection "bbb".

    4. Comment: Here you can enter a comment about the archiving session. Per default the comment "Archiving session for <archiving set>" appears in this field. You can either use this comment or edit it to fit your requirements.
  4. Schedule Settings: Here you have the choice between starting the write session immediately or scheduling it for a later point in time, by specifying a date and time.
    Note

    The time you enter under Time, is based on the time zone of the application system. However, the format of the time you enter is based on the settings of your browser.

    Note

    For more advanced scheduling options use the Advanced Scheduling of Archiving Jobs link under Related Tasks on the right side of the screen. For more information on job scheduling see SAP NetWeaver Scheduler for Java .

    If you check the Start Delete Phase Automatically option, the delete session is automatically started immediately after the write session has been completed. Per default this option is checked. If you prefer to start the delete phase manually at a different time, you must uncheck this option.

  5. Save Parameters (Optional): After you have entered the desired parameters, you can save them by choosing the Save Parameters push button. A dialog screen appears. Enter a name and a description for your parameter set and choose Save. It now appears in the drop down list of Available Parameter Sets for reuse during subsequent write sessions.

    You can also change the information for a specific parameter. After you have done so, choose Save Parametersagain.

  6. Delete Parameters (Optional): If you no longer need a certain parameter, select it from the dropdown list  of Available Parameter Sets and choose Delete Parameters. This permanently deletes the parameter you chose.
  7. Start Write Session: After you have entered the appropriate selection criteria and technical parameters, choose Start Write Session. You can check the progress of the archiving session in the Archiving Monitor function.
Result

You have completed the first phase of an archiving session, the write phase. The archiving sessions are now visible in the archive hierarchy and have the status "incomplete".