Skip to main content

1E 23.7 (SaaS)

SuccessCodes

A list of Nomad return codes that are translated as success to the Content Transfer Manager (CTM) component of the Configuration Manager client.

Registry value

Default

Notes

Installer property

SuccessCodes

0x206b, 0x2077, 0x103, 0xffffffff, 0x1, 0x70, 0x2050, 0x2051, 0x2052, 0x2053, 0x2054,0x2055, 0x2056, 0x2057, 0x2058, 0x205a, 0x205b, 0x205c, 0x205d, 0x205e, 0x2060, 0x2061,0x2062, 0x2063, 0x2064, 0x2065, 0x2066, 0x2067, 0x2068, 0x2069, 0x209A

This REG_SZ value contains a comma-delimited list of possible Nomad return codes that should be treated as a success and thereby prevent Configuration Manager from attempting to download the content itself or use another Alternate Content Provider (ACP). Any code returned by Nomad that is not on the list will be treated as a failure and trigger the Configuration Manager client to attempt to download the content using alternate means. Nomad also sends a status message to the Configuration Manager site containing its return code.

Strictly speaking the Nomad return codes are actually internal status codes, Nomad will only ever return success or failure to the Content Transfer Manager (CTM) component of the Configuration Manager client. When CTM receives a success it passes control to the ExecMgr component of the Configuration Manager client, which attempts to execute the deployment. ExecMgr will fail if Nomad did not download the content and make it available in the Configuration Manager cache. In this case, ExecMgr sends a status message (e.g. failed deployment) back to the Configuration Manager site.

If Nomad generates a return code that is not in the list, it passes a fail to the CTM component which causes the Configuration Manager client to try downloading the content itself using BITS, or use another Alternate Content Provider (ACP). This process may itself succeed or fail depending on the conditions that resulted in the original Nomad return code, and may have an undesirable impact on the network.

Note

The special code 0x9999 can be added to the list, or used on its own, to cause Nomad to always return a success to CTM. As a consequence this code is also known as "prevent failover to BITS".

Note

The SuccessCodes list need not be modified under normal circumstances, other than to add or remove the 0x9999 code.

The following table shows the possible Nomad return codes that can be set in the list:

Note

This list is subject to change with each release of Nomad, and provided for reference only.

Return Code

Description

Dec

Hex

‭-1

0xFFFFFFFF

Reserved.

1

0x0001

Reserved.

112

0x0070

Insufficient disk space to create the cache.

259

0x0103

Reserved.

8272

0x2050

The download has been suspended by APM.

8273

0x2051

The user has cancelled this download.

8274

0x2052

Invalid command line.

8275

0x2053

Command-line execution failure.

8276

0x2054

Internal Error.

8277

0x2055

The package exceeds the threshold for a RAS connection.

8278

0x2056

The package exceeds the threshold for a Slow LAN connection.

8279

0x2057

The package exceeds the threshold for a Fast LAN connection.

8280

0x2058

Reserved.

8281

0x2059

Unknown transport. Returned when an attempt is made to download a Software Update from an Internet location (like Microsoft Updates).

8282

0x205A

Invalid special package path (set using --pp).

8283

0x205B

Incorrect file hash.

8284

0x205C

Exited due to a kill request.

8285

0x205D

DP path not found.

8286

0x205E

The MaxBusyBackOff consecutive event threshold has been exceeded.

8287

0x205F

The service has stopped.

8288

0x2060

The advertisement has expired.

8289

0x2061

Reserved.

8290

0x2062

This is an unlicensed version of Nomad.

8291

0x2063

Invalid alternate cache path (set using --cp).

8292

0x2064

No Configuration Manager job data found in WMI.

8293

0x2065

Incorrect package hash.

8294

0x2066

MaxDuration or execution runtime for this program has been exceeded.

8295

0x2067

Reserved.

8296

0x2068

Incorrect package version.

8297

0x2069

Obsolete package version.

8298

0x206A

The BlockSize has been changed during download.

8299

0x206B

The "no progress" re-check threshold has been exceeded.

8300

0x206C

The parent process has terminated.

8301

0x206D

Duplicate download for the package.

8302

0x206E

The service was reset. This will occur if certain configuration parameters are changed during a download e.g. NomadInhibitedSubnets

8303

0x206F

Nomad inhibited.

8311

0x2077

Internal error LST incomplete.

8346

0x209A

Client certificate missing. Nomad is configured to use certificate-based client authentication but was unable to find an appropriate certificate.

MODULE.NOMAD.SUCCESSCODES

(This installer property was introduced in 1E Client 4.1 for Nomad 7.0)