Process Parameters › Assignment Operations

Assignment Operations

Purpose

Assign a value contained in a literal or variable field to either a work field or a CA Culprit reserved field.

MOVE operations transfer information to a work field or to the CA Culprit reserved fields PAGE and ARGn. CONVERT operations convert an alphanumeric value to a numeric value stored in a work field.

Syntax

►►─┬─ Move ─┬─ literal ───────────────┬───┬─ to ─┬─ result-field-name ─┬──────►◄
   │        └─ field-name-expression ─┘   │      ├─ ARGn ──────────────┤
   └─ CONVERT ─┬─ literal ───────────────┬┘      └─ PAGE ──────────────┘
               └─ field-name-expression ─┘

Syntax Rules

Move literal/field-name-expression

Specifies that a MOVE operation is to be performed. Literal/field-name-expression identifies the value to be moved; syntax and syntax rules for coding field-name-expression appear in User-Defined Variables earlier in this chapter.

The following considerations apply to alphanumeric and numeric values; CA Culprit treats hexadecimal values as alphanumeric:

• When an alphanumeric field or literal is moved to a result field of a different length, the following actions occur:
  • If the field or literal that is moved contains more characters than the result field, excess characters are truncated on the right.
  • If the result field contains more characters than the field or literal that is moved, the moved field is left-justified in the result field and blank spaces fill out the right side of the result field. If truncation or padding occurs, CA Culprit issues a warning message.
• When a numeric field or literal is moved to a result field that does not have the same length or number of decimal positions, the following actions occur:
  • If a numeric field is moved to a result field that contains more decimal positions, the low-order decimal positions are padded with zeros.
  • If a numeric field is moved to a result field that contains fewer decimal positions, the result is rounded to the number of decimal places in the result work field.
  • If a numeric result field cannot accommodate all significant digits of the moved field, significant digits are truncated on the left and an arithmetic overflow results. Arithmetic overflows are reported by the extended error-handling facility.

    Note: For more information, see the CA Culprit for CA IDMS Messages and Codes Guide.

PROFILE parameter options RELEASE=5 and RELEASE=6 do not handle situations that involve different numbers of characters or decimal positions in the same manner. See Error! Reference source not found., for a complete discussion of these differences.

CONVERT literal/field-name-expression

Specifies that a CONVERT operation is to be performed.

Literal/field-name-expression identifies an alphanumeric literal, work field, or input field whose value is to be converted into a numeric value. Syntax and syntax rules for coding field-name-expression appear in User-Defined Variables.

Considerations for coding literal appear below:

• Leading blanks are permitted, but the entire field must not be blank; leading blanks are treated as if they were zeros.
• A minus sign is accepted in the first (leftmost) position of the field or literal if the value is negative.
• A leading, trailing, or embedded decimal point is permitted.
• Any characters outside the range 0 through 9 produce unpredictable results.

  When an integer alphanumeric value is converted into an integer numeric value, the result is truncated or padded on the left. If a decimal point is specified for the alphanumeric value or the numeric value, the following occurs:

• If the alphanumeric value contains more decimal positions than are indicated for the result field, the result is rounded.
• If the alphanumeric value contains fewer decimal positions than are indicated for the result field, the result is padded with low-order zeros.
• If the result field is too small to hold all the significant digits, significant digits are truncated on the left and an arithmetic overflow results. Arithmetic overflows are reported by the extended error-handling facility.

  Note: For more information, see the CA Culprit for CA IDMS Messages and Codes Guide.

result-field-name

The name of a work field that receives the result of the MOVE or CONVERT operation.

In a MOVE operation, the data type of a sending field or literal must be compatible with the data type of the result field; that is, both fields must be defined as numeric or as alphanumeric. Hexadecimal literals are treated as alphanumeric values for the purposes of a MOVE operation.

In a CONVERT operation, the data type of the result field must be numeric.

ARGn

A CA Culprit reserved word that passes information to a user procedure module.

N must be an integer in the range 1 through 9. ARGn is valid only for MOVE operations and can appear only on type 7 process parameters.

Note: For more information on user procedure modules, see the CA Culprit for CA IDMS User Modules Guide.

PAGE

A system-defined numeric work field that receives a report page number.

This reserved word is valid only for MOVE operations and can appear only on type 8 process parameters. When PAGE is used in a MOVE operation, the report page number is reset. The specified value plus 1 is printed as the next page number. The value of PAGE can be printed on each page of the associated report on either the title line or a header line if PAGE is referenced on a type 4 edit parameter.