In pconfig.src, a section pcontrol configures the host sequence. For each stage, you can specify some actions to do.

► Note: Note again that you can not change the order of the actions, no matter in what order names appear in that section.

Stages of Phase 2

The pcontrol section can contain lines of the form

StageName = Action

where the StageName is specified in the above description of the stages, and the Action is one of the following:

  • Normal: the stage is run normally. This is the default for all stages.
  • Skip: the stage is not run. ► Note: Some stages are important to PHost and can not be skipped.
  • Replace command: replaces this stage by the specified command (see below). Sections which cannot be Skipped can't be Replaced either.
  • Execute command: execute the specified command, then run the stage normally.
  • Before command:

    (4.0c) same as Execute: execute the specified command, then run the stage normally.

  • After command:

    (4.0c) execute the specified command after the stage has run.

The action names can be abbreviated up to their first letter only.

Each command can be one of the following:

  • file.ini: executes the specified .ini file, from top to bottom. The file is searched in the game and root directory.

    (4.0h) You can also specify absolute paths if you wish.

  • file.ini%section: execute only the specified section from the .ini file. Sections are delimited in the same way as in pconfig.src.
  • *command:

    (4.0c) execute the specified shell command.

    This is a shortcut for making a one-line .ini file.

(4.0c) You can specify multiple actions by giving multiple assignments to the same stage name.

The actions will be executed in order. The stage is skipped when at least one Skip or Replace is used, otherwise the stage will be executed. Therefore, the sequence of actions is:

  • First, execute all Before, Execute and Replace commands, in the order in which they were seen in the configuration file.
  • Unless there was a Skip or Replace action, execute the stage itself.
  • Finally, execute all After commands.

In PHost version 3.4f/4.0b and older, you can have at most one action per stage.

Between Phases (Auxhost)

(4.0k) Instead of making auxhost1.ini and auxhost2.ini files, you can specify the commands directly in pconfig.src.

Auxhost1 = Command
Auxhost2 = Command

The command is just a reference to another ini file or a shell command, as in Auxhost1 = *mfq %d. There is no point in specifying Before, Skip, etc.

This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.