UCOPY and UCPYRNG

The UCOPY API copies a URL from one base file record to a different base file record. The UCPYRNG API copies all of the URLs from one base file record to a different base file record. For both APIs, the target base file record must be in the same file as the source base file record. If you want to copy URL records from a record in one file to a record in a different file, use URCREATE and USTORE to create the URL records in the new file.

The base record that is current when UFNDBEG is called is used as the source or "from" base record until either all of the URLs have been retrieved (for example, URLCOM-NOTFOUND DCOM@NOTFOUND is true) or UFNDBEG is called again.

The base record that is current when UCOPY or UCPYRNG is called is used as the target or "to" base record.

When D<Prefix>@U@DTUSR = 1, the D<Prefix>@U@CRTDT, D<Prefix>@U@CRTTM, D<Prefix>@U@MODDT, and/or D<Prefix>@U@MODTM fields in the new URL records will use the values from those fields in the URLs being copied. If D<Prefix>@U@DTUSR is not 1, then those fields will be set to the current system date or time as appropriate.