Using UADSREFM and the SYNC command or subcommand of ACCOUNT

UADSREFM reads an entry from the old UADS, builds a logical copy of that entry, eliminates any wasted space, and writes the newly-formatted entry into the new UADS. The process automatically repeats for each entry in the UADS. However, UADSREFM does not reformat an entry if the user is currently logged on. It writes messages indicating which entries were not reformatted.

You can also use the UADSREFM program to change the block size of the UADS.

To reformat the UADS and broadcast data sets, execute the TMP in the background and include the following in the batch job:

The UADS reformatting program, UADSREFM.
Either the SYNC command or the SYNC subcommand of ACCOUNT.
Use the SYNC command or subcommand with the UADS operand to reformat the broadcast data set and to synchronize it with SYS1.UADS. If, for security reasons, you want to delete the IBMUSER user ID after reformatting, use the DELETE subcommand of ACCOUNT.

Figure 1 is a sample listing showing the reformatting of the UADS and the broadcast data set. For an explanation of this JCL, see Executing the terminal monitor program.

Figure 1. Reformatting the UADS and the broadcast data set

//jobname     JOB      job card parameters
//            EXEC     PGM=IKJEFT01
//SYSTSPRT    DD       SYSOUT=A
//SYSUADN     DD       DSN=old format uads,DISP=SHR
//SYSUADS     DD       DSN=reformatted uads,DISP=SHR
//SYSLBC      DD       DSN=broadcast-data-set,DISP=SHR
//SYSTSIN     DD       *
UADSREFM
ACCOUNT
SYNC UADS
DELETE (IBMUSER)
END
/*

Note: With dynamic broadcast support, the SYSLBC DDNAME is no longer required. If the SYSLBC DDNAME is not specified, the currently active broadcast data set will be used by the job. If the SYSLBC DDNAME is specified, the referenced data set will be used by the job.

The UADSREFM program saves all logon default values except for account number and procedure name. Therefore, users with full-screen logon panels may see a change in those fields after you run UADSREFM.

When a program other than UADSREFM or the SYNC command or subcommand of the ACCOUNT command is used with the UADS data set, unpredictable results may occur. If the UADS data set is damaged, run UADSREFM. UADSREFM lists the entries in alphanumeric order. The last entry listed precedes the damaged entry. You can then delete the damaged entry and add it correctly.