Commands Reference, Volume 3

mark Command

Purpose

Creates, modifies, and displays message sequences.

Syntax

mark [ +Folder ] [ -list ] [ -sequence Name [ Messages... ] [ -add | -delete ] [ -zero | -nozero ] [ -public | -nopublic ] ]

Description

The mark command creates, deletes, adds, and lists messages in a sequence. The mark command by default lists all of the sequences and their messages for the current folder. If you use the -add or -delete flag, you must also use the -sequence flag. When all messages are deleted from a sequence, the mark command removes the sequence name from the folder.

To create a new sequence, enter the -sequence flag with the name of the sequence you want to create. The mark command creates the sequence starting with the current message. By default, the mark command places the sequence in the current folder. If you specify a folder, that folder becomes the current folder.

Flags

-add	Adds messages to a sequence. The -add flag is the default. If you do not specify a message, the mark command uses the current message. Note: You can only use this flag with the -sequence flag.
-delete	Deletes messages from a sequence. If you do not specify a message, the current message is deleted by default. Note: You can only use this flag with the -sequence flag.
+Folder	Specifies the folder to examine.
-help	Lists the command syntax, available switches (toggles), and version information. Note: For MH, the name of this flag must be fully spelled out.
-list	Displays the messages in a sequence. By default, the -list flag displays all the sequence names and messages defined for the current folder. To see a specific sequence, use the -sequence flag with the -list flag.
-nopublic	Restricts a sequence to your usage. The -nopublic flag does not restrict the messages in the sequence, only the sequence itself. This option is the default if the folder is write-protected from other users.
-nozero	Modifies the sequence by adding or deleting only the specified messages. This flag is the default.
-public	Makes a sequence available to other users. The -public flag does not make protected messages available, only the sequence itself. This flag is the default if the folder is not write-protected from other users.
-sequence Name	Specifies a sequence for the -list, -add, and -delete flags.
-zero	Clears a sequence of all messages except the current message. When the -delete flag is also specified, the -zero flag places all of the messages from the folder into the sequence before deleting any messages.
Messages	Specifies messages in a sequence. You can specify more than one message at a time. Messages are identified with following references: Number Number of the message all All the messages in a folder cur or . (period) Current message (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 If the -list flag is used, the default for the Messages parameter is all. Otherwise, the default is the current message.

Profile Entries

The following entry is found in the UserMHDirectory/context file:

Current-Folder: Specifies the default current folder.

The following entry is found in the $HOME/.mh_profile file:

Path: Specifies the MH directory.

Examples

To see the list of all sequences defined for the current folder, enter:
```
mark
```
The system displays a message similar to the following:
```
cur: 94
test: 1-3 7 9
```
In this example, message 94 is the current message number in the current folder. The message sequence called test includes message numbers 1, 2, 3, 7, and 9.
To see the list of all the sequences defined for the meetings folder, enter:
mark +meetings
The system displays a message similar to the following:
```
cur: 5
dates: 12 15 19
```
To create a new message sequence called schedule in the current folder, enter:
mark -sequence schedule
The system displays the shell prompt to indicate that the schedule sequence was created. By default, the system adds the current message to the new sequence.
To delete message 10 from the schedule sequence, enter:
mark -sequence schedule 10 -delete

Files

$HOME/.mh_profile	Specifies the MH user profile.
/usr/bin/mark	Contains the mark command.

Related Information

The pick command.

The mh_alias file format, mh_profile file format.

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