Visual RPG 9.0 Language Reference  

UPDATE

Modifies the last record retrieved for processing from an update disk file. 

UPDATE
File
(file name | Format Name)
Flds (field1, field2, ... , fieldn)
Err (Indicator Variable | *EXTENDED)

Parts

File

Required.  Must contain the file or record format to be updated.  For subfiles, the file name is the SubfileControl name.  The relative record number to write the record must be greater than zero and contained in the numeric variable contained in the RRNName property.

Flds

Optional.  List of field names (1 - 32,767) of the file/format that are updated.

Note  Please note that in prior versions the parameter was called Fields, and has been deprecated.  From now on, you must use Flds

Err

Optional.  Determines what the runtime will do if an error occurs while executing this command.  The following rules apply:

  • Err (Indicator Variable) - The specified Indicator is set if an error occurred.

  • Err (*EXTENDED) - A program status flag is set whose status can be checked using the %ERROR built-in function.

  • If the Err keyword is not given and an error occurs, a runtime exception will be thrown.

Remarks

If the file is a multiformat file, you cannot perform the operation using the file name, you must use the format name.

See Also

DCLDISKFILE
READ
UNLOCK