Using the STOW Macro to Update the Directory

When you add more than one member to a PDSE, you must issue a STOW macro after writing each member so that an entry for each one will be added to the directory. To use the STOW macro, DSORG=PO must be specified in the DCB macro.

You can also use the STOW macro to add, delete, replace, or change a member name in the directory. The add and replace options also store additional information in the directory entry. When you use STOW REPLACE to replace a primary member name, any existing aliases are deleted. When you use STOW DELETE to delete a primary member name, any existing aliases are deleted. STOW ADD and REPLACE are not permitted against PDSE program libraries.

The STOW INITIALIZE function allows you to clear, or reset to empty, a PDSE directory, as shown in Figure 1:

Figure 1. STOW INITIALIZE Example

         OPEN    (PDSEDCB,(OUTPUT))       Open the PDSE
         ...
         STOW    PDSEDCB,,I               Initialize (clear) the PDSE directory
         ...
PDSEDCB  DCB     DSORG=PO,MACRF=(W), ...  PDSE DCB

Issuing the STOW macro synchronizes the data to DASD. See Using the SYNCDEV Macro to Synchronize Data for more information about synchronizing data, and STOW—Update the Directory for more information about using the STOW macro.