UPDATE (UP)

The UPDATE function updates records in place that have been altered with action parameters such as EDIT or REPL. Use UPDATE to make permanent changes to an existing data set rather than to a copy of that data set. The OUT parameter is ignored when used with the UPDATE function.

You can use the optional hardcopy print parameters, DUMP or PRINT, to produce a report of your changes. You can preview a report of your changes by first using a printing function (such as DUMP, LIST, PRINT, FPRINT, or VPRINT) with your EDIT and REPL change parameters. Then, if all changes look good, change the printing function to UPDATE and resubmit the job to apply the changes.

When using the FORM=JCL parameter with the PRINT function, extra lines maybe added on the output. Be aware that these additional lines will not be added during an update function.

Warning

File-AID allows multiple update access on a data set when the input file is allocated with DISP=SHR. To avoid updates to a data set by more than one user at the same time, use DISP=OLD in the JCL.

When the UPDATE function is used on a PDS, a member or group of members can be specified with the MEMBER or MEMBERS parameters. To specify one or more specific members, use the MEMBER parameter. The entire data set is read for update when MEMBER or MEMBERS are not used. After UPDATE is executed, the number of updated members and records are listed on the function statistics lines printed on the SYSPRINT dataset.
 

Important

  • The UPDATE function requires that a parameter be specified on the first control card.
  • To process multiple conditional updates (IF REPL, IF EDIT), use the ALL function modifier (UPDATEALL(UA)). See ALL (A).
  • The OUT parameter is not ignored when used with an IF.
  • The UPDATE function is not supported for:
    • Concatenated data sets
    • PDSE load libraries.
    • VSAM LDS or z/OS UNIX zFS files
    • Files with LRECL=X

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*