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. 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 July 12, 1991 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 July 12, 1991 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. See Chapter 18 of the AIX Programming Tools and Interfaces for general information on using commands in an MBCS environment. Processed July 12, 1991 BURST(1m,C) 3