DS (Local DataArea)

Section for use

All

Syntax

DS *LDA Length SeriesDSFields

DS *LDA(Id)

DS *LDA(Id(FileName))

DS *LDA(Id) Length SeriesDSFields

Description

This instruction is used to declare a LDA (Local Data Area).

It can be combined to rename the LDA or to use an external description.

The length specification is not mandatory.

• • In case the LDA is defined without a "File name", it is automatically updated at the end of the program:
    if the program does not end by a RETURN instruction, and if the indicator of the end of program is LR at the level of a program generation characteristics.

     Click here to see the various contexts for the RETURN instruction

    - RETURN (Adelia Context, C Generation)

    - RETURN (Adelia Context, RPG Generation and Visual Adelia Context)

• • In case the LDA is defined with a "File name": to update it, specify a WRITE_DTAARA instruction (DS name) or WRITE_DTAARA *LDA (RPG generation).

Note: In a development environment, Adelia uses the LDA and thus may alter its contents. If an external description is used (file name), it is mandatory to read the data area (READ_DTAARA instruction) to know its contents.

Click here for the explanation of the SeriesDSFields element.

Restrictions

In a production environment, Adelia reserves the use of the first 10 LDA characters when the Adelia menu manager or the SEU on-line help is used.

The name of the external file usable with this instruction cannot exceed 8 characters.

Example

See also the list of 4GL instructions by topic

↑ Top of page