mark Command

AIX Version 4.3 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 Version 4.3 System User's Guide: Communications and Networks.

Peek, Jerry. MH and xmh: E-mail for Users and Programmers. Sebastopol, CA: O'Reilly & Associates, 1992.