Divides a message into separate, new messages.
burst [ +Folder ] [ Messages ] [ -inplace ] [ -noinplace ] [ -quiet ] [ -noquiet ] [ -verbose ] [ -noverbose ]
The burst command allows you to divide a message into multiple, new messages. The burst command operates on digests, messages forwarded by the forw command, and blind carbon copies sent by the forw and send commands. Messages created using the burst command are numbered consecutively, beginning with the next highest number in the specified folder.
The burst command can create about 1000 messages from a single message. However, the burst command 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.
By default, the first message extracted from the first digest becomes the current message. If the -inplace flag is specified, the first new message becomes the current message.
| Item | Description |
|---|---|
| +Folder | Specifies the folder containing the message to divide. By default, the system uses the current folder. |
| -help | Lists the command syntax, available switches (toggles), and
version information. Note: For Message Handler (MH), the name of this flag must be fully spelled out. |
| -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 from the divided digest. Attention: The burst command does not place text displayed after the last encapsulated message in a separate message. When you specify the -inplace flag, the burst command 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, the burst command loses these remarks. |
| Messages | Specifies the messages that you want to divide. This parameter
may specify several messages, a range of messages, or a single message.
Use the following references to specify messages:
|
| -noinplace | Preserves each digest. This is the default. |
| -noquiet | Reports information about messages not in digest format. This flag is the default. |
| -noverbose | Prevents reporting of the actions the burst command performs while dividing the digests. This flag is the default. |
| -quiet | Prevents reporting of information about messages not in digest format. |
| -verbose | Reports the actions the burst command performs while dividing a digest. |
Attention RBAC users and Trusted AIX® users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.
The following entries are entered in the UserMhDirectory/.mh_profile file:
| Item | Description |
|---|---|
| Current-Folder: | Sets the default current folder. |
| Msg-Protect: | Sets the protection level for your new message files. |
| Path: | Specifies a user's MH directory. |
5+ 03/02 mickey@mouse
6+ 03/02 disney@worldburst 5
5+ 03/02 mickey@mouse
6 03/02 disney@world
7 first message in digest
8 second message in digest
9 third message in digestburst 5 -inplace
5+ 03/02 mickey@mouse
6 first message in digest
7 second message in digest
8 third message in digest
9 03/02 disney@world| Item | Description |
|---|---|
| $HOME/.mh_profile | Contains the MH user profile. |
| /usr/bin/burst | Contains the executable form of the burst command. |