How to use UCLIN

UCLIN is used to update the entries in the SMP/E database, just as the SPZAP utility is used to update the system libraries. You can do the following tasks:

Add new information
Delete existing information
Replace existing information with new information

Some UCLIN functions will not work for certain entries or data sets. The topics on the UCLIN command in SMP/E for z/OS Commands and SMP/E data set entries in SMP/E for z/OS Reference provide detailed information about which entries may be modified for each data set, what data within each entry may be modified, and the exact syntax for each entry and data item.

The general format for UCLIN statements is:

SET     BDY(xxxxxxx)        /* Set to correct zone.     */.
UCLIN                       /* Marks start of UCLIN.    */.
  …                       /*   UCL                    */
  UCL statements            /*   statements             */
  …                       /*   to make modifications. */
ENDUCL                      /* Marks end of UCLIN.      */.

The general format of each UCL statement is as follows:

ADD|REP|DEL                 /* Type modification        */
   type(name)               /* Entry type and name      */
   operand                  /*                          */
   operand                  /*     Optional             */
   operand                  /*     operands             */
   operand                  /*                          */
                            /* End of one UCL statement */.

Where:

ADD|REP|DEL

Specifies the action to be taken on the entry or operands specified.

In general, ADD means add the entry or operand only if it is not already present; REP means replace the operand if it is already present, otherwise add it; and DEL means delete the entry or operand if it exists. For a more detailed description of the functions provided by ADD, REP, and DEL, see the topic on the UCLIN command in SMP/E for z/OS Commands.

type(name)

Specifies the entry type (such as MOD, MAC, ORDER, SRC, data element type, SYSMOD) and name of the entry (such as GIMMPDRV, HELP, ORD000034, MYSRCMOD, MYCLIST, UR12345).

operand

Specifies the individual data items in the entry that are to be modified.

The data items can be:

Single operands, such as RENT or REUS or COPY
Single value subentries, such as DISTLIB(AOS12), where only one value can be placed within the parentheses
Multiple value subentries, such as LMOD(LMOD01,LMOD02,LMOD3) or MAC(MAC01,MAC02), where more than one value can be specified within the parentheses