===== Q   Quick Message Scan =====
This command will list message header information.  The information pertaining to a message is listed on one line for easy viewing.

==== Display Subcommands ====

|**+**|Scan in forward direction.|
|**-**|Scan in reverse direction.|
|**L**|Begin with last message in message base.|
|**NS**|Display in non-stop mode.|

==== Message Selection Subcommands ====

|**[beg. msg.  #]**|Beginning message number.|
|**A**|Scan selected conferences.|
|**ALL**|Scan all conferences.|
|**F**|Message from you.|
|**FROM**|Read messages from a user.|
|**N**|New Messages by date.|
|**S**|Messages that you have not read yet.|
|**TO**|Read messages to a user.|
|**WAIT**|Scan messages in conferences where you have mail waiting.|
|**TS**|Messages that contain particular text.|
|**U**|All unread messages.|
|**USER**|Messages from a particular user.|
|**Y**|Messages addressed to you.|


==== Subcommands: Alphabetical Listing ====

|**[beg.msg.#]**|Beginning message number.|This is the message number that you wish to begin the scan with.  The default scan direction is in the forward direction.  If you wish to go in the reverse direction, use the - subcommand.|
|**+**|Scan in forward direction.|When appended to the beginning message number you can set the direction in which PCBoard scans the message base.  For example if you enter 762+, PCBoard will begin scanning at message number 762 in the forward direction.|
|**-**|Scan in reverse direction.|When appended to the beginning message number you can set the direction in which PCBoard scans the message base.  For example if you enter 3569-, PCBoard will begin scanning at message number 3569 in the reverse direction. **NOTE:** PCBoard defaults to searching in the forward direction.|
|**A**|Scan selected conferences.|Scans not only the current conference but also those conferences which you have set for scanning via the SELECT command or the S conference flag in the users record.|
|**ALL**|Scan all conferences.|Scans all conferences you are registered in even if you have not marked the conference for scanning.|
|**F**|Message from you.|Only messages that are from you, the user currently online, will be displayed.|
|**FROM**|Read messages from a user.|If you wish to read mail that is from a particular user, use this subcommand.  When you use this subcommand, PCBoard will prompt you for the user you wish to read mail from.|
|**L**|Begin with last message in message base.|Sets the beginning message number to the last message in the message base.  When you use this subcommand you may omit the beginning message number.|
|**N**|New messages by date.|The first message that is read is the one that matches the date that you specify.  This enables you to read only messages that were left after a certain date.|
|**NS**|Display in non-stop mode.|The listing of messages will be displayed in non-stop mode.  This means that there will be no more? prompts to pause each time the screen becomes full.|
|**S**|Messages that you have not read yet.|Searches only those messages that you have not read yet.|
|**TO**|Read messages to a user.|If you wish to read mail that is addressed to a particular user, use this subcommand.  When you use this subcommand, you will be prompted for the user name that you wish to read mail from.|
|**TS**|Messages that contain particular text.|This subcommand enables you to search for text in the message body, the TO: field, and the FROM: field.  You can search for a word/phrase or you can use any Boolean search.  For more information on searching for text please see Searching For Text in the Sysop's Guide chapter of this manual.|
|**U**|All unread messages.|If a message has not yet been read then it will be displayed. **NOTE:** A message that is addressed to ALL will always show up in such a search because the read status is not maintained on a message addressed to all users on the system.|
|**USER**|Messages from a particular user.|You may search the message header for a particular user.  When PCBoard searches for a particular user it will search both the TO: and FROM: fields in the message header.  You must enter a full user name.  Partial matches cannot be made with this command.|
|**WAIT**|Scan messages in conferences where you have mail waiting.|Messages are read from only conferences that you currently have personal mail waiting to be read.  For example, if you login and see that you have mail waiting in conferences 2,3, and 25 you could read all new messages in only those conferences by entering R;WAIT at the conference command prompt.|
|**Y**|Messages addressed to you.|Only messages that are addressed to you will be listed.|


==== Description ====
You may analyze a brief list of messages that may be read by you if you use the Q user command.  When executed, PCBoard will display the following information about each message:

  * Message number
  * Reference number
  * Sender
  * Addressee
  * Subject
  * Read Status

The reference number indicates the previous message to which a reply was entered to.  This command can be used to quickly search message headers for information.


==== Format of the list ====
The list that is produced by the format contains the following information:

|**Msg#**|The actual message number in the message base.|Just before the message number is a status code that shows if the message has been read, etc.  For a list of status codes please see the section titled Status Codes.|
|**Ref#**| |If the message is a reply, this field will contain the message number which was replied to.|
|**To.**|Displays who the message is addressed to.|Only the first 16 characters of who a message is address to is displayed in this list.|
|**From.**|Displays who the message is from.|The first 16 characters of who the message(s) are from will be displayed.|
|**Subject.**|Displays the subject of the message.|Even though a subject may be quite long, only the first 25 characters of the subject is displayed with this command.|


==== Status Codes ====
Next to each message number is a status code.  You can use these status codes to determine if the message has been read, if it has replies, etc.  The following is a list of all valid message status codes:

|**[blank]**|A message which can be read by anyone.|
|*****|A private message to a specific person which has not been read by the person it was addressed to.|
|**+**|A private message which has been read by the person it was addressed to.|
|**-**|A message to a specific person, which was readable by anyone, which has been read by the person it was addressed to.|
|**~**|A comment to the SysOp which has not been read by the person defined as SysOp record #1.|
|**`**|A comment to the SysOp which has been read by the person defined as SysOp record #1.|
|**%**|A message protected by sender password which has not been read.|
|**^**|A message protected by sender password which has been read.|
|**!**|A message protected by group password which has not been read.|
|**#**|A message protected by group password which has been read.|
|**$**|A message protected by group password which is addressed to ALL.|


==== Examples ====
To display the header information for all messages in the current message base in reverse order you would issue the following at the command prompt:

	Q L

To search for all messages (beginning with the first message in the message base) either to or from a user named Wally Peterson you would issue the following at the command prompt:

	Q USER WALLY PETERSON 1+