Operation

Table 4-1 BULDACCT Processing Options

• To create users, hierarchical directories, groups and accounts on the destination system, move BULDJOB1 to that system and stream it.

• To create user-defined command files (UDCs) on the destination system, first move all of the files using the STORE and RESTORE commands (or, if the destination system is on a network, you can directly copy the UDC files.) Then, to set system, account and user level UDC's, move BULDJOB2 to the destination system and stream it.

Recreating the complete directory structure

To recreate the entire directory structure of the source system and set all system, account, and user level UDCs, enter:

   BULDACCT

To create the new directory on the destination system enter:

   STREAM BULDJOB1

If you wish to reset UDC's, use the :RESTORE command to restore UDC files and then enter:

   STREAM BULDJOB2

Recreating selected accounts on a new system

You may specify a selected list of accounts in the accounts list portion of the ;INFO string. For example, to select all those accounts beginning with S and all those accounts ending with P enter:

   RUN BULDACCT;INFO="S@,@P"

Then to create the new directory entries on the destination system, enter:

   STREAM BULDJOB1

Migrating root and hiearchical directories

When BULDACCT is processing individual accounts or a subset of "all accounts" ("@"), it does not process any hierarchical directories directly under ROOT ( "/"). It only processes the hierarchical directories within each of the specified accounts For example, the following command processes all groups, users and hierarchical directories in accounts GYPSY1 and GYPSY2:

   RUN BULDACCT; INFO="GYPSY1,GYPSY2" 

To prevent BULDACCT from picking up any hierarchical directories, use the %NODIRS option. To prevent BULDACCT from picking up any hierarchical directories under ROOT ("/"), use the %NOROOT option. If you use both ROOT and %NOROOT, %NOROOT has precedence.

Migrating a specific account to a non-system volume set

To migrate a selected set of accounts to a non-system volume set use the VSACCT option of BULDACCT. In this example the source computer and destination computer are the same. The basic BULDACCT syntax is:

   RUN BULDACCT;INFO="[acct_list]%VSACCT=user_vol_set"

In this example acct_list is the list of accounts to be migrated. The default account list is @ or all accounts; user_vol_set must be a valid volume set name.

The following is a sample of the exact steps you would use to migrate an account called GYPSY to a non-system volume set called target_vol_set.

Migrating groups to a non-system volume set

If a given account already exists on a non-system volume set, you may use the VS option to migrate groups of that account to that volume set. The basic BULDACCT syntax is:

   RUN BULDACCT;INFO="[acct_list]%VS=user_vol_set"

The following is an example of the exact steps you would use to migrate the groups in the GYPSY account from one volume set (system or non-system) to a user (non-system) volume set called target_vol_set:

Qualifying the account list

You can use the FROMVS option of the BULDACCT utility to specify the account list on particular volume sets. For example, to dump the directory information of all the listed accounts that have at least one group on home_volume_set_name, enter:

:RUN BUILDACCT: INFO="account_list %FROMVS=home_volume_set_name"

A minimum of one group linkage is required since the build account program does the scanning on the system volume set. To select all accounts on the system that have a group on some volume set, you can substitute a wild card (@) for part or all of the account list.

The complete information to rebuild the accounts, groups and users on the system, as well as the specified volume set, is dumped in the job scripts. If you want to migrate these accounts to a different volume set, use the VSACCT option in conjunction with the FROMVS option. For example, to select all the accounts which have at least one group with HOMEVS=home_volset and dump information to rebuild these accounts with all their groups on the target volset, enter:

:RUN BUILDACCT: INFO="@ %FROMVS=home_volset %VSACCT=target_volset"

You may use the UV option to select only those accounts which have at least one group on any user (non-system) volume set. For example:

   RUN BULDACCT;INFO="[acct_list]%UV=user_vol_set"

=user_vol_set is optional. If omitted, BULDJOB1 will create the directory structure in the system domain of the destination system. If user_vol_set is included, BULDJOB1 will create the directory structure in the non-system domain of the destination system. In either case, BULDACCT selects only those accounts on the source system which have a group on a user (non-system) volume set.

For example, in the following command, the account GYPSY1 has groups on a user volume, whereas GYPSY2 does not. As a result, when you stream BULDJOB1, it will create the directory only for GYPSY1.

   RUN BULDACCT;INFO="GYPSY1,GYPSY2%UV=user_vol_set"

If, in the preceding example, you omit =user_vol_set, BULDJOB1 would create the directory structure for GYPSY1 in the system domain. Since =user_vol_set is included, BULDJOB1 creates the directory structure for GYPSY1 in the non-system domain on volume set user_vol_set.

Getting help

To get information about the BULDACCT utility, you can: