The library for the input list must be a valid model library.
A value other than *MDLLIB for FRMMDLLST may result in the library list being changed during execution of the command. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution.
The FRMMDLLST must exist prior to running the command. The target list will be created if it does not already exist.
The LSTOPT parameter will be ignored if the target list does not already exist.
The refreshing of list entries is always by name. That is, the details for each entry are ascertained by attempting to find the object by name in the model object file of the target model. If the object cannot be found, the entry in the input list is flagged in error and the object is not copied to the target list.
If the object already exists in the target list, no action is taken to refresh the entry.
The refresh surrogate number option (*RFSSGT) refreshes the surrogate number, object type, object attribute, owner surrogate and owner name of the new object entry in the target list.
The completion message for this command includes a count of the number of records that already existed in the target list, the number of records copied and the number of errors, where objects from the input list could not be found in the target model.
If any errors were encountered, a diagnostic is sent for each one indicating the reason for the error and at the end of processing an escape message is sent, for which developers may monitor.
