Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ pick(1m) — AIX PS/2 1.2.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

mark

mh-profile



PICK(1m,C)                  AIX Commands Reference                   PICK(1m,C)



-------------------------------------------------------------------------------
pick



PURPOSE

Selects messages by content and creates and modifies sequences.

SYNTAX


      +---------------------------------------------------------------------+
      |                              one of                                 |
pick -|                            +---------+                              |->
      | +--------+ +-----------+ +-| -after  |---- date ----+ +-----------+ |
      +-|        |-|           |-| | -before |              |-|           |-+
       ^+- -not -+ +- -lbrace -+ | +---------+              | +- -rbrace -+|
       |                         |     one of               |              |
       |                         | +------------+           |              |
       |                         +-| -cc        |- pattern -+              |
       |                           | -date      |                          |
       |                           | -from      |                          |
       |                           | -search    |                          |
       |                           | -subject   |                          |
       |                           | -to        |                          |
       |                           | --component|                          |
       |                           +------------+                          |
       |                               one of                              |
       |                              +------+                             |
       +------------------------------| -and |-----------------------------+
                                      | -or  |
                                      +------+

   +--------------------------------------------------------+ +-------------+
>--|                      +--- -zero ---+ +---------------+ |-|   one of    |-|
   +--- -sequence name ---|   one of    |-|    one of     |-+ | +---------+ |
     ^                  | | +---------+ | | +-----------+ |   +-| -list   |-+
     +------------------+ +-| -zero   |-+ +-| -public   |-+     | -nolist |
                            | -nozero |     | -nopublic |       +---------+
                            +---------+     +-----------+

pick --- -help ---|


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

The pick command is used to select messages and put them into sequences.  The
pick command is part of the Message Handling (MH) package and can be used with
other MH and AIX commands.



Processed November 8, 1990        PICK(1m,C)                                  1





PICK(1m,C)                  AIX Commands Reference                   PICK(1m,C)




The pick command allows you to select messages that contain particular
character patterns or that have particular dates.  You can use the -and, -or,
-not, -lbrace, and -rbrace flags to construct compound conditions for selecting
messages.

FLAGS

-after date           Selects messages with dates later than the specified
                      date.  You can use the following date specifications for
                      date:

                      yesterday            today               tomorrow
                      sunday               monday              tuesday
                      wednesday            thursday            friday
                      saturday             -dd                 sysdate

                      Only messages whose Date: field value is chronologically
                      after the date specified will be considered.

                      The pick command treats the days of the week as days in
                      the past.  For example, monday means last Monday, not
                      today or next Monday.  You can use the -dd argument to
                      specify a number of days in the past.  For example, "-31"
                      means 31 days ago.  For sysdate you can specify any valid
                      format defined for your system.  See "date" for more
                      information about date formats.

-and                  Forms a logical AND operation between two message
                      selecting flags (for example, "pick -after Sunday -and
                      -from mark").  -and has precedence over -or, but -not has
                      precedence over -and.  Use the -lbrace and -rbrace flags
                      to override this precedence.

-before date          Selects messages with dates earlier than the specified
                      date.  See the -after flag for how to specify date.

                      Only messages whose Date: field value is chronologically
                      before the date specified will be considered.

-cc pattern           Selects messages that contain the character string
                      pattern in the Cc: field.

-date pattern         Selects messages that contain the character string
                      pattern in the Date: field.

-datefield field      Specifies which dated field is parsed when the -after and
                      -before flags are given.  By default, pick uses the Date:
                      field.






Processed November 8, 1990        PICK(1m,C)                                  2





PICK(1m,C)                  AIX Commands Reference                   PICK(1m,C)



+folder msgs          Specifies the messages that you want to search.  The msgs
                      parameter can be several messages, a range of messages,
                      or a single message.  You can use the following message
                      references when specifying msgs:

                      num                    first                   prev
                      cur                    .                       next
                      last                   all                     sequence

                      The default for msgsis all.  The default folder is the
                      current folder.  If you specify a folder, that folder
                      becomes the current folder.

-from pattern         Selects messages that contain the character string
                      pattern in the From: field.

-help                 Displays help information for the command.

-lbrace               Groups -and, -or, and -not operations.  Operations
                      between the -lbrace and -rbrace flags are evaluated as
                      one operation.  You can nest the -lbrace and -rbrace
                      flags.

-list                 Sends a list of selected message numbers to standard
                      output.  This allows you to use the pick command to
                      generate message numbers to use as input for other
                      commands.  For example, "scan `pick -after tuesday
                      -list`" scans all messages in the current folder that
                      were sent after last Tuesday.  -list is the default if no
                      sequence is specified.

-nolist               Keeps the pick command from generating a list of the
                      selected message numbers (see the -list flag).  If a
                      sequence is specified, -nolist is the default.

-nopublic             Restricts the specified sequence to your usage.
                      -nopublic does not restrict the messages in the sequence,
                      only the sequence.  This option is the default if the
                      folder is write-protected from other users.

-not                  Forms a logical NOT operation on a message selecting flag
                      (for example, "pick -not -from george").  This
                      construction evaluates to all messages not chosen by the
                      message selecting flag.  -not has precedence over -and,
                      and -and has precedence over -or.  Use the -lbrace and
                      -rbrace flags to override this precedence.

-nozero               Appends the selected messages to the specified sequence
                      (see the -zero flag).






Processed November 8, 1990        PICK(1m,C)                                  3





PICK(1m,C)                  AIX Commands Reference                   PICK(1m,C)



-or                   Forms a logical OR operation on two message selecting
                      flags (for example, "pick -from amy -or -from mark").
                      -not has precedence over -and, and -and has precedence
                      over -or.  Use the -lbrace and -rbrace flags to override
                      this precedence.

-public               Makes the specified sequence available to other users.
                      -public does not make protected messages available, only
                      the sequence.  This option is the default if the folder
                      is not write-protected from other users.

-rbrace               Groups -and, -or, and -not operations.  Operations
                      between the -lbrace and -rbrace flags are evaluated as
                      one operation.  You can nest the -lbrace and -rbrace
                      flags.

-search pattern       Selects messages that contain the character string
                      pattern anywhere in the message.

-subject pattern      Selects messages that contain the character string
                      pattern in the subject field.

-sequence name        Stores the messages selected by the pick command in the
                      sequence name.

-search pattern       Selects messages that contain the character string
                      pattern in the subject field.

-to pattern           Selects messages that contain the character string
                      pattern in the To: field.

-zero                 Clears the specified sequence before placing the selected
                      messages into the sequence.  This flag is the default
                      (see the -nozero flag).

--component pattern   Selects messages that contain the character string
                      pattern in the heading field component(for example, "pick
                      --reply-to amy").

PROFILE ENTRIES

Current-Folder:       Sets your default current folder.
Path:                 Specifies your user_mh_directory.

FILES

$HOME/.mh_profile     The MH user profile.

RELATED INFORMATION

See the MH command "mark."




Processed November 8, 1990        PICK(1m,C)                                  4





PICK(1m,C)                  AIX Commands Reference                   PICK(1m,C)



See the mh-profile file in AIX Operating System Technical Reference.

See "Overview of the Message Handling Package" in Managing the AIX Operating
System.



















































Processed November 8, 1990        PICK(1m,C)                                  5



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026