Page History
7.78.1 INSERT Parameters
|
|---|
Specifies either the field(s) that are to be inserted into the file or the name of a group that specifies the field(s) to be inserted.
...
It is strongly recommended that the special values *ALL, *ALL_REAL or *ALL_VIRT in parameter FIELDS be used sparingly and only when strictly required. Inserting fields which are not needed invalidates cross-reference details (shows fields which are not used in the function) and increases the Crude Entity Complexity Rating of the function pointlessly.
|
|---|
Refer to Specifying File Names in I/O commands.
|
|---|
Specifies the name of a field that is to receive the "return code" that results from the I/O operation.
...
For values, refer to I/O Return Codes.
|
|---|
Specifies what action is to be taken if an I/O error occurs when the command is executed.
...
If none of the previous values are used you must nominate a valid command label to which control should be passed.
|
|---|
Specifies the action to be taken if a validation error was detected by the command.
...
The *LASTDIS is valid even if there is no "last display" (such as in batch functions). In this case the function will abort with the appropriate error message(s).
When using *LASTDIS the "Last Display" must be at the same level as the database command (INSERT, UPDATE, DELETE, FETCH and SELECT). If they are at different levels e.g. the database command is specified in a SUBROUTINE, but the "Last Display" is a caller routine or the mainline, the function will abort with the appropriate error message(s).
The same does NOT apply to the use of event routines and method routines in Visual LANSA. In these cases, control will be returned to the calling routine. The fields will display in error with messages returned to the first status bar encountered in the parent chain of forms, or if none exist, the first form with a status bar encountered in the execution stack (for example, a reusable part that inherits from PRIM_OBJT).
|
|---|
This parameter is redundant. Its value has no effect.
...
The only other allowable value is *YES.
|
|---|
Specifies the name of a field in which the relative record number of the record inserted should be returned.
...
For further information refer also to Load Other File in the Visual LANSA Developers Guide.
|
|---|
Indicates whether the I/O operation should actually be performed or only "simulated" to check whether all file and data dictionary level validation checks can be satisfied when it is actually performed.
...
*YES indicates that the I/O operation should be simulated to verify that all file and data dictionary level checks can be satisfied. The database file involved is not changed in any way when this option is used.
|
|---|
This parameter was made redundant in LANSA release 4.0 at program change level E5.
...
For the implications of using commitment control on the IBM i, refer to Commitment Control in the LANSA for i User Guide.
Portability Considerations | If using Visual LANSA, refer to Commitment Control in the LANSA Application Design Guide. |