Lowest level entry

For this entry level, the function modules generated for data processing are available.

Call the function module VIEW_MAINTENANCE_LOW_LEVEL. Knowledge of the view or table-specific function module name for the data processing is not necessary, as it is put together by the system and then called.

Pass the name of the table or view and the desired function when calling. You must evaluate the returned user commands.

You must also perform all the activities which the maintenance dialog otherwise performs:

  • Authorization check
  • Lock
  • Fetch and format the required information from the Dictionary
  • Select, edit and save the data
  • Restrict the data selection in dialog for subset fields
  • Dynamic interface modification (menus and functions)

Interface description

Import parameters

  • FCODE
    desired function.
    • 'READ' Read the data from the DB
    • 'EDIT' process data
    • 'RDED' Read and edit
    • 'SAVE' Write the data to the DB
    • 'ORGL' Re-set all marked entries
    • 'ORGD' Re-set one entry
  • VIEW_ACTION
    Action (Display, maintain or transport).
    see function module VIEW_MAINTENANCE_CALL documentation
  • VIEW_NAME
    Name of the table or view.
  • CORR_NUMBER
    Change request number for the changes made.
    see function module VIEW_MAINTENANCE_CALL documentation

Export parameters

  • LAST_ACT_ENTRY
    Index of the record in table EXTRACT on which the cursor was positioned.
  • UCOMM
    Last maintenance dialog user command.

You must process the following commands yourself on this entry level:

    • 'SAVE' Save the data in the DB
    • 'ORGL' Re-set all marked entries in the display table (EXTRACT)

If this command is returned, you must call the lowest entry level function module again with this command and then with the previous command. You do not have to write your own re-set program.

The lowest entry level was called with the module VIEW_MAINTENANCE_LOW_LEVEL and the function 'EDIT'. The user has called the function 'ORGL'. The module VIEW_MAINTENANCE_LOW_LEVEL has now to be called first with the function 'ORGL'. The module runs in the background. Then the module VIEW_MAINTENANCE_LOW_LEVEL has to be called again with the function 'EDIT'.

    • ‘ORGD' Re-set the entry in the display table (EXTRACT) header.

see command 'ORGL' for command processing.

    • 'ANZG' Change action: Change -> Display
    • 'AEND' Change action: Display -> Change
    • ‘ENDE' End processing
    • ‘BACK' Return to calling position
    • 'ATAB' Fetch another table or view
      This field also contains the commands which were realized in user modules in the maintenance screens.
  • UPDATE_REQUIRED
    Flag: Entries changed, Save required.

The user has made changes which make it necessary to save the data before leaving the maintenance dialog.

Tables

  • CORR_KEYTAB
    Table with the keys of the entries to be transported. The table is only used in transport mode.

Structure: INCLUDE STRUCTURE E071K

  • DBA_SELLIST
    Selection conditions for the database access.

Structure: INCLUDE STRUCTURE VIMSELLIST see function module VIEW_MAINTENANCE _CALL documentation.

All data which are read in for the table processing or are created during maintenance, are stored in the internal table TOTAL at run time.

The table TOTAL has the structure:

    • INCLUDE STRUCTURE <view name> or <table name>
    • INCLUDE STRUCTURE VIMFLAGTAB

See also the function module VIEW_MAINTENANCE_CALL documentation.

  • DPL_SELLIST
    Selection conditions for the display of part of a work area on the maintenance screens.

Structure and documentation as DBA_SELLIST

The data are stored at run time in the internal table EXTRACT. The table EXTRACT always only contains the table records which have been filtered out of the table TOTAL as a result of a user action.

The table EXTRACT has the same structure as the table TOTAL

See also the documentation of the function module VIEW_MAINTENANCE_CALL

  • EXCL_CUA_FUNCT
    dynamically activated interface functions.

Structure: INCLUDE STRUCTURE VIMEXCLFUN, see function module VIEW_MAINTENANCE_CALL documentation.

  • TOTAL
    Data table, contains all data which have been read in and changed, deleted or added during the processing.

Structure:

    • INCLUDE STRUCTURE <view name> or <table name>
    • INCLUDE STRUCTURE VIMFLAGTAB

All data which are read in for the table processing or are created during maintenance are stored at run time in the internal table TOTAL. After the function has been carried out, the table gets a processing flag for each record processed.

  • EXTRACT
    Data display work table.

Structure as table TOTAL

The data are stored at run time in the internal table EXTRACT. The table EXTRACT always only contains the table records which have been filtered out of the table TOTAL as the result of a user action. After the function has been performed, the table contains all the data found by the last selection for display.

  • X_HEADER
    Control block table for the table or view.

Structure: INCLUDE STRUCTURE VIMDESC

The table contains the Dictionary header information about the table or view, such as sub-set, selection conditions, maintenance status, delivery class. The table also contains the generation information and event time information for the table or view. You can fill this table with the function module VIEW_GET_DDIC_INFO.

  • X_NAMTAB
    Control block table for the fields of the table or view.

Structure: INCLUDE STRUCTURE VIMDESC.

The table contains the field information about the table or view, from the dictionary such as the position of the field in the structure, key information and the maintenance characteristics of the field. You can fill this table with the function module VIEW_GET_DDIC_INFO.

Exceptions

  • MISSING_CORR_NUMBER
    Correction number missing
  • SAVING_CORRECTION_FAILED
    Error while saving the entries in a change request.