SELECT primary command

The SELECT primary command is used to select members or fields, depending upon where it is used. It can be entered on the following panels:

  • Member selection
  • Field Selection/Edit

Syntax

SELECT in member selection panels

The SELECT primary command is used to select members listed in member selection panels. It performs the equivalent processing of the S prefix command against member names matching the supplied pattern or member name.

SELECT results in one of the following:
  • A single member is selected and returned to the calling routine. (Subsequent selections are ignored.)
  • Toggling of the selected value in the Prompt field.
  • Selects a member to be processed by the function that invoked the member list.

You can clear the selection of members with the RESET command.

Syntax for member selection panels:

Read syntax diagramSkip visual syntax diagram
Syntax - Member Selection panel

                          .-HOLD---.   
>>-Select-+-*-----------+-+--------+---------------------------><
          '-member_name-' '-NOHOLD-'   

*
Specifies that all members in the list are to be selected.
member_name
Specifies that the named member is to be selected. Can be a member name pattern, to select all members with a matching name.
HOLD
Default. Specifies that after selecting one or all members you wish to pause before processing commences. Whilst in HOLD mode, you can scroll UP and DOWN to view selected members and select or deselect members to refine your list. Pressing Enter causes processing to commence. You can use the LOCATE command whilst in pause mode and processing does not commence until you press Enter again.
Note: For functions where the SELECT command toggles selection, this parameter is ignored and the behaviour is always NOHOLD.
NOHOLD
Specifies that processing is to be run immediately.
Note: For functions where the SELECT command toggles selection, this parameter is ignored and the behaviour is always NOHOLD.
Examples
SELECT MBR
Selects the single member, MBR.
SELECT *
Selects all the listed members.
SELECT a*
Selects all the listed members starting with the letter "A".
SELECT *z
Selects all the listed members ending with the letter "Z".

SELECT in Field Selection/Edit

In the Field Selection/Edit panel, this command selects or deselects all of the listed fields.

Read syntax diagramSkip visual syntax diagram
Syntax - Field Selection/Edit panel

              .-ON--.   
>>-+-SELect-+-+-----+------------------------------------------><
   '-ALL----' '-OFF-'   

ALL
Denotes all fields.
ON
Select all fields.
OFF
Deselect all fields.