ANS2039E: Invalid destination file specification during dsmc restore

Troubleshooting

Problem

During the restore operation, the following error is observed:

$dsmc restore "/var/log/abc.log" "/home/restore/xyz.log" -subdir=no

IBM Storage Protect
Command Line Backup-Archive Client Interface
Client Version 8, Release 1, Level 27.1
Client date/time: 03/12/26 14:27:13
(c) Copyright IBM Corp. 1990, 2025. All Rights Reserved.

Node Name: abc
Session established with server TSM: Linux/x86_64
Server Version 8, Release 1, Level 27.000
Server date/time: 03/12/26 14:27:13 Last access: 03/12/26 14:20:26

ANS2039E Invalid destination file specification '/home/restore/xyz.log' entered

Symptom

The restore process does not complete successfully, and the target file is not restored to the specified destination path.

Cause

In this case IBM Storage Protect server have client option set "-subdir=yes" override client option value.

From "q node node_name f=d" to check if node is associated with Client Option Set.

Optionset: OPT_ABC

Environment

IBM Storage Protect Client version 8.1.x and all further releases.

Diagnosing The Problem

A client service trace indicates that the subdir option is set to YES even restore command have "-subdir=no" specified.

04/23/26 09:31:43.877 [13697660] [1] : dscommnd.cpp (3300): Argument is: '-SUBDIR', value: 'no'
.
04/23/26 09:31:44.474 [13697660] [1] : optservices.cpp (4839): validating server option(SUBDIR) value(YES)
04/23/26 09:31:44.476 [13697660] [1] : optservices.cpp (8144): SrvCanOvrRde(Y) Src(0x0d=Multi ) subdir Yes
.
04/23/26 09:31:44.494 [13697660] [1] : optservices.cpp (4839): validating server option(SUBDIR) value(YES)

Resolving The Problem

Remove the "subdir=yes" option from the client option set (OPT_ABC)

OR

Remove the client node (node_name) from the option set (OPT_ABC).

Removing the subdir in the option set makes the command works.

Related Information

ANS1082E Invalid destination file specification

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB69","label":"Storage TPS"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSEGHY","label":"IBM Storage Protect"},"ARM Category":[{"code":"a8m3p000000hAaFAAU","label":"B\/A Client-\u003ERestore"}],"ARM Case Number":"TS021680065","Platform":[{"code":"PF016","label":"Linux"}],"Version":"8.1.0;8.1.1;8.1.10;8.1.11;8.1.12;8.1.13;8.1.14;8.1.15;8.1.16;8.1.17;8.1.18;8.1.19;8.1.2;8.1.20;8.1.21;8.1.22;8.1.23;8.1.24;8.1.25;8.1.26;8.1.27;8.1.3;8.1.4;8.1.5;8.1.6;8.1.7;8.1.8;8.1.9;8.2.0;8.2.1;8.2.2"}]

Historical Number

TS021680065

Product Synonym

TSM,ISP;SP

Was this topic helpful?

Document Information

Modified date:
07 May 2026

UID

ibm17270839

Tips