plogdisplay

Use the plogdisplay command to convert the XML log for a request to text and output it to standard output. Use this command with the plog command.

plogdisplay syntax

plogdisplay <common options> (-@ | <RequestLogFile>)

plogdisplay command options

You must specify an input for the command; it can be either standard input (-@) or a specified file.

The following table lists the options for plogdisplay.

plogdisplay options

Option

Description

<common options except: -r, -t, and -u>

See Common command options for Publishing Server CLIs.
This command does not interact with the BMC Impact Publishing Server, so it does not accept these CLI common options: -r, -t, and -u

-@| RequestLogFile

Specifies the source of input to display
Use one of these arguments:

Use -@ to indicate standard input as the source to display.
For a specific publishing request, type the name of the XML log file as the source to display.

plogdisplay examples

This section provides examples of using the plogdisplay command to convert an XML log file for a publishing request to text and output it to standard output.

Converting an XML log file for a specific publishing request to text

To convert the XML log file for a publishing request to text and output it to standard output, type a command similar to the following command, substituting the correct xml file name:

publish -r myLog.xml
plogdisplay myLog.xml

Viewing the XML log for a specific publishing request as a text in stdout

You can pipe the output of the plogdisplay command through the plogdisplay command to convert it to text format and output it to standard output. To view a specific publishing, log on to text format and type the following command:

plog -r -s Z00000e8mu7xw9Xpa1ZfsMZeg4v1Z | plogdisplay -@

plogdisplay return codes

The plogdisplay command returns a nonzero value if it encounters any errors during execution. It returns a zero (0) value on successful execution, as shown in the following table.

plogdisplay return codes

Code	Description
`0`	Success
a number other than `0`	Error When a CLI command exits with a return value other than 0, additional textual information about the error cause is displayed to standard output and, possibly, to the generated publishing CLI trace file pcli.trace. For information about these error codes, see Return codes for Publishing Server CLIs.