Previous Topic: 4.2.4.3.8 File Sequence Statement (SEQUENCE)

Next Topic: 4.2.4.3.10 Timespan Modification Statements

4.2.4.3.9 Data Element Retention Statement (KEEP/DROP)

MSI has simplified the process of activating and deactivating
data elements through the use of the new KEEP and DROP
statements.
 
KEEP and DROP can be applied either Globally (affecting all
timespans) or locally (affecting individual timespans).  The
following rules apply when using KEEP/DROP:
 
o  All sequence (user or timespan) elements are always kept,
   and cannot be dropped.
 
o  If there is no KEEP/DROP statement, the default action is
   to KEEP.
 
o  Dropping a data element from the detail timespan causes
   MSI to drop it in all timespans.
 
o  KEEP/DROP statements for individual timespans override the
   Global definition.
 
 STATEMENT FORMAT
 
This keyword is coded with the KEYWORD starting in column 1,
free-form, and continuing through column 72.  Continuation is
not supported, although multiple KEEP/DROP statements can be
specified.  The following describes the format and coding
rules for the KEEP/DROP statement.
 
   KEEP   elements ...
   DROP    |
    |      +---ELEMENTS - The names of elements which are
    |                     to be kept or dropped. Maximum of
    |                     eight characters each.
    |
    +----keyword- Statement keyword
 
STATEMENT OPTION DEFINITIONS
 
  keyword - Defines the data elements that will be kept or
            dropped from the file.  KEEP and DROP can be used
            in the same file.
 
            ELEMENTS - Specifies the name of the data
                       elements.  Generic specification is
                       allowed, and is indicated by the
                       colon(:) character.
 
STATEMENT EXAMPLES
 
KEEP BUSYTIME CPU:  GOPHER
DROP TUNA:  WINPROXY