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. Products differ in their support for default streams (setting this parameter to 0): Atlas A3 Training Series Product: supported Atlas A2 Training Series Product/Atlas 800I A2 Inference Product: supported Atlas 200/500 A2 Inference Product: not supported Atlas Inference Series Product: not supported Atlas Training Series Product: not supported
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.

Products differ in their support for default streams (setting this parameter to 0):

Atlas A3 Training Series Product: supported

Atlas A2 Training Series Product/Atlas 800I A2 Inference Product: supported

Atlas 200/500 A2 Inference Product: not supported

Atlas Inference Series Product: not supported

Atlas Training Series Product: not supported

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