HP 3000 Manuals HP 3000 Manuals
SERIES Command
The SERIES command executes a range of steps in the current logic block.
Format
SERIES {begin_step_number} {end_step_number}
{begin_data_ref } {end_data_ref }
Parameters
begin_step_number
The number of the first step to be executed.
end_step_number
The number of the last step to be executed.
begin_data_ref
One of the following, containing the first step number to be executed.
* Numeric constant.
* Variable or calculated item.
* Screen field name.
* Scratch-pad field name.
* File record field reference.
* Work area field reference.
end_data_ref
One of the following, containing the number of the last step to be
executed.
* Numeric constant.
* Variable or calculated item.
* Screen field name.
* Scratch-pad field name.
* File record field reference.
* Work area field reference.
Description
The SERIES command executes a range of command steps within the current
logic block.
The start and end step numbers can have the same value. If this is the
case, HP ALLBASE/4GL only executes one step.
HP ALLBASE/4GL executes the command steps nominated in the SERIES
command. HP ALLBASE/4GL then resumes executing the logic block with the
command following the SERIES command if the SERIES command does not
initiate a PROCEED command,
HP ALLBASE/4GL executes the commands specified by the SERIES command as
if they were contained in a separate logic block called by the VISIT
command. If the commands nominated by the SERIES command include an EXIT
command, execution of the commands specified by the SERIES command ceases
and control returns to the command immediately following the SERIES
command.
The steps nominated by the SERIES command cannot include an ENTER command
that refers to a step outside the range of the series command.
If the commands nominated by the SERIES command contain a further SERIES
command, the steps nominated by the second SERIES command must be wholly
contained within the steps for the first SERIES command.
The step numbers you nominate in a SERIES command must be valid step
numbers for the current logic block.
Example 1
SERIES 12 15
This command executes steps 12 to 15 inclusive. Processing then resumes
at step number 4.
Example 2
SERIES 8 V-last
This command executes steps starting at step number 8 and ending at the
step number defined by the variable last.
If the value in last is greater than the number of steps in the logic
block, all steps from step 8 onwards will be executed.
If the value in last is less than 8, the SERIES command is ignored.