Function: set_stream_failure_mode

Product	Supported (√/x)
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Specifies the task scheduling mode to determine whether to continue the next task after a task fails, when multiple tasks are delivered to a stream.

C Prototype

aclError aclrtSetStreamFailureMode(aclrtStream stream, uint64_t mode)

Python Function

ret = acl.rt.set_stream_failure_mode(stream, mode)

Parameter	Description
stream	Int, pointer address of the stream to be operated. stream cannot specify the task scheduling mode of the default stream (that is, setting this parameter to 0).
mode	Int, the task scheduling mode to determine whether to continue the next task after a task fails, when multiple tasks are delivered to a stream. Value range: ACL_CONTINUE_ON_FAILURE = 0: default value. If a task fails, the system continues to execute the next task. ACL_STOP_ON_FAILURE = 1: After a task fails, the subsequent tasks are stopped.

Parameter

Description

stream

Int, pointer address of the stream to be operated.

stream cannot specify the task scheduling mode of the default stream (that is, setting this parameter to 0).

mode

Int, the task scheduling mode to determine whether to continue the next task after a task fails, when multiple tasks are delivered to a stream.

Value range:

ACL_CONTINUE_ON_FAILURE = 0: default value. If a task fails, the system continues to execute the next task.
ACL_STOP_ON_FAILURE = 1: After a task fails, the subsequent tasks are stopped.

Return Value	Description
ret	Int, error code: 0 on success; else, failure.

This API can be called only once for a specified stream to set the task scheduling mode.
If the stop-on-failure mode is set for a stream, the stop-on-failure mode also applies to other streams in the context of the stream. This restriction applies to the following product models:
Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

Parent topic: Streams Management