HP 3000 Manuals HP 3000 Manuals
Operator Command Formats
This section lists in alphabetical order all the commands available. For
each command, the following format is shown:
SYNTAX shows the format of the command including any of
the required parameters.
NOTES describes the command in detail and related special
considerations.
EXAMPLE shows the command in use. Each example assumes
that the command has been issued from the console,
although this does not necessarily have to be the
case.
__________________________________________________
NOTE The times shown in the following examples are
approximate. The time taken for any given
command to be executed depends on the size of
your HP Desk system.
__________________________________________________
DISABLEMTRUCK
Dynamically disables a Master Truck.
Syntax
DISABLEMTRUCKS n
Notes
This instructs the Transport Manager to mark Master Truck n as "hung",
release the computer and mailnode from it and instruct it to shutdown.
Use this command to free a mailnode blockage when a hung truck is
detected. Optionally replace the hung truck by starting another truck
dynamically using the command STARTMTRUCKS.
When the hung truck is shutdown and its status cleared by the Transport
Manager, it is able to be restarted. In the case that the hung truck is
not shutdown or its status cleared then it is not available until the
Transport system is restarted.
The value of n ranges between 0 and 35 for Master Truck identifiers, as
they appear in the Mailstatus report.
DISABLEMTRUCK 2
Disable hung Master Truck request sent to the Transport Manager
End of program
:
MAILALTLOCSTATS
Indicates the size of various data sets and enables them to be changed if
necessary.
Syntax
MAILALTLOCSTATS
Notes
The LOCSTATS file contains details of the current size of various data
sets. The MAILALTLOCSTATS command allows you to look at the contents of
this file and alter the values, without having to purge the databases
first.
You will expect to use MAILALTLOCSTATS when the database is expanded as a
batch job. Full details of this procedure are in the installation
instructions.
You should also use this command if you expand your databases using
ADAGER or DBCHANGE. If you expand the databases in this way, the LOCSTATS
file will not reflect the actual sizes of the data sets. You can adjust
the recorded values using the MAILALTLOCSTATS command.
MAILALTLOCSTATS
The name of your Local Computer (currently NEWYORK) >>
The maximum number of COUNTRIES (currently 2) >>
The maximum number of LOCATIONS (currently 5) >>
The maximum number of SUB-LOCATIONS (currently 10) >>
The maximum number of global USERS (currently 10) >>
The maximum number of local USERS (currently 5) >>
The maximum number of Native USERS (currently 0) >>
The maximum number of COMPUTERS/GATEWAYS (currently 2) >>
The maximum number of ROUTES (currently 4)
The maximum number of DESIGNATES (currently 5) >>
The maximum number of FSC USERS (currently 1) >>
The maximum number of FSC GATEWAYS (currently 1) >>
The maximum length of Foreign Addresses (chars) (currently 64) >>
The maximum number of RESOURCES (HPSCHEDULE) (currently 1) >>
The maximum number of RESOURCE CLASSES (HPSCHEDULE) (currently 1) >>
The size of the ITEM-HEADER data set (currently 1060) }>>
The size of the ITEM -STRUCTURE data set (currently 1590) >>
The size of the ITEM-CONTENT data set (currently 850) >>
The maximum number of diary ENTRIES per user (currently 100) >>
The maximum number of diary LABELS per user (currently 20) >>
The size of the KEYWORD data set (currently 200) >>
The size of the INSERTION data set (currently 750) >>
The size of the USER-DATE data set (currently 500) >>
The size of the SIMPLE-ENTRY data set (currently 1500) >>
The size of the MAIL-ITEM-SUBJ data set (currently 500) >>
The size of the MAIL-ITEM-ENTRY data set (currently 100) >>
End of Program
:
MAILBINEMPTY
Starts the Bin Emptier process in HP DeskManagerPLUS.
Syntax
MAILBINEMPTY
Notes
The Bin Emptier is the HP DeskManagerPLUS process provided to perform
Maintenance functions. The function of the Waste Bin Emptier is to
release users Waste Baskets for deletion from the HP DeskManagerPLUS
database. This program would normally be run at the end of the day.
Users who sign on to their HP Desk accounts after the Bin Emptier process
has run, will find that their Waste Baskets appear empty. The physical
contents of their Waste Basket, however still exist on the database, but
will be deleted later by the Garbage Collector.
The Bin Emptier can be scheduled using the MAILSCHEDULE command.
MAILBINEMPTY
Start Process request sent to the HPDESK Supervisor.
End of Program
:
From/J35 MGR.HPOFFICE/HPDESK - BINEMPTY created on 30/12/92 at 0945
MAILBUILDNATIVE
MAILBUILDNATIVE allows the Native Database to be built or purged in an
existing HP Desk system without affecting the Local and Global Databases.
Syntax
MAILBUILDNATIVE
Notes
If native (non-USASCII) user names are to be used, a separate database
must be created to hold these. This database, the Native Database can be
added to an existing HP Desk system by using the MAILBUILDNATIVE command.
Use MAILALTLOCSTATS to define the maximum number of native user names you
want to cater for. If there was previously no Native Database the value
shown will be 0. After entering the new value, MAILBUILDNATIVE will
build the Native Database. A database report is displayed indicating
that this has been successfully completed it has been built.
If a Native Database was in existence and the MAILALTLOCSTATS value was
set at 0, this operation will delete the database. For a non-zero entry,
the previous database will be purged and a new one built of the
appropriate size. In either case, a warning is given that a Native
Database exists and confirmation sought that you wish to proceed.
MAILBUILDNATIVE
PAGE 1 HEWLETT-PACKARD 32215C.00.28 TurboIMAGE/3000: DBSCHEMA
WED, MAR 9, 1988, 10:41 AM (C) HEWLETT-PACKARD CO. 1978
$CONTROL NOLIST,TABLE,BLOCKMAX=1024
DATA SET TYPE FLD PT ENTR MED CAPACITY BLK BLK DISC
NAME CNT CT LGTH REC FAC LGTH SPACE
NAME-INDEX A 1 1 18 29 20 20 582 10
AL-NAME-INDEX A 1 1 2 13 20 14 183 6
USER-XSLATE D 6 2 64 72 28 14 1009 24
TOTAL DISC SECTORS INCLUDING ROOT: 52
NUMBER OF ERROR MESSAGES: 0
ITEM NAME COUNT: 6 DATA SET COUNT: 3
ROOT LENGTH: 652 BUFFER LENGTH: 1009 TRAILER LENGTH: 256
ROOT FILE NATIVE CREATED.
The HPDESK database has been successfully created
End of program
MAILCANCELABORT
Cancels a previously executed MAILUSERABORT command.
Syntax
MAILCANCELABORT
Notes
This command allows the cancellation of a MAILUSERABORT command. It will
be effective only within the time the MAILUSERABORT program has paused
before executing the abort of the users (which is 10 minutes by default).
The MAILCANCELABORT command cannot be used to stop users being aborted
during any of the following administration jobs:
* The Maintenance job
* The Mailstore job
* The Mailrestore job
* The Mailload job
* The Mailunload job
This is because the program which aborts users is being run explicitly by
these jobs and not as a process under the Supervisor.
MAILDSSLAVEOFF
Disables only the DS Slave Trucks.
Syntax
MAILDSSLAVEOFF
Notes
The MAILDSSLAVEOFF command disables DS Slave Trucks on the system, so
that any further communication from HP Desk systems will be disallowed.
On an HP DeskManagerPLUS system running NS transport, the command will
not affect NS Slave Trucks.
MAILDSSLAVEOFF
Stop process sent to the HPDesk Supervisor
End of Program
:
From/J54 MGR.HPOFFICE/HPDESK - DSSLAVE disabled on 06.06.92 at 0912
MAILDSSLAVEON
Enables only the DS Slave Trucks.
Syntax
MAILDSSLAVEON
Notes
The MAILDSSLAVEON command enables DS Slave Trucks on the system, so that
communication from HP Desk systems will be allowed. On an HP
DeskManagerPLUS system running NS transport, the command will not affect
NS Slave Trucks.
MAILDSSLAVEON
Start Process sent to the HPDesk Supervisor
End of Program
:
FROM/J45 MGR.HPOFFICE/HPDESK - DSSLAVE enabled on 06.06.92 at 0915
MAILEFTOFF
Stops the EFT Slave Truck.
Syntax
MAILEFTOFF
Notes
The MAILEFTOFF command stops the EFT Slave Trucks from bringing messages
held at an EFT gateway into HP Desk.
MAILEFTOFF
Stop Process request sent to the HPDesk Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - EFT requested to stop on 06.06.92 at 1056
10:56/#J5/26/HPDESK - EFT Slave Truck stopped
10:58/#J5/26/HPDESK - EFT stopped
MAILEFTON
Starts the EFT Slave Truck.
Syntax
MAILEFTON
Notes
The MAILEFTON command starts up the EFT Slave Truck which brings messages
held at the EFT gateway into HP Desk.
MAILEFTON
Start Process request sent to the HPDesk Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - EFT created on 06.06.92 at 1056
10:57/#J5/26/HPDESK - EFT Slave Truck started
MAILFSCARPAOFF
Stops FSC ARPA Slave Truck.
Syntax
MAILFSCARPAOFF
Notes
The MAILFSCARPAOFF command stops the FSC ARPA Slave Trucks from bringing
messages held at an FSC ARPA gateway into HP Desk.
MAILFSCARPAOFF
Stop Process request sent to the HPDesk Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - FSCARPA requested to stop on 06.06.92 at 1056
10:56/#J5/26/HPDESK - FSCARPA Slave Truck stopped
10:58/#J5/26/HPDESK - FSCARPA stopped
MAILFSCARPAON
Starts the FSC ARPA Slave Truck.
Syntax
MAILFSCARPAON
Notes
The MAILFSCARPAON command starts up the FSC ARPA Slave Truck which brings
messages held at an FSC ARPA gateway into HP Desk.
MAILFSCARPAON
Start Process request sent to &desk; Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - FSCARPA created on 06.06.92 at 1056
10:57/#J5/26/HPDESK - FSCARPA Slave Truck started
MAILFSCAREFOFF
Stops the ARPA REF Slave Truck.
Syntax
MAILFSCAREFOFF
Notes
The MAILFSCAREFOFF command stops the FSC REF Slave Trucks from bringing
messages held at an FSC REF gateway into HP Desk.
MAILFSCAREFOFF
Stop Process request sent to the HPDesk Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - FSCREF requested to stop on 06.06.92 at 1056
10:56/#J5/26/HPDESK - FSC Reference Slave Truck stopped
10:58/#J5/26/HPDESK - FSCREF stopped
MAILFSCAREFON
Starts ARPA REF Slave Truck.
Syntax
MAILFSCAREFON
Notes
The MAILFSCAREFON command starts up the FSC REF Slave Truck which brings
messages held at an FSC REF gateway into HP Desk.
MAILFSCAREFON
Start Process request sent to the HPDesk Supervisor
END OF PROGRAM
:
10:56/#J5/26/HPDESK - FSCAREF created on 06.06.92 at 1056
10:57/#J5/26/HPDESK - FSC Reference Slave Truck started
MAILGATEINTOFF
Stops the HP Desk Gateway Intrinsics.
Syntax
MAILGATEINTOFF
Notes
The MAILGATEINTOFF command disables the HP DeskManager Gateway
Intrinsics. This prevents mail from being sent or received via
intrinsically accessible gateways.
This command can be used to disable the HP DeskManger Gateway Intrinsics
after using the MAILOMGATEOFF command (the MAILOMGATEOFF command does not
disable the Gateway Intrinsics).
MAILGATEINTOFF
Stop Process request sent to the HPDesk Supervisor.
End of Program
:From/J357 MGR.HPOFFICE/HPDESK - INTRGMGR requested to stop on 06.06.92 at 1357
:From/J357 MGR.HPOFFICE/HPDESK - GATEINT disabled on 06.06.92 at 1357
MAILGATEINTON
Starts the HP DeskManager Gateway Intrinsics.
Syntax
MAILGATEINTON
Notes
The MAILGATEINTON command enables the HP Desk Gateway Intrinsics (if
they're not already enabled).
The Gateway Intrinsics are enabled automatically when the MAILOMGATEON
command is used.
MAILGATEINTON
Start Process request sent to HPDesk Supervisor
END OF PROGRAM
:
11:09/#J5/26/HPDESK - GATEINT enabled on 06.06.92 at 1109
MAILLOAD
Loads the HP Desk databases from tape.
Syntax
MAILLOAD
Notes
CAUTION On no account should DBLOAD.PUB.SYS be invoked manually to load
the database.
The MAILLOAD command is used to load the HP Desk databases from the tapes
to which they were unloaded with the MAILUNLOAD command. The MAILLOAD
command is normally issued after running the Configuration program to
purge and rebuild the databases, to increase the capacities, or to
recover from a database corruption.
The MAILLOAD command checks that the databases are not currently being
accessed. If they are, the command terminates and displays:
Database in use - command not allowed
If the databases are not in use, further access to them is inhibited and
the following message is displayed:
Database load begins on [date] at [time]
The MAILLOAD command streams LOADNATV.MAILJOB.HPOFFICE to run the DBUTIL
program to erase the Native Database, if one exists. The DBLOAD utility
program is then run to copy the unloaded data from the Native tape back
into the empty Native Database.
The LOADNATV job then streams LOADGLOB.MAILJOB.HPOFFICE to repeat the
procedure for the Global Database.
The LOADGLOB job then streams LOADLOCL.MAILJOB.HPOFFICE to repeat the
procedure for the Local Database.
Therefore, the database tapes need to mounted onto the machine in the
following order: Native Database tape, Global Database tape and then the
Local Database tape. To verify that databases have been loaded properly,
carefully examine the listings from the LOADNATV, LOADGLOB and LOADLOCL
jobs.
MAILLOAD
Database load begins on 06.06.92 at 1441
END OF PROGRAM
:
14:41/#J34/64/LOGON FOR : MAILOAD,MGR.HPOFFICE,MAILDB ON LDEV #10
14:42/#J34/64/FROM/MGR.HPOFFICE/Mount GLOBAL unload tape
?14:42/#J35/66/LDEV# FOR "DBLOAD" ON TAPE (NUM)?
=REPLY 66,7
14:48/#J35/67/LOGON FOR : MAILLOAD,MGR.HPOFFICE,MAILDB ON LDEV #10
14:58/#J34/64/FROM/MGR.HPOFFICE/HPDESK GLOBAL database load complete
15:00/#J34/64/FROM/MGR.HPOFFICE/Mount LOCAL unload tape
?15:02/#J35/70/LDEV# FOR "DBLOAD" ON TAP (NUM)?
=REPLY 70,7
15:10/#J35/67/FROM/MGR.HPOFFICE/HPDESK LOCAL database load complete
15:12/#J35/67/LOGOFF ON LDEV #10
MAILMAINT
Runs the Maintenance jobs which tidies up the HP Desk system and produces
a backup copy of the databases.
Syntax
MAILMAINT
Notes
The Maintenance Program is split up into three separate jobs:
* The first job (MAILMAIN.MAILJOB.HPOFFICE) logs users off and shuts
down HP Desk. It then rebuilds the communications files for the
Mailroom and the Transport Manager.
* The second job (MNTSTORE.MAILJOB.HPOFFICE) stores the databases
and associated files.
* The third job (MAILMNT2.MAILJOB.HPOFFICE) performs garbage
collection, checks on the structure of the databases, produces
reports, recalculates the sizes of users' Filing Cabinets Work
Areas, and then starts up HP Desk again.
As each job finishes, it streams the next one.
When HP Desk is first installed, all three jobs execute as MGR.HPOFFICE.
The store job requires OP capability to run because it has to handle
privileged files. Therefore, MGR.HPOFFICE is given OP capabilities. If
you don't want this user to have such wide-ranging capabilities, you can
move the store job to another user and account which already has OP
capabilities (OPERATOR.SYS for example).
If you decide to move the store job, you will have to alter the following
lines as shown:
* In MAILMAIN.MAILJOB.HPOFFICE, you will have to change the line
which reads:
!mailstream mntstore
to indicate the user and account that MNTSTORE will run in. For
example, if you move MNTSTORE to OPERATOR.SYS, you would have to
change the line to read:
!stream mntstore.operator.sys
You have to use the STREAM command because the MAILSTREAM command
only works on files within MAILJOB.HPOFFICE for security reasons.
* In MNTSTORE.MAILJOB.HPOFFICE, you will have to change the line
which reads:
!job maintjob,mgr.hpoffice,maildb
to indicate the user and account this job will run in. For
example, if you move MNTSTORE to OPERATOR.SYS, you will have to
change the line to read:
!job maintjob,operator.sys
* You will also have to change the line in MNTSTORE which reads:
!store !storlist.maillib;*mailstor;show
to indicate the new group and account in which STORLIST resides.
If STORLIST is moved to the MAILJOB group of the SYS account, the
line would read:
!store !storlist.mailjob;*mailstor;show
You can customize the Maintenance job in the following ways:
* You can change the default time and message parameters provided
for the user abort in MAILMAIN.MAILJOB.HPOFFICE.
* You can alter the MAILON command issued at the end of
MAILMNT2.MAILJOB.HPOFFICE if you want to start up any more than
the default number of Master Trucks (the default is 1). If you
don't want to start up all of HP Desk, you can replace the MAILON
command with other commands which only start up selected parts of
HP Desk (the Mailroom, for example).
* You can set the CONCURRENT JCW in MAILMNT2.MAILJOB.HPOFFICE to on
to enable the user interface once the databases and associated
data files have been stored off. This minimizes the amount of
time HP Desk is unavailable to users.
* You can change two JCWs in MAILMNT2.MAILJOB.HPOFFICE to alter the
presentation of the maintenance reports. Setting the QUICKLIST
JCW to on suppresses MREPORT. Setting SHORTLIST to on causes any
lines composed entirely of zeros to be suppressed when MREPORT is
produced.
* You can set the STATISTICS JCW in MAILMNT2.MAILJOB.HPOFFICE to on
if you want to collect and store the data for network statistics.
MAILMAINT streams the file MAILMAIN.MAILJOB.HPOFFICE to perform the
various maintenance functions. When complete, up to three files are
printed to the system line printer:
* MERRQUE - the headers of items in the Error Queue (not printed if
Error Queue is empty).
* MERROR - database errors (not printed if there are no errors).
* MREPORT - a summary report.
NOTE The MAILCANCELABORT command cannot be used to stop users being
aborted by the Maintenance program. This is because, in this case
the program which aborts users is being run explicitly by the
Maintenance program and not as a process under of the Supervisor.
An example Mailmaint command might be:
:MAILMAINT
Start Process request sent to HPDesk Supervisor
END OF PROGRAM
:
22:22/#J26/28/HPDESK - MAINT job started on 06.06.92 at 2222
22:22/#J31/58/LOGON FOR;MAINTJOB.MGR.HPOFFICE,MAILDB ON LDEV #10
22:23/#J31/55/HPDesk maintenance job started
Once HP Desk is shut down, the first maintenance job logs off all users
who are still using HP Desk and the streams the second job:
22:32/#J26/31/HPDESK User sessions will be automatically aborted
in 2 MINUTES
22:33/#J26/31/HPDESK User sessions will be automatically aborted
in 1 MINUTE
22:34/#J26/31/HPDESK User sessions now being aborted
22:36/#J12/48/LOGOFF ON LDEV #20
22:36/#J20/46/LOGON FOR :MAINTJOB,MGR.HPOFFICE,MAILDB ON LDEV #10
22:37/#J35/40/LOGOFF ON LDEV #10
You are then asked to mount a tape, or cartridge depending on the size of
your computer in the tape drive. Once you reply to this message, the
second maintenance job stores off the databases. If the databases are
too big to fit on one tape, you will have to load a second tape when
prompted.
22:37/Mount HPDESK backup tape
22:38/#J13/35/LDEV# FOR "MAILSTOR" ON TAPE (NUM), WRITE RING? (Y/N)
=reply 35,7,y
22:38/#J24/25/Vol (unlabelled) mounted on LDEV #10
22:38/#J24/25/VOLUME DISMOUNTED ON LDEV #7
22:40/#J12/127/FROM/MGR.HPOFFICE/hpdesk backup complete
22:40/#J35/16/LOGON FOR: MAINTJOB,MGR.HPOFFICE,MAILDB ON LDEV #10
22:41/#J12/127/LOGOFF ON LDEV #10
The second maintenance job has now stored the databases and has streamed
the third and final job. This job performs garbage collection, produces
the maintenance reports, and restarts HP Desk.
22:43/#J12/127/LOGON FOR:SUPRVISR,MGR.HPOFFICE,PUB ON LDEV #10
22:44/#J12/127/HPDESK - Recovery about to start
22:46/#J12/127/Structure check done (0 corrupt items)
22:48/#J12/127/HPDESK - RECOVER stopped
22:49/#J12/127/HPDESK - Recovery successful
22:50/#J12/127/HPDESK - SUPTIMER created on 06.06.92 at 2250
22:51/#J12/127/HPDESK - Supervisor ready to process requests
22:52/#J16/30/Databases are now locked
22:20/#J12/28/HPDESK - Error queue processing done (total of 4 items processed)
22:23/#J12/28/HPDESK - User Waste Bin processing done (6 bins emptied)
22:24/#J12/28/HPDESK - Orphan Item Queue processing done(6 items orphan)
22:24/#J12/28/HPDESK - Structure check done (0 corrupt items)
22:28/#J12/28/HPDESK - Garbage collected (568 items deleted)
22:29/#J12/28/HPDESK - mail node processing done (7 mail nodes)
22:30/#J12/28/HPDESK - User processing done (14 users)
22:30/#J12/28/HPDESK - Archive summary complete (12 tapes found)
22:30/#J12/28/HPDESK - Catalog summary complete (83 catalogs found)
22:31/#J12/28/HPDESK - Local control updated
22:32/#J12/28/HPDESK - HPDESK Maintenance job complete
22:32/#J12/127/LOGOFF
Once all the maintenance tasks are completed, the Maintenance program
issues a MAILON command to start up HP Desk again.
In the above example, the maintenance has performed the Waste Basket
emptying, structure check and garbage collection functions.