Create DataArea
Use this command to create a DataArea for use with Models, ImportSpecs, and ExportSpecs. This is also used in conjunction with other commands as well, such as UPLOAD. You can also create a DataArea that you can view as a Data Grid in a Longview App.
Initially, a DataArea is created with structure only and the DOWNLOAD command must be used to populate it with data from the database. The UPLOAD command is used to send any data changes back to the database.
Note: When using the UPLOAD command, the maximum number of open DataAreas allowed at any given time is 31.
The following rules apply to the use of DataAreas created by another procedure:
- If a DataArea is created in the parent procedure, it can be used in a child procedure (i.e., a child procedure inherits all the DataAreas created in its parent(s)).
- If a DataArea is created in the child procedure, it is only visible in that procedure and all of its child procedures.
- If an inherited DataArea is deleted in the child procedure, the data will not be cleared from the memory and is still accessible from the parent procedure. However, the child procedure will lose its reference to that DataArea.
- Downloading or uploading an inherited DataArea in a child procedure has the same effect as doing so in the main procedure.
Note: For the purposes of more readily identifying DataAreas as such, it is recommended that DataArea names be prefixed with da (e.g., daBalSheet). Note that this is only a recommendation and not an actual requirement of the command.
If you use this command in conjunction with the UseInputRelatedSchedules command, the original DataArea is created along with the related DataAreas for line item details, comments, and attachments.
For information on how this command is affected by input-related schedules, see UseInputRelatedSchedules.
Syntax
CREATE DATAAREA DataAreaName USING dataspec.lvdsp
where:
- DataAreaName is the name to assign to the new DataArea.
- dataspec.lvdsp is the name of a DataSpec file.
Syntax example
CREATE DATAAREA daMaster USING Master.lvdsp
See also