TRANSCODE_FAIL= LIBNAME Statement Option

Lets you specify how to handle processing and notification of transcoding errors.

Valid in: SAS/ACCESS LIBNAME statement
Category: Data Set Control
Default: ERROR
Restrictions: This option is deprecated in SAS Viya 3.5. Use the SUB_CHAR= LIBNAME option instead.
This option is not available for use with SAS Embedded Process.
Data source: Hadoop, JDBC
Tip: You can use TRANSCODE_FAIL= to determine whether you want to halt or continue processing when transcoding errors are encountered.
See: SUB_CHAR= LIBNAME option, SAS/ACCESS LIBNAME options for NLS, TRANSCODE_FAIL= data set option

Table of Contents

Syntax

TRANSCODE_FAIL=ERROR | WARNING | SILENT

Optional Arguments

ERROR

stops processing data and provides an informative error message.

WARNING

continues processing of data but provides an informative error message.

SILENT

continues processing of data but suppresses messages.

Details

The TRANSCODE_FAIL= LIBNAME option is deprecated in the SAS Viya 3.5 (November 2019) release. Using this option stops processing and results in an error in the SAS log. Use the SUB_CHAR= LIBNAME option instead.

Last updated: February 3, 2026