PQ-SELECT

Executed from a Proc, loads a list of item-ids into a select register.

Syntax

PQ-SELECT register-number

Syntax Elements

register-number is the number of the select register (1 to 47) in which the item-ids are to be placed.

Comments

To process a selected list generated within a Proc, PQ-SELECT must be placed in the stack.

The item list processed by PQ-SELECT can be obtained as the result of the execution of a SELECT command, or of any other TCL (or English) command that generates an active list. Refer to Select Registers for a complete list of commands that generate an active list.

Item-ids are referenced one at a time, using a !n direct or indirect reference.

This command cannot be executed directly at TCL.

An example showing the use of PQ-SELECT in conjunction with the Proc command IF S is included in the description of that command.

Example

001 PQN
002 HSSELECT BLOCK-CONVERT
003 STON
004 HPQ-SELECT 1
005 P
006 10 MV %1 !1
007 IF %1 = "" X
008 T %1
009 GO 10

This example selects all the items in the BLOCK-CONVERT file, loads the item-list into select register 1 and displays them one at a time.