function allocate next batch id
NAME [edit section]allocate_next_batch_id
SYNOPSIS [edit section]Allocate and return the next global batch id for the Fuego system.
DESCRIPTION [edit section]This function reads the global batch_id file for Fuego, and returns it. It then increments the number and saves it back to the file for the next allocation operation.
The global batch_id is stored in $FUEGO_RW/logs/next_batch_id, and is global over all tests.
Using this function will make the batch_id a monotonically increasing decimal number.
Callers of this function are encouraged to use this global number for batch tests, but to also prefix the number with a test-specific string, so that batch_ids are easier for humans to associate with their related batch tests.
EXAMPLES [edit section]Here are some sample invocations:
ENVIRONMENT and ARGUMENTS [edit section]Environment variables used:
RETURN [edit section]Returns non-zero on error.
SOURCE [edit section]Located in scripts/functions.sh
SEE ALSO [edit section]