pclient.conf file and parameters

Host and port of the Java Naming Provider service of JServer

BMC TrueSight Infrastructure Management Server host: 1100

Specifies the BMC TrueSight Infrastructure Management Server (usually by host name) that authenticates the CLI commands

localhost: 3084

Specifies the length of time, in seconds, that CLI commands wait for an acknowledgment of a request

Normally, the BMC Impact Publishing Server immediately acknowledges any request that it receives. If the request times out, it often indicates that the publishing server is not receiving the request (for example, when the publishing server is not running) or the JMS service of JServer is not up and running.

To change this value, edit the ConnectionInitTimeout parameter in the installationDirectory/pw/server /etc/pclient.conf file.

5 seconds

Specifies the length of time, in seconds, that a CLI command waits for the completion of a request.

Request processing can take a reasonable amount of time, depending on the type of request. If the request times out, the CLI command stops following the request processing.

To change this value, edit the RequestTimeout parameter in the installationDirectory/pw/server /etc/pclient.conf file.

3600

Outputs messages in the language of the specified locale if message resource files for the language are defined. The format is language_country (for example, en_us). Language is a valid two-letter ISO Language Code as defined by ISO-639. Country is a valid two-letter ISO Country Code as defined by ISO-3166.

inherits system's locale

Parameters specific to the publish CLI command

Indicates specific filters for publication. If no filters are specified, then all filters in the environment are published.

none

Indicates whether the publishing server must look for additions, modifications, and soft deletions that are to be published. The option is set to T when an automated publication is triggered from a reconciliation job with Merge activity.

T

Indicates whether the publishing server must look for hard deletions that are to be published. This option is set to T when an automated publication is triggered from a reconciliation job with Purge activity.

F

Sets the password of a secured publish environment for the execution of the publish CLI command.

none

Indicates whether a publish request, preview request, or both are cancelled after timing out.

If T (true), then the request is canceled when it times out. This is the behavior in version 7.3 and earlier.

If F (false), pserver continues with the ongoing request. You can view the result of the request in the request log.

F

Indicates whether confirmation is required to cancel a publish or preview request.

If T (true), then confirmation (yes or no) is required to cancel requests. If no answer is given, confirmation times out and the behavior is as defined by RequestTimedOutCancel.

If F (false), the request is cancelled without confirmation. This is the behavior in version 7.3 and earlier.

T

Parameters specific to the pposter CLI command

Indicates whether pposter must stop when encountering invalid data in the source file.

If T (true), the default, pposter sends as much data as possible, skipping invalid data in the source file.

If F (false), pposter stops as soon as invalid data in the source file is encountered and no data is sent to the cell, not even those items processed before the incorrect data in the source file.

T

When set to T (true), pposter removes all existing data in the cell of the publish environment and recopies the data in the input BAROC file to the cell.

When set to F (false), pposter incrementally updates the cell of the publish environment with data in the input BAROC file.

F

Sets the password of a secured publish environment for the execution of the pposter CLI command.

none

Parameters specific to the pclassinfo CLI command

Indicates whether pclassinfo retries exporting or validating class information when AtriumCMDB Publishing is not yet active.

AtriumCMDB Publishing might take some time to initialize, and cannot receive class information until initialization is completed. If T (true), pclassinfo tries to export or validate as often as the RetryOnAtriumPublishNotActiveWaitTime parameter indicates (default 5 seconds), for as long as the pclassinfo RequestTimeout indicates (default 1 hour). If F (false), pclassinfo does not retry exporting or validating the class information after the initial failure.

T

Sets the length of time, in seconds, to wait before retrying to export or validate class information when RetryOnAtriumPublishNotActive is set to T (true).

5

Parameters specific to the penv CLI command

Specifies the asset data set name

BMC.ASSET. EnvId

Sets the asset data set type
Options are Regular or Overlay.

Regular

Sets the underlying data set ID
Used when AssetDataSetType=Overlay

BMC.ASSET

Indicates whether automated publishing on the publishing environment is enabled.

The default value is T (true), except in an overlay publish environment (an overlay dataset that has a publishing mode of overlay), which defaults to F (false). Automated publication, therefore, is enabled on PROD environment and on test environments, by default.

T

Defines cell alias and cell name pairs that are unique in a given environment, in the BAROC list of string format:
[cellAlias,cellName[cellAlias,cellName]]

This parameter applies only on Direct Publish environments. For Atrium CMDB environments, cell aliases cannot be created or modified with the penv CLI command.

not defined

If cell aliases are not used, you can set this parameter as an alternative, in the BAROC list of string format:
[cellName,cellName]

This parameter applies only on Direct Publish environments.

not defined

Enables (T) or disables (F) the removal of aliases of an environment, which releases the cells for use in another environment.

F (false)

Enables (T) or disables (F) the removal of the asset data set along with all objects in the data set

F (false)

Enables (T) or disables (F) the removal of all data instances (including management data) of the service model from the cells

T (true)

Specifies a description for the environment to BMC Asset EnvDesc

BMC Asset EnvDesc

Sets the environment name to BMC Asset EnvId

BMC Asset EnvId

Sets the format of information to Raw (a parsable data stream) or Display (readable by a user)
Specific to the CLI; it is not sent to the Publishing Server as a request.

Display

Sets the cell to which the entire service model is published.
If set, Cell Aliases are not used.

not set

Specifies whether management data is initialized, T (true) or F (false)

F

Determines the amount of information displayed by the info action command. Cell names and aliases are displayed only when -p "Level=1" is part of the command string.

0

Sets a new password for a secured environment

not defined

Confirms a new password for a secured environment

not defined

Specifies the origin of the environment
Options are AtriumCMDB or Direct Publish.

AtriumCMDB

Sets a password for a secured environment

not defined

Determines the mask used when retrieving publishable management data instances if AssetDataSetType = Overlay

If Overlay, all instances of the overlay data set, and the underlying data set, are considered.

If Current, only instances of the overlay data set are considered.

Overlay

Indicates the classes that can be published in Direct Publish environments only

If T (true), only Service Impact Management classes are published.

If F (false), components and relationships of MC_SM_COMPONENT, MC_SM_RELATIONSHIP, and all subclasses cannot be published.

T

Causes the import of initial management data from instances in the .baroc files pointed to in the .load file. Service model instances in those files are ignored. This parameter cannot be set if SourceEnvMgmtData is set.

installationDirectory/pw/server /etc/<PSName>/kb/data/.load
This is the default value for the PROD environment.