show Command

Purpose

Shows messages.

Syntax

show [ +Folder ] [ -draft | Messages ] [ -header | -noheader ] [ -showproc CommandString | -noshowproc ]

Description

The show command displays the contents of messages. If standard output is not a display, the show command lists each message with a one-line header and two separation lines. By default, the show command displays the current message in the current folder.

The show command invokes a listing program to create the list. The default listing program is /usr/bin/more. You can define your own default with the showproc: entry in your $HOME/.mh_profile file. If you set the showproc: entry to mhl, the show command calls an internal mhl routine instead of the mhl command. You can also specify the program to perform a listing in the CommandString parameter of the -showproc flag.

The show command passes any flags it does not recognize to the listing program. Thus, you can specify flags for the listing program, as well as for the show command.

If the Unseen-Sequence: entry is present in your $HOME/.mh_profile file and the entry is not empty, the show command removes each of the messages shown from each sequence named by the profile entry. If several messages are specified, the last message shown becomes the current message.

Flags

Item	Description
-draft	Shows the UserMhDirectory/draft file if it exists.
+Folder	Specifies a folder. The current folder is the default.
-header	Displays a one-line description of the message being shown. The description includes the folder name and message number. If you show more than one message, this flag does not produce message headers. The -header flag is the default.
-help	Lists the command syntax, available switches (toggles), and version information. Note: For MH, the name of this flag must be fully spelled out.
Messages	Specifies the messages to show. You can specify several messages, a range of messages, or a single message. Use the following references to specify messages: Number Number of the message. Sequence A group of messages specified by the user. Recognized values include: all All messages in a folder. cur or . (period) Current message. This is the default. first First message in a folder. last Last message in a folder. next Message following the current message. prev Message preceding the current message.
-noheader	Prevents display of a one-line description of each message.
-noshowproc	Uses the /usr/bin/cat command to perform the listing. This is the default.
-showproc CommandString	Uses the specified command string to perform the listing.

Security

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 AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Profile Entries

The following entries are entered in the UserMhDirectory/.mh_profile file:

Item	Description
`Current-Folder:`	Sets the default current folder.
`Path:`	Specifies the user's MH directory.
`showproc:`	Specifies the program used to show messages.
`Unseen-Sequence:`	Specifies the sequences used to keep track of the unseen messages.

Examples

To display the contents of the current message in the current folder one screen at a time, enter:
```
show
```
If the message continues for more than one screen, press the Enter key until you have read the entire message.
To see the contents of all the messages in the current folder, enter:
```
show all
```
If the messages continue for more than one screen, press the Enter key until you have read all the messages.
To see the contents of message 5 in the meetings folder, enter:
show +meetings 5
To see the contents of all the messages belonging to the weekly sequence in the meeting folder, enter:
show +meeting weekly

Files

Item	Description
$HOME/.mh_profile	Specifies the MH user profile.
UserMhDirectory/draft	Contains the current message draft.
/usr/bin/show	Contains the show command.