Commands Reference, Volume 3

mhpath Command

Purpose

Prints full path names of messages and folders.

Syntax

mhpath [ +Folder ] [ Messages [ ,Messages ] ... ]

Description

The mhpath command lists the path names of folders and messages. By default, the command lists the path name of the current folder.

Flags

+Folder

Specifies which folder path to list.

-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 for which you want to list path names. The Messages parameter can specify several messages, a range of messages, or a single message. Use the following references to specify messages.

Number

Number of the message. When specifying multiple messages, separate each message number with a comma. When specifying a range of messages, separate the upper and lower ends of the range with a hyphen.

Note: You cannot use the new variable when specifying a range.

Sequence

A group of messages specified by the user. Recognized values include:

all: All the messages in a folder.
cur or . (period): Current message.
first: First message in a folder.
last: Last message in a folder.
new: Path name that the system will assign to the next message that is incorporated.
next: Message following the current message.
prev: Message immediately before the current message.

Profile Entries

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

`Current-Folder:`	Sets the default current folder.
`Path:`	Specifies a user's MH directory.

Examples

To list the path name of the current folder, enter:
```
mhpath
```
The system responds with a message similar to the following:
```
/home/tom/Mail/inbox
```
To list the path names for messages 2 through 4 in the source folder, enter:
mhpath +source 2-4
The system responds with a message similar to the following:
```
/home/tom/Mail/source/2
/home/tom/Mail/source/3
/home/tom/Mail/source/4
```
To list the path name the system will assign to the next message added to the current folder, enter:
```
mhpath new
```
The system responds with a message similar to the following:
```
/home/tom/Mail/source/5
```
In this example, the next message will be message 5 in user tom's current folder, /home/tom/Mail/source.

Files

$HOME/.mh_profile	Defines the user's MH profile.
/usr/bin/mhpath	Contains the mhpath command.

Related Information

The folder command.

The mh_alias file format, mh_profile file format.

Mail Overview in AIX 5L Version 5.1 System User's Guide: Communications and Networks.