www.beck-ipc.com

@CHIP-RTOS C Library - BIOS API


BIOS_Set_Batch_Mode

Set batch file mode.

void BIOS_Set_Batch_Mode ( BATCH_MODE mode,
                           unsigned int enable_timeout );

Parameters

mode

BATCH_CONCURRENT= 0:    Sets BATCHMODE =0 = concurrent
BATCH_SEQUENTIAL= 1:    Sets BATCHMODE =1 = sequential

enable_timeout

Boolean:
0:    Disable the maximum delayed execution time-out of DOS programs
1:    Enable the maximum delayed execution time-out of DOS programs in a batchfile, if BATCHMODE = 1 (sequential)

Return Value

-- none --

Comments

This function sets the batch file execution mode of DOS programs for either concurrent or sequential execution.   See BATCHMODE initialization documentation for details.

The enable_timeout parameter only applies to BATCH_SEQUENTIAL mode.
Important:
    If  BATCHMODE=1 take care that every program in your batch file which has a successor program either exits (int21h 0x4C) or terminates resident with int21h 0x31.   A program which runs forever should call BIOS_Batch_Continue API function, which immediately enables further batch file sequencing.

    By default the maximum delay time for execution of the next listed program in the batch file is 15 seconds.   If enable_timeout parameter is set to 0, the successor program in a batch file waits forever for execution, if the predecessor program does not finish or call BIOS_Batch_Continue.

See Also

RTOS API

This library function invokes a RTOS software interrupt.   Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.00V1.00V1.00V0.90V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document