Procedure documentationCreating Variants for Write Program for TRTM_TPM

 

If you want to run the write program for archiving object "TRTM_TPM Positions", you need to create a variant.

In the variant, you use selection criteria to specify which positions are archived and how the write program is executed.

Procedure

  1. Select the product groups. Depending on the product groups that you have selected, selection criteria for the relevant positions appear in the lower frame.

  2. Enter the company codes.

  3. You can use the product type to restrict the positions.

  4. You can also restrict the selection using the product group.

    • Securities Positions: Security ID

    • Loan Positions: Loan Number

    • Listed Derivatives: ID Number

    • OTC Positions: Financial Transaction Number

  5. Enter the retention period end date. The system uses this date to check the minimum retention period.

  6. You can use the following indicators:

    • Check Maturity Date of Securities

      When this indicator is set (= default setting), the write program checks the maturity date of a security. When the maturity date falls after the start date of the retention period, it is not possible to archive the position.

      Exception: If a security does not have a maturity date, the system does not perform the check. Example: Stocks do not have a maturity date. Consequently, the system does not run a maturity date check on stock positions.

      If you do not set this indicator, the system does not check the maturity date, enabling you to archive positions before the maturity date. This can be useful in the case of securities that have a very long term.

      See also: Checks on Archiving Object TRTM_TPM

    • Include Interlinked Positions

      When you start the write program for archiving, you define the selection criteria for the positions to be archived. The write program finds all selected positions and creates position groups.

      There are two types of position group:

      • Complete position groups

        Position groups for which the related positions have all been selected for archiving by the selection criteria.

      • Incomplete position groups

        Position groups that, in order to become complete, must first be supplemented by positions that were not selected for archiving by the selection criteria.

      The archiving run also considers complete position groups.

      The following applies in the case of incomplete position groups:

      • When the indicator is set (= default setting), the system adds the missing positions to the incomplete position groups and then includes the now complete position group in the archiving run.

      • If this indicator is not set, incomplete position groups are not included in the archiving run.

    • Display All Errors

      • When this indicator is not set (= default setting), the system runs checks on whether a position can be archived until the first error occurs. For performance reasons, subsequent checks are not performed. Only one error message appears in the detailed log. Consequently, only one line per position is displayed in the archiving log.

      • If you set this indicator, the system performs all checks for a position and outputs all error messages in the detailed log. In this case, there can be multiple lines per position in the detailed log. However, such a comprehensive list makes it easier to analyze archiving problems. You can only set this indicator in the test mode of the write program for archiving positions.

  7. In the Processing Options, you can specify whether the program is executed in the test mode or production mode.

    • Test Mode

      In the test mode, the system only simulates the program run. No archive files are written and no data is deleted from the database.

    • Production Mode

      In this mode, the system checks whether the selected positions can be archived and then writes archive files for all position groups that can be archived. However, the system does not delete the data from the database. For this, you need to start the deletion program.

  8. Detailed Log

    You can use this field to specify whether a detailed log (using the "Complete" option) is output in addition to the summarized log when the program is executed.

    The summarized log contains each message just once. The message is accompanied by the number of objects affected and by one of these objects as an example.

    The detailed log contains all objects processed, including the related messages. If you select Without Success Message, no success messages are written in the detailed log.

    Note Note

    We recommend that you only output a detailed log when a small number of objects are processed, such as in the test mode. Otherwise, the program may terminate due to memory overflow.

    End of the note.

    If you have set the Include Interlinked Positions indicator, all positions are listed in the detailed log and their differentiation criteria, such as company code and valuation area, are also displayed. Positions belonging to a position group are separated by a line of asterisks.

  9. Log Output

    Here, you can specify whether the log is output in the list (or in the spool when the program is run in the background), in the application log, or in both locations.

    An advantage of outputting the log in the application log is that the log messages are displayed during program runtime. (Whereas log messages are generally output every 30 minutes with programs run in the background, they are output every 10 seconds when programs are run online.) Logs that are written to the list cannot be viewed until the program has finished.

    With the list output, you can opt for automatic storage of the log in a connected storage system (see Spool Parameters in job scheduling). Logs written to the application log can only be stored manually from the log display. Furthermore, logs written to the list are removed automatically when the related background job is deleted, whereas logs written to the application log have to be deleted manually.

    Note Note

    If you have opted for List for the log output, you can double-click a position to display the related position indicator.

    End of the note.

    All logs can be displayed from the archive administration by choosing Start of the navigation path Goto Next navigation step Logs End of the navigation path. For more information, see Logs.

  10. You can attach a comment to archiving runs. Comments appear as follows:

    • In the overview of the archiving runs in archive administration (transaction SARA). You can make changes to comments here.

    • In the manual selection of archive files (such as for analysis programs). The comments are intended to assist you in selecting the archive files.