BURST(1m,C) AIX Commands Reference BURST(1m,C)
-------------------------------------------------------------------------------
burst
PURPOSE
Explodes digests into messages.
SYNTAX
+-----------+ +------- cur ---------------------------------+
burst ---| |---| +---------- all --------------------------+ |--->
+- +folder -+ +-| +----------- sequence ------------+ |-+
+---| one of +------------------+ |---+
^ | +-------+ | one of | | |
| +-| num |--|1+--------------+ |-+ |
| | first | +-| :num -prev |-+ |
| | prev | | :+num -cur | |
| | cur | | :-num -. | |
| | . | | -num -next | |
| | next | | -first -last | |
| | last | +--------------+ |
| +-------+ |
+-------------------------------------+
+--- -noinplace -+ +-- -noquiet --+ +-- -noverbose --+
>---| one of |---| one of |---| one of |---|
| +------------+ | | +----------+ | | +------------+ |
+-| -inplace |-+ +-| -quiet |-+ +-| -verbose |-+
| -noinplace | | -noquiet | | -noverbose |
+------------+ +----------+ +------------+
burst --- -help ---|
-----------------
1 Do not put a blank between these items.
Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.
DESCRIPTION
The burst command is used to explode digests, messages forwarded by the forw
command, and blind carbon copies sent by the forw and send commands. The burst
command is part of the Message Handling (MH) package and can be used with other
MH and AIX commands.
Processed November 8, 1990 BURST(1m,C) 1
BURST(1m,C) AIX Commands Reference BURST(1m,C)
The burst command cannot explode more than about 1,000 messages from a single
message. The command, however, generally does not place a specific limit on
the number of messages in a folder after bursting is complete.
The burst command uses encapsulation boundaries to determine where to separate
the encapsulated messages. If an encapsulation boundary is located within a
message, the burst command may split that message into two or more messages.
FLAGS
+folder msgs Specifies the messages that you want to burst. You can use
msgs to specify several messages, a range of messages, or a
single message. You can use the following message references
when specifying msgs:
num first prev
cur . next
last all sequence
The default message is the current message in the current
folder. If the -inplace flag is also specified, the first
message burst becomes the current message. Otherwise, the
first message extracted from the first digest becomes the
current message.
-help Displays help information for the command.
-inplace Replaces each digest with a table of contents for the digest,
places the messages contained in each digest directly after the
digest's table of contents, and renumbers all subsequent
messages in the folder to make room for the messages in the
exploded digest.
Warning: The burst command does not place text that appears
after the last encapsulated message in a separate message.
When you specify the -inplace flag, burst loses this trailing
text. In digests, this text is usually an End-of-Digest
string. However, if the sender appended remarks after the last
encapsulated message, burst loses those remarks.
-noinplace Preserves each digest, does not produce a table of contents for
each digest, and places the messages contained in each digest
at the end of the folder. The burst command does not affect
messages that are not part of digests. This flag is the
default.
-noquiet Reports information about messages that are not in digest
format. This flag is the default.
-noverbose Does not report the general actions that the burst command
performs while exploding the digests. This flag is the
default.
Processed November 8, 1990 BURST(1m,C) 2
BURST(1m,C) AIX Commands Reference BURST(1m,C)
-quiet Does not report information about messages that are not in
digest format.
-verbose Reports the general actions that the burst command performs
while exploding the digests.
PROFILE ENTRIES
Current-Folder: Sets your default current folder.
Msg-Protect: Sets the protection level for your new message files.
Path: Specifies your user_mh_directory.
FILES
$HOME/.mh_profile The MH user profile.
RELATED INFORMATION
See other MH commands: "forw," "inc," "msh," "packf," "send" and "show."
See the mh-profile file in AIX Operating System Technical Reference.
See "Overview of the Message Handling Package" in Managing the AIX Operating
System.
Processed November 8, 1990 BURST(1m,C) 3