admwarpd(1M) admwarpd(1M)
NAME
admwarpd - manage AV/X.400 Distribution
SYNOPSIS
admwarpd -o operation [-t type] [-d dtype] [-n dname] [-f
file] [-l listfile] [-m MTA] [-n new_MTA] [-d days]
[statusid | drivenumber]
where:
operation
The operation to perform
type The type of database
dtype
The destination of the distribution
dname
The distribution list name
file The database file name
listfile
The output for the operation
MTA The name of the MTA
new_MTA
The name of the new MTA
days The number of days (for janitor use).
statusid
The id of the operation to report on.
drivenumber
The tape drive number.
DESCRIPTION
The admwarpd manages AV/X.400 file distribution, and daily
processing.
There are operations that enable you to distribute a file,
either via X.400 or via tape; operations that manage MTA
distribution lists i.e. lists of MTAs to which files can be
distributed; and daily processing operations, normally
invoked by cron jobs installed when you set up the UMS X.400
MTA.
Operations
The available values for the operation are:
distribute
Distribute a file: either a compiled global MTA
database file, an umcompiled global routing prefix
file, or some other file identified by a full pathname.
See below for more information.
liststatus
Each accepted distribute operation (apart from those
that specify tape as a destination) generates a status
file that contains information about the current status
Licensed material--property of Data General Corporation Page 1
admwarpd(1M) admwarpd(1M)
of the transfer. The list_status operation lists the
identifiers of accepted file distribution operations.
printstatus
Print the status file of an accepted distribute
operation. You must supply id of the operation.
removestatus
Remove the status file of an accepted distribute
operation. You must supply id of the operation.
writetape
The distribute operation can specify tape as the file
destination, in which case adm_warpd places the file to
be distributed into a tape preparation area. Use the
write_tape operation to write the files in the tape
preparation to tape. You must supply the tape drive
number.
readtape
Read and process a tape generated by the write_tape
operation. This operation processes and installs the
files on the tape as if they had been received by the
X.400 distribution mechanism. You must supply the tape
drive number.
add Add an MTA tag (see admwarpmta(1M)) to an MTA
distribution list. You must supply the MTA and
listfile.
delete
Delete an MTA tag (see admwarpmta(1M)) from an MTA
distribution list. You must supply the MTA and
listfile.
modify
Modify an MTA tag (see admwarpmta(1M)) in an MTA
distribution list. You must supply the MTA and
listfile.
list List the MTA tags (see admwarpmta(1M)) in an MTA
distribution list, in a form suitable for display to a
user, on standard output. You must supply the MTA and
listfile.
catlist
List the MTA tags (see admwarpmta(1M)) in an MTA
distribution list, one tag per line, on standard
output. You must supply the MTA and listfile.
createlist
Create a new MTA distribution list. You must supply
Licensed material--property of Data General Corporation Page 2
admwarpd(1M) admwarpd(1M)
the MTA and listfile.
deletelist
Delete an existing MTA distribution list. You must
supply the MTA and listfile.
listlists
List the existing MTA distribution lists, one list name
per line, on standard output.
janitor
Delete files from the AV/X.400 MTA instance directory,
so that there are N days of files of each type
remaining. A janitor is needed because each time you
install a file, or a new file arrives via the file
distribution mechanism, the installing process creates
a new file.
A cron job normally invokes this operation once a day.
dailyexport
Run the export_private and export_shared operations if
the scripts to do the export exist. For the data
generated by export_shared, send it to the other MTAs
sharing routing prefixes with the AV/X.400 MTA; note
that if the last export_shared generated the same
information, and the information was successfully sent
to the other MTAs, then adm_warpd does not send the
data.
A cron job normally invokes this operation once a day.
dailycompilereload
Run the adm_warp_rpf(1m) compile operation followed by
the adm_warp_rpf(1m) reload operation, to update the
routing information the AV/X.400 MTA is using.
A cron job normally invokes this operation once a day.
Options
You may use the following options:
-t export
Distribute the latest routing prefix file generated by
the export_shared operation to the other MTAs sharing
routing prefixes with the AV/X.400 MTA.
-t mtadb
Distribute a compiled global MTA database file.
-t rpf
Distribute an uncompiled global routing prefix file.
Licensed material--property of Data General Corporation Page 3
admwarpd(1M) admwarpd(1M)
-t other
Distribute any file, to be identified by a full
pathname. The destination MTAs store the file with the
same name in the sub-directory dist-file of the
directory $X400USER.
-d dtype
The dtype identifies the destination.
-n dname
The dname depends on the dtype. See below in section
for the relevant dtype.
-d allmtas
All MTAs in the currently loaded MTA database that
AV/X.400 MTA is using excluding those with nosend
(seeadmwarpmta(1M)) set to TRUE. The dname is not
required.
-d mta_list
An MTA distribution list identified by dname.
-d single_mta
A single MTA identified by MTA tag (see
admwarpmta(1M)). The dname is the MTA tag.
-d tape
Write the file to the tape preparation area. The dname
is either yes or no. The former specifies a new tape,
the latter an old tape. The tape preparation area is
cleared when making a new tape.
-f mtadb
The name of the compiled global MTA database file to be
distributed, in the form name.owc.
-f rpf
The name of the global routing prefix file to be
distributed, in the form name.rpf.
-f pname
The FULL pathname of the "other" file to be
distributed.
statusid
The status identifier of the file distribution request,
in the form YYYYDDD_SSSS. The distribute operation
reports the status identifier of an accepted request to
standard output.
drivenumber
The drive number of the tape drive for the tape
Licensed material--property of Data General Corporation Page 4
admwarpd(1M) admwarpd(1M)
operation: 0-9.
-l <listfile>
The name of the MTA distribution list.
-m <MTA>
The MTA tag of the MTA to be added, deleted or
modified.
-n <newMTA>
The MTA tag to replace the selected MTA in the modify
operation.
-d <daystokeep>
The number of days of files that the janitor is to keep
for each file type: 1-9999.
EXAMPLES
To distribute the latest shared export file:
admwarpd -o distribute -t export
To distribute a routing prefix file to a single MTA:
admwarpd -o distribute -t rpf -d singlemta -n MTA1 \
-f database.rpf
To distribute a compiled MTA database file to all MTAs:
admwarpd -o distribute -t mtadb -d allmtas \
-f database.owc
To distribute an "other" file to an MTA distribution list:
admwarpd -o distribute -t other -d mtalist -n englishmtas\
-f /usr/include/stdio.h
To distribute an "other" file via tape:
admwarpd -o distribute -t other -d tape -n yes \
-f /usr/include/stdio.h
To list the status files:
admwarpd -o liststatus
To print a status file on standard output:
admwarpd -o printstatus 19902420001
To remove a status file:
Licensed material--property of Data General Corporation Page 5
admwarpd(1M) admwarpd(1M)
admwarpd -o removestatus 19902420001
To write the files in the tape preparation area to a tape on
drive zero:
admwarpd -o writetape 0
To read the files from a tape on drive zero:
admwarpd -o readtape 0
To create an MTA distribution list:
admwarpd -o createlist -l englishmtas
To delete an MTA distribution list:
admwarpd -o deletelist -l englishmtas
To list the MTA distribution lists on standard output:
admwarpd -o listlists
To add an MTA to an MTA distribution list:
admwarpd -o add -l englishmtas -m londin
To modify an MTA in an MTA distribution list:
admwarpd -o modify -l englishmtas -m londin -n london
To delete an MTA from an MTA distribution list:
admwarpd -o delete -l englishmtas -m london
To list an MTA distribution list in report format:
admwarpd -o list -l englishmtas
To list an MTA distribution list, one MTA per line:
admwarpd -o catlist -l englishmtas
DIAGNOSTICS
The following exit codes are generated:
0 The operation was performed successfully.
1 An error occurred during the execution of the
operation.
Licensed material--property of Data General Corporation Page 6
admwarpd(1M) admwarpd(1M)
3 There was an error in the command line.
ENVIRONMENT
The following environment variables are used:
X400USER
The directory in which the AV/X.400 MTA to be managed
is installed. If this variable is not set, then the
directory defaults to /usr/opt/x400. NOTE that for the
operations janitor, daily_export and
daily_compile_reload, adm_warpd ignores X400USER, and
sets it itself by using $0. To request these operations
you should set $X400USER and use the command
$X400USER/sbin/adm/adm_warpd.
SEE ALSO
admwarprpf(1M), admwarpmta(1M).
NOTES
The options on the command line must occur in the order
specified in the SYNOPSIS section.
admwarpd uses admlock(1M) to prevent undesirable
interactions between multiple concurrent invocations of
itself.
Licensed material--property of Data General Corporation Page 7