Copied Code Parameters › =DROP Clause

=DROP Clause

Purpose

Eliminates one or more of the following CA Culprit parameters from inline and copied code:

Syntax

      Col
      1
      ▼
►►─── =DROP ─┬─────────────┬──┬────────────────────────┬──────────────────────►
             └┬─ INput ───┬┘  │ ┌────────────────────┐ │
              └─ FilCard ─┘   └─▼─ REC = field-name ─┴─┘

 ►─┬───────────────────────────────────────┬─┬──────────────────────────────┬─►◄
   │ ┌───────────────────────────────────┐ │ │ ┌──────────────────────────┐ │
   └─▼─ Type = ─┬ id ───────────────────┬┴─┘ └─▼─ Cnst = work-field-name ─┴─┘
                └ ( start-id, end-id ) ─┘

Syntax Rules

=DROP

Identifies an =DROP clause. Within each =MACRO parameter, =DROP clauses are processed before any =CHANGE clauses.

INPUT

Eliminates an INPUT parameter in copied or inline code. The user must supply an alternative INPUT parameter before the =MACRO parameter.

REC = field-name

A keyword expression that eliminates the REC parameter that defines the specified field in copied or inline code. Field-name must be specified as it appears on the REC parameter.

TYPE =

A keyword expression that suppresses delivery of all parameters that contain the specified parameter ID or that fall within the range of specified parameter ids, as follows:

id

Specifies a valid CA Culprit parameter type, as follows:

• A SORT parameter
• An OUTPUT (OUT) parameter
• A title (3 or T) parameter
• An edit parameter in the form abcccc, where a identifies the type of edit parameter, that is, 4 (H), 5 (D), or 6 (S); b identifies an optional edit line number in the range 1 through 8; and cccc identifies an optional column position
• A process parameter in the form abbb, where a identifies the type of process parameter, that is, 7 (I) or 8 (B); and bbb identifies an optional sequence number

Each inline or copied parameter, starting with column 4, is compared to the value of id for the length of id. When a match occurs, the inline or copied parameter is eliminated.

Note: If a process parameter with a sequence number is dropped, any process parameters that immediately follow and that do not specify sequence numbers are also dropped.

start-id, end-id

Specifies a range of edit or process parameters, enclosed in parentheses. The length of both values must be the same. A comma or at least one space must separate the two range values.

Each inline or copied parameter, starting with column 4, is compared with the range of values for the length of a range value. If the inline or copied parameter falls within the range of values inclusive, the parameter is eliminated.

CNST = work-field-name

A keyword expression that suppresses delivery of the specified work field defined on a work field parameter or on an implied subscript parameter. Other field names defined on the same work field parameter are retained.

Usage

The following coding considerations apply to the =DROP clause:

• =DROP is coded starting in column 1; =DROP instructions can continue from one line to the next. An asterisk (*) is required in column 1 of each continuation line.
• An =DROP clause is limited by one of the following conditions:
  • A maximum of 400 characters
  • A maximum of 100 keywords, delimiters, and operands.

    Note: Within each =MACRO parameter (that is, =MACRO and any associated parameters), a maximum of 20 keyword expressions (that is, REC=, TYPE=, CNST=, OLD=, and NEW=) is permitted. Each occurrence of a keyword expression must appear entirely on one line.

• An =DROP clause can appear one or more times within an =MACRO parameter.