Documentation Center

Running PcmPortal in debug mode from the commandline

You can start a PcmPortal service in debug mode at a command prompt by using the debug switch.

Procedure

  1. At a command prompt, go to the SDL Contenta home directory and at the prompt, type:

    PcmPortal -debug -s -Sportal_number -dnum

    where portal_number is a unique number for the portal and num is a debug value (described below).

    For example: PcmPortal -debug -s -S6055 -d1
    Debug value (values for the -d switch)Description
    1Basic debugging; echo commands and responses.
    2Socket debugging; echo results of read/write system calls.
    4Detailed socket debugging; dump the send/receive buffer of each command and response in raw ASCII hex.
    8Create a log file for each PcmPortal process in the directory from which the portal server was started.

    The values can be added together for debugging that contains information for all values in the equation.

    For example, to display basic debugging (echo commands and responses) value 1 information, and socket debugging (echo results of read/write system calls) value 2 information, at a Windows prompt type: PcmPortal -debug -s -S6055 -d3

    set XYV_LOG_PER_PORT <Port #>

    where <Port #> is the port number on which the Portal is to be started.

    For example: set XYV_LOG_PER_PORT 6055

  2. To generate errors messages in the log, execute the SDL Contenta Explorer using the socket number you started in debug mode.
    You specify the socket number for the SDL Contenta Explorer by clicking the Options button in the login window.
    Note the following about starting a portal from a command line:
    • When a portal is started in debug mode from the command line, it does not run as a service; only one portal can be installed as a service.
    • You can run multiple portals in debug mode. Use unique portal numbers for each. For example:

      set XYV_LOG_PER_PORT 6055

      PcmPortal -debug -s -S6055 -d1

      set XYV_LOG_PER_PORT 6056

      PcmPortal -debug -s -S6056 -d1

      set XYV_LOG_PER_PORT 6057

      PcmPortal -debug -s -S6057 -d1