Using Enterprise server commands

You can display a list of the server commands by entering help at the Enterprise server command prompt.

The available server commands are listed below alphabetically, with a description of each. Parameters in square brackets are optional and those in angle brackets are mandatory.

If you have installed the server as a service, you must first use the Controller application to display a window for the server in which you can enter commands.

clear errors

Clears the Enterprise server's error log.

clienttracelevel <trace level number>

With a trace level number of 1, turns the trace service on for all client computers; with a trace level number of 0, turns the trace service off for all client computers.

clienttracepath <folder name>

Specifies that all client computer trace files are saved into a specific folder to the default. You should specify a shared folder to which all client computers have access, for example \\myserver\clienttrace\.

convert <source data source ID[:<project ID>[-<end project ID>]]> <target data source ID>

Converts an Asta Powerproject data source from Version 16 format to Version 17 format. You can specify a range of projects within the data source to convert, if required. For example, if AAAAAA is a Version 16 data source containing projects 1000, 1001, 1002, 1003 and 1004 and BBBBBB is an empty Version 17 data source:

convert AAAAAA BBBBBB would convert all of the projects and their baselines in the Version 16 data source to Version 17 format.

convert AAAAAA:1000 BBBBBB would convert project 1000 and its baselines in the Version 16 data source to Version 17 format.

convert AAAAAA:1000-1000 BBBBBB would convert project 1000 in the Version 16 data source to Version 17 format, but would not convert its baselines.

convert AAAAAA:1000-1003 BBBBBB would convert projects 1000, 1001, 1002 and 1003 in the Version 16 data source to Version 17 format, but would only convert the projects' baselines if the baseline project IDs were included in the range specified.

convertreport <data source ID> <filename>

Lists the project and baseline IDs within an Asta Powerproject data source. This command may be useful if you need to convert a data source from Version 16 format to Version 17 format: you can run this command before running the convert command in order to view the IDs of the projects and baselines within the data source that you are going to convert. For example, if AAAAAA is a Version 16 data source:

convertreport AAAAAA would list the project and baseline IDs within the data source.

custom <data source ID> <filename>

Creates a SQL script that can be used to recreate the custom definitions (user-defined fields, enumerators and tables) in a data source. This could be useful if, for example, you wanted to move your baselines from one data source to another. Both data sources would need to have the same custom definitions, so rather than recreating them manually, you could use this server command to create a SQL script that will create them. For example, if AAAAAA is a data source:

custom AAAAAA customdefscript would create a SQL script called "customdefscript" that, when run, would recreate all of data source AAAAAA's custom definitions in a new data source.

datasources

Displays a list of the data sources that are available to the Enterprise server.

disable logins

Prevents any more users from logging on to the Enterprise server. Users who are already logged on can continue to use the server.

dismount <runtime project ID>

Dismounts a project that has been mounted on the server using the mount command.

eject <username> [<computer ID>|*|<computer name>]

Ejects the specified user from the Enterprise server. This might be useful if the maximum number of users has been reached and you want to make room for someone else to log on.

enable logins

Enables users to log on to the system after logins have been disabled using the disable logins command.

errors

Displays the error log for the Enterprise server.

exit

Terminates the Enterprise server without warning the clients first.

failed

Lists the clients with failed connections.

fix on mount

Enables the automatic repair of projects when they are mounted.

help

Displays a complete list of the Enterprise server commands, with a brief description of each command.

lock <runtime project ID>

Locks project-level users out of the specified project. All users, except those selected by the project's top-level user in the Lockout Settings dialog in Asta Powerproject, are locked out of the project, and no new users can access the project, until the project is unlocked using the unlock server command. A project must be mounted before it can be locked.

lockinguser

Displays the name of the user that has locked users out of a project.

logins

Displays whether logins are currently enabled or disabled.

memory

Displays the amount of memory being used by the server.

mount <data source ID>:<project ID>

Mounts a project on the Enterprise server. If a project will be opened and closed frequently, you can speed up access times by mounting the project explicitly using the mount command. This prevents the project from being dismounted automatically when all users have finished working with a project.

mount with baselines <data source ID>:<project ID>[,<baseline data source ID>:<baseline project ID>]

Mounts a project on the Enterprise server with all its baselines. If a project and its baselines will be opened and closed frequently, you can speed up access times by mounting the project and its baselines explicitly using the mount with baselines command. This prevents the project and its baselines from being dismounted automatically when all users have finished working with a project or baseline.

If you specify only the data source ID and project ID, the project is mounted with all its baselines. If you want to mount the project and one or more specific baselines (rather than all the project's baselines), add the data source ID and project ID of the baseline(s) you want to mount in a comma-separated list.

Baselines that are not marked as "active" in the Baseline/What If Manager dialog in Asta Powerproject are excluded from being premounted. If you have a large number of baselines, you can improve the performance of the system by specifying that old baselines are not active, which reduces the number of baselines that are premounted.

no fix on mount

Disables the automatic repair of projects when they are mounted.

process times

Displays processor time usage information.

projects

Lists the group projects available to the server. For each project, the data source ID, project ID and project name are listed.

publish

Republishes the server.

purge [failed|ejected|*|<user>|<computer>]

Deletes the data that is being stored for the specified connections.

recalc <runtime project ID>

Recalculates the values in the specified project that are calculated from values that are stored on the data source, but are not stored on the data source themselves. This command, which applies only to direct connection data sources, may be useful if you change any project data externally, ie not from within Asta Powerproject.

refresh datasources

Refreshes the list of data sources from the registry.

send [high|medium|low] [[datasource:<data source id>] [project:<project id>]] <message>

Enables you to send messages to the clients who are currently connected to the Enterprise server.

serial

Displays the serial number of the server.

sfh interval

Sets the server failure queue housekeeping interval.

sfq interval

Sets the server failure queue servicing interval.

shutdown <<minutes>|now|cancel>

Terminates the Enterprise server after waiting for the specified number of minutes, or immediately. For example, to shut down the server in 5 minutes time, type shutdown 5. Users are prevented from logging onto the server as soon as you have entered this command. A warning message is sent to each user who is logged on every minute until the server terminates.

status

Displays various server details.

tracelevel <trace level number>

Specifies the level at which the trace service gathers information from the Enterprise server, where <trace level number> is a number from 1 to 4, representing the level to which you want to set the trace service. Set the level at 0 to turn the trace service off.

unblock

Unblocks a login after it has been disabled.

unlock <runtime project ID>

Unlocks a project that has previously been locked using the lock server command, so that all users can resume work on the project and new users can access it.

version

Displays details of which version of the product you are using.

what

Shows the projects and baselines that are currently mounted. For each project or baseline, the following information is displayed:

ID of data source or baseline (these baseline IDs are displayed in parentheses and are the IDs of the baselines as they appear in the Baseline/What If Manager).
Internal ID of project or baseline.
ID of project or baseline as mounted on the server.
The users who have the project or baseline open.

who

Lists all the users who are currently logged onto the Enterprise server.

whoami

Displays the name of this server.