HP 3000 Manuals HP 3000 Manuals
Operation
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 . 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
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
. 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.
1. Log on as manager.sys and store all the files in the selected
account:
STORE @.@.GYPSY;;SHOW
2. Run BULDACCT with the VSACCT option to create job files BULDJOB1
and BULDJOB2:
RUN BULDACCT;INFO="GYPSY%VSACCT=target_vol_set"
3. Close system level UDC's residing in the GYPSY account (if any):
SETCATALOG udc_file;SYSTEM;DELETE
4. 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
5. Rebuild the account, group and user directory structure for
target_vol_set:
STREAM BULDJOB1
6. 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.)
7. Reset all user and account level UDC's:
STREAM BULDJOB2
8. 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:
1. Logon as manager.sys and store all the files in the GYPSY account:
STORE @.@.GYPSY;;SHOW
2. Issue the BULDACCT command with the VS option:
RUN BULDACCT;INFO="GYPSY%VS=target_vol_set"
3. Unset system level UDC's in the GYPSY account:
SETCATALOG udc_file;SYSTEM;DELETE
4. Remove the GYPSY account from the system volume set:
PURGEACCT GYPSY
5. Rebuild the directory structure for target_vol_set:
STREAM BULDJOB1
6. 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.)
7. Reset all user/account level UDC's:
STREAM BULDJOB2
8. 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"