MPE/iX System Utilities Reference Manual > Chapter 4 BULDACCT

BULDACCT Operation

	MPE documents
	Complete PDF
	Table of Contents
	Index

To invoke BULDACCT and use the utility interactively, enter:


  BULDACCT

The utility responds with the BULDACCT: prompt, where you enter options from the list shown in Table 4-1 "BULDACCT Processing Options" You may use a maximum of 80 characters in the command line.

Or, you may invoke BULDACCT and enter options when you issue the command, like this:


  BULDACCT;INFO=" ... "

In this format, you insert options from the list shown in Table 4-1 "BULDACCT Processing Options" in the ;INFO string. You may use a maximum of 240 characters.

The processing options for the BULDACCT utility are shown in Table 4-1 "BULDACCT Processing Options". The capital letters denote keywords and the lower case letters denote user selected names.

Table 4-1 BULDACCT Processing Options

Option	Description
`%HELP`	displays detailed information about the options
`%QUIT`	quits the interactive prompt
`[acct_list]%NODIRS`	prohibits migration of any hierarchical directories to `BULDJOB1`
`[acct_list]%ROOT`	migrates hierarchical directories immediately under ROOT ("/")
`[acct_list]%NOROOT`	prohibits migration of the ROOT hierarchical directories to `BULDJOB1`
`acct_list%VSACCT=user_set`	migrates accounts and groups to the user_set volume set
`acct_list%VS=user_set`	migrates only the groups to the user_set volume set
`acct_list%UV[=user_set]`	selects accounts with at least one group on any non-system volume set
`acct_list%FROMVS=home_volume_set_name`	specifies account list with the home volume set as a selection criteria

The BULDACCT utility produces two job files: BULDJOB1 and BULDJOB2, which you use in the following way:

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.

BULDACCT always creates two files, BULDJOB1 and BULDJOB2, even if only one is needed.

CAUTION: If the destination system already contains user, group or account names that existed on the source system, BULDJOB1 will change their attributes to match those of the source system. If the destination system already contains hierarchical directories that existed on the source system, BULDJOB1 will change the ACDs to match the source system.

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.

Log on as manager.sys and store all the files in the selected account:
```
  STORE @.@.GYPSY;;SHOW
```
Run BULDACCT with the VSACCT option to create job files BULDJOB1 and BULDJOB2:
```
  RUN BULDACCT;INFO="GYPSY%VSACCT=target_vol_set"
```
Close system level UDC's residing in the GYPSY account (if any):
```
  SETCATALOG udc_file;SYSTEM;DELETE
```
Remove the account from its existing location and make sure there is not a GYPSY account on your target_vol_set:
```
  PURGEACCT GYPSY
  PURGEACCT GYPSY;ONVS=target_vol_set
```
Rebuild the account, group and user directory structure for target_vol_set:
```
  STREAM BULDJOB1
```
Restore all GYPSY account files, making sure that the files whose creators have been purged are also restored:
```
  RESTORE ;@.@.@;SHOW;VOLSET=target_vol_set;CREATE=CREATOR
```
(You may wish to add ;OLDDATE to this command to preserve the modify, access and create dates.)
Reset all user and account level UDC's:
```
  STREAM BULDJOB2
```
If a system level UDC was uncataloged in step 3 then set it again:
```
  SETCATALOG udc_file;SYSTEM;APPEND
```

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:

Logon as manager.sys and store all the files in the GYPSY account:
```
  STORE @.@.GYPSY;;SHOW
```

Issue the BULDACCT command with the VS option:


  RUN BULDACCT;INFO="GYPSY%VS=target_vol_set"

Unset system level UDC's in the GYPSY account:
```
  SETCATALOG udc_file;SYSTEM;DELETE
```
Remove the GYPSY account from the system volume set:
```
  PURGEACCT GYPSY
```
Rebuild the directory structure for target_vol_set:
```
  STREAM BULDJOB1
```
Restore files to the GYPSY account; making sure that the files whose creators have been purged are also restored.
```
  RESTORE ;@.@.@;SHOW;VOLSET=target_vol_set;CREATE=CREATOR
```
(You may wish to add ;OLDDATE to this command to preserve the modify, access and create dates.)
Reset all user/account level UDC's:
```
  STREAM BULDJOB2
```
If a system level UDC was unset in step 3 reset it:
```
  SETCATALOG udc_file;SYSTEM;APPEND
```

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:

Issue the BULDACCT command (without the ;INFO string) and, at the prompt, enter %HELP
Enter %HELP in the ;INFO string as follows:
```
  RUN BULDACCT;INFO="%HELP"
```

Chapter 4 BULDACCT

Chapter 5 DISCFREE