This text was automatically converted from troff me macros to HTML. Information may have been lost, added, or changed in the process. Lars Aronsson and Lysator do not guarantee the correctness of this HTML document.
move *- move the pointer in a portal
move [ ( forward | backward ) ]
[ ( number | all | to ( number | record_qual ) ) ]
[ in portal_name ]
Move allows a user to move the "instance pointer" within the portal named portal_name . Each portal has an instance pointer, which points to the previous instance to be fetched. It always points to before the first instance when the portal is first created. The pointer can be moved forward or backward . It can be moved to an absolute position or over a certain distance. An absolute position may be specified by using to; distance is specified by a number. Record_qual is a qualification with no instance variables, aggregates, or set expressions which can be evaluated completely on a single instance in the portal.
/* Move backwards 5 instances in the portal FOO */ move backward 5 in FOO /* Move to the 6th instance in the portal FOO */ move to 6 in FOO
retrieve(commands), fetch(commands), close(commands).
This command is not yet available. The pointer may be moved using the fetch command, and ignoring its return values.