HP 3000 Manuals HP 3000 Manuals
The Mailutil Utility
Use the Mailutil Utility to:
* Update your Local Database
* Apply for Remote Updates
* Run Batch Configuration
You only use the Mailutil Utility once the initial HP Desk databases have
been built using the Configurator.
The MAILUTIL program can be run with a batch job, for all operations
except Option 7 (Library archive), which requires that the program is run
interactively.
Running Mailutil
To run Mailutil you need either System Administrator capability or to log
on as MGR.HPOFFICE,MAILDB.
Type MAILUTIL to display the Main Menu.
____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) Main Menu 06/09/92 1341 |
| Computer LONDON |
| |
| Please Select One Of The Following: |
| |
| 1 Store users onto a file |
| 2 Restore users from a file |
| 3 Run the batch configuration |
| 4 Change a local user's name |
| 5 List database information in batch format |
| 6 Delete users on a remote sublocation |
| 7 Library archive tape maintenance menu |
| 8 Leave MAILUTIL |
| |
| Please type a number to indicate your choice. |
| |
| MAILUTIL > |
| |
| |
____________________________________________________________________________
The Mailutil Main Menu
Select from the following options:
Options 1 and 2 primarily to transfer users and their data from one
mailnode to another, along with their "long-term" data
- all the items from their Work Area, List Area, Filing
Cabinet, Calendar and their password.
Option 3 to apply the contents of a batch configuration file to
the databases.
Option 4 to change a local user's name. This is useful if a
user changes their name (they may get married) or to
correct spelling mistakes.
Option 5 to store parts of your Local and Global Databases to a
file in batch configurator format. This file can then
be used to configure a new computer.
Option 6 to delete all users from a specified remote node. They
can be replaced by restoring a new list of users of
that node, created on the remote computer using Option
5 of the Mailutil utility.
Option 7 only if you have HP File/Library installed as part of
your HP Desk system. It allows you to access
information stored on tapes produced using the HP
File/Library Archive utility. How to use this utility
is explained in the manual HP File/Library
Administration.
Output from the Mailutil utility is sent to the file MAILPRNT. This can
be redirected to the screen using the file equation:
FILE MAILPRNT = $STDLIST
Each of the Mailutil options are described below in more detail:
Storing and Restoring User Data
Use Option 1 to store single users by name or by a whole mailnode. Store
to a new file, or by appending to an existing disk file. The default
device for the store/restore files is TAPE. The device DISC may be
substituted for TAPE using a file equation of the form:
FILE <filename>;DEV=DISC;REC=128,32,F,BINARY;DISC=10000,32,1
Example of Storing Users to a File on a Disk
The file in which the information is to be stored is named ARCH01. Any
existing contents of ARCH01 are to be overwritten. Three users from
USCORP/AD are to be stored, and all the users at mailnode USCORP/LE are
to be stored.
The Delete the file contents ? (YES/NO) >> prompt does not appear if you
are storing to tape, or if the disk file is empty.
____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) User Store 06/09/92 1341 |
| Computer LONDON |
| |
| MPE file name for user store >> ARCH01 |
| |
| Delete the file contents? (YES/NO) >> YES |
| |
| User >> Joel Binford/USCORP/AD |
| User >> Clare Paice/USCORP/AD |
| User >> Bob Yano/USCORP/AD |
| User >>/USCORP/LE |
| User >> // |
| |
| 5 users stored |
| |
| End of User Store |
| |
| Press <RETURN> to proceed >> > |
| |
| |
____________________________________________________________________________
Using Mailutil Option 1
When restoring users from a file (Option 2), you must specify an existing
mailnode, onto which all users should be restored. Any users who already
exist on the target database are not restored.
Example of Restoring Users from a File
Users are then transferred from the file to their new mailnode. In the
example below the target mailnode is MANF1/AD.
____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) User Restore 06/09/92 1341 |
| Computer CHICAGO |
| |
| MPE file name for user restore >> ARCH01 |
| |
| Target mailnode >> MANF1/AD |
| |
| Users restored: |
| COLLINS,SHELLEY/MANF1/AD |
| HAGAR,JOHN/MANF1/AD |
| POINDEXTER,RON/MANF1/AD |
| SLOANE,MARK/MANF1/AD |
| |
| Users not restored: |
| PATTERSON,ANN - already exists |
| |
| End of User Restore |
| |
| Press <RETURN> to proceed >> > |
| |
____________________________________________________________________________
Using Mailutil Option 2
If the file BCREPORT.MAILDB.HPOFFICE exists or is file-equated, when a
user is stored Mailutil writes a record in batch configuration format to
delete that user. Similarly when a user is restored a record is written
to add that user.
A log file of the actions performed is printed at the system printer.
Running theBatch Configurator
Run the Batch Configurator using Mailutil Option 3. This allows you to
apply the contents of a batch configuration file to the databases.
The various methods of creating a batch configuration file are discussed
in Chapter 13 . The various batch configuration codes are listed in
Chapter 14 .
You are asked for the name of the file that contains the transactions to
be applied.
Once the transactions have been applied a message is displayed on the
screen telling you how many transactions have been performed and how many
have not.
____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) Batch Configurator 06/09/92 1341 |
| Computer LONDON |
| |
| MPE Batch File Name >> UPDATE2 |
| Configuring Report Complete |
| Actions performed : 5 Actions not performed : 1 |
| End of Batch Configuration |
| |
| Press <RETURN> to proceed |
| |
| |
____________________________________________________________________________
Using Mailutil Option 3 to run the Batch Configurator (1)
A report detailing the transactions successfully and unsuccessfully
applied are written to the file MAILPRNT. An explanation is given for
each transaction not applied. This report is printed on the system line
printer when you leave the Mailutil utility. An example is shown below:
_______________________________________________________________________________
| |
| |
| HPMAILUTIL Batch Configurator 06.09.92 1125 |
| Computer LONDON |
| |
| BATCH CONFIGURATOR FILE : UPDATE2.MAILDB.HPOFFICE |
| Actions performed: |
| 1 Add Location UK MANF4 |
| 2 Add Node MANF4 AD |
| 3 Add User Jane HOPTROUGH / MANF4/AD |
| 4 Add User Susan REID / MANF4/AD |
| 5 Add User Hilary STEVENS / MANF4/AD |
| |
| Actions not performed: |
| 6 Add User Martin EVERETT / MANF4/AD -- DATA BASE FULL - No |
| more users can be added |
| |
| Actions performed : 5 Actions not performed : 1 |
| |
| |
_______________________________________________________________________________
Example printout when you exit Mailutil Option 3
When the Batch Configurator is run from within Mailutil the following
JCWs will be set to indicate the success of the run:
MUGOODACT: indicates the number of actions performed
successfully.
MUBADACT: indicates the number of actions performed
unsuccessfully.
Changing aUser's Name
You can change a local user's name using Mailutil Option 4. If you type
a name which is not recognized as that of a local user, a message will be
displayed which tells you so, and you are prompted for a name again.
Once you type in a recognized name, you are prompted for the new name. A
message always informs you of the successful change of name.
If a native Database is installed and the user has a native name, it is
the USASCII user name used for mailing purposes that is changed by this
facility. Any native name(s) and associated language ID(s) transfer to
the new USASCII user name when the change is processed.
You can only change a user's name, not their mailnode. If it is
necessary to change the mailnode too, you either:
* Store and restore the user using Mailutil.
* Use the Rename User batch configuration transaction.
The procedure for changing a user's name is shown below.
____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) User Name Change Facility 06/09/92 1341 |
| Computer LONDON |
| |
| User's name to change: Hazel Critchly |
| I cannot find a LOCAL user with that name. |
| |
| User's name to change: Hazel Critchley |
| New name for user: Hazel McBride |
| |
| User name successfully changed from Hazel CRITCHLEY / EUCORP/AD to |
| Hazel MCBRIDE. |
| |
| Press <RETURN> to proceed >> > |
| |
| |
____________________________________________________________________________
Example procedure for changing a user's name using Mailutil Option 4
Listing the Databaseto a File
Use Mailutil Option 5 to store your Database Directory in a file in batch
configuration format. This can be used to update one HP Desk system with
a list of local users onto another, or to configure a new HP Desk system.
Where a native Database is installed, native user names and language IDs
are also stored.
The name of the file in which you store the information chosen must have
the correct syntax for MPE filenames. If the file already exists you are
prompted to confirm that the list can be appended to that file. If the
file does not already exist, the Mailutil utility creates it with a
default size of 1024 sectors. If this is too small, build a file of the
correct size beforehand. Use the MPE BUILD command. For example:
BUILD filename;REC=-80,,F,ASCII;DISC=15000,20,1
When you confirm this, the list is written to the file and a message
confirms successful conclusion of the procedure.
___________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) List of Local Users 06/09/92 1341 |
| Computer LONDON |
| |
| Name of MPE file to receive database: DBDUMP |
| List just local nodes and users? YES |
| |
| Successfully listed to MPE file DBDUMP. |
| |
| Press & (RETURN) to proceed >> > |
| |
| |
___________________________________________________________________________
Example Listing to MPE file using Mailutil Option 5
If an error message is displayed, you may have input an invalid file
reference. Press <RETURN> to proceed is displayed. You must then press
Return and select Option 5 again.
Deleting Users froma Remote Node
Use Mailutil Option 6 to delete users from a remote mailnode.
If a Native Database is installed, any native names and language IDs
configured for deleted users are removed from the Native Database.
If you type in a non-existent mailnode, an error message is displayed
telling you that the node name does not exist. The prompt Press <RETURN>
to proceed appears. Press Return, the Main Menu is displayed and you
select Option 6 again.
When you supply a recognized mailnode, all the users on that mailnode are
deleted. Once completed, a screen message informs you that the task has
worked successfully.
_____________________________________________________________________________
| |
| |
| MAILUTIL (B.05.00) Delete User From A Remote Node 06/09/92 1341 |
| Computer LONDON |
| |
| Remote sublocation to delete users: SALE2/AD/PC |
| |
| All users on remote sublocation SALE2/AD/PC successfully deleted. |
| |
| Press <RETURN> to proceed >> > |
| |
| |
_____________________________________________________________________________
Using Mailutil Option 6 to delete users from a remote mailnode.