Transfers the contents of a record occurrence to a dialog's record buffer.
Elements in the object record are moved to the buffer according to the subschema view of the record.
Syntax
►►──── GET ─────┬───────────────┬─────┬────────────────────┬───── . ──────────►◄ └─ record-name ─┘ └─ error-expression ─┘
Parameters
Retrieves the record that is current of run unit. If record-name is specified, current of run unit must be an occurrence of the named record type.
Record-name must be specified, unless the record or one of the record's elements is named explicitly somewhere in the dialog's process code, or the record is associated with the dialog as a map record.
Specifies the status codes that are returned to the dialog.
Usage
Considerations
If autostatus is not in use, a dialog's error-status field indicates the outcome of a GET command:
|
Status code |
Meaning |
|---|---|
|
0000 |
The request was executed successfully |
|
0508 |
The object record is not in the dialog's subschema |
|
0510 |
The dialog's subschema specifies an access restriction that prohibits retrieval of the object record |
|
0513 |
Run-unit currency was not established or was nullified by a previous ERASE command |
|
0518 |
The record retrieved was not bound. The record or one of the record's elements must be named explicitly somewhere in the dialog's process code or the record must be associated with the dialog as a map record |
|
0520 |
The current record of run unit is not the same type as the named record |
Further Considerations
Example
The following example illustrates the use of the GET command to move the CUSTOMER record that is current of run unit to the dialog's record buffer:
GET CUSTOMER.
|
Copyright © 2014 CA.
All rights reserved.
|
|