Return codes for Publishing Server CLIs

1

Indicates a syntax error on one or more command-line arguments or options

Verify the correct syntax for the command string.

2

Indicates an invalid number option

Verify the correct syntax for numerical options such as -t and -u.

3

Indicates that the home directory (installationDirectory/pw/server) of the application can not be found

Perform the following step:

1. Verify that the installationDirectory/pw/server environment variable is set for the application.
2. Verify that the CLI script (.bat or .sh) file  contains the correct path:
   -DHomeLocation=installationDirectory/pw/server
3. Specify the home directory (-l HomeLocation) path at the command line.

10

Indicates a generic (unspecified) error

(This is an internal error.) Do the following steps:

1. Enable tracing and run the command again.
2. Locate the installationDirectory/pw/server /tmp/pcli/pcli.trace file to submit to BMC Support.
3. Contact BMC Support and file a user case for this failure.

11

Indicates that the CLI is unable to initialize its communication layer

Retry the command. If the error still occurs, do the following steps:

1. Verify that the URL of the provider specified in the installationDirectory/pw/server /etc/pclient.conf file is correct.
2. Restart the BMC TrueSight Infrastructure Management Server and BMC Impact Publishing Server.
3. Try the command again.

12

Indicates a communication failure when the CLI sent data to its communication provider, for example, the jBoss server

Retry the command. If the error still occurs, do the following steps:

1. Restart the BMC TrueSight Infrastructure Management Server and Publishing Server.
2. Try the command again.

13

Indicates that the CLI cannot decode an answer that it has received from its communication provider

(This is an internal error.) Do the following:

1. Enable tracing and run the command again.
2. Locate the installationDirectory/pw/server/tmp/pcli/pcli.trace file to submit to BMC Support.
3. Contact BMC Support and file a user case for this failure.

14

Indicates that the CLI cannot find a file that it requires to run properly; for example, a FileNotFound exception

Verify that the file whose name appears as missing does exist.

15

Indicates that the CLI cannot resolve a host name

Repair the computer's network settings

16

Indicates the failure to authenticate with the BMC TrueSight Infrastructure Management Server

Perform the following steps:

• If you are running a CLI command, verify the credentials that you specified.

• If automatic authentication is set up in the pclient.conffile, verify that the credentials (IASUsername, IASPassword, and IASServers) are valid.

17

Indicates an Impact interface initialization failure; for example the I18N configuration might be wrong

Perform the following steps:
Verify that the file installationDirectory/pw/server/etc/locale/pclient.load file exists on the host where the pcli is running/installed.

18

Indicates that the UTF-8 character set is not supported by the host

The host computer must support the UTF-8 character set.

19

Indicates that the CLI does not have a request identifier

Perform the following steps:

1. Enable tracing and run the command again to generate a trace.
2. Locate the installationDirectory/pw/server/tmp/pcli/pcli.trace file to submit to BMC Support.
3. Contact BMC Support and file a user case for this failure.

20

Indicates an I/O error when the publishing log file is written

Verify that the write permission is set for the publishing request log file. You must specify the name of the RequestLogFile for a CLI command by using the -r common option.