Distributed Server Administration program
In this topic:
The data in many distributed fields is system-generated (DSO sets their values). You cannot manually change the values of such fields in a request. The ardist program, however, enables you to overwrite the values in these distributed fields:
- From Form
- From Mapping
- From Pool
- From Server
- Master Flag
Warning
The ardist program simply edits field values in a specified request. It does not distribute data between forms and should not be considered a command-line version of DSO.
The following table lists the ardist command-line arguments.
Note
If you use corresponding uppercase and lowercase arguments in the same command line, such as*-m 1 -M*, the field value is set to NULL.
Command-line arguments for ardist
Argument |
Description |
---|---|
|
Sets the From Form field to NULL. This is a flag; do not assign it a value. |
|
Sets the From Form field value. Use this to change the source form name. |
|
Runs the program in Debug mode, printing debug information to the terminal. This is a flag; do not assign a value to it. |
|
Specifies the ID of the request to modify. |
|
Specifies the directory in which the AR System server is installed. |
|
Sets the From Pool field to NULL. This is a flag; do not assign it a value. |
|
Sets the From Pool field value. Use this to change the source pool name. |
|
Sets the Master Flag field to NULL. This is a flag; do not assign it a value. |
|
Sets the Master Flag field to the specified value (1 = Yes, 0 = No). Use this if your transfer gives you zero or multiple requests with ownership. |
|
Sets the From Mapping field to NULL. This is a flag; do not assign it a value. |
|
Sets the From Mapping field value. Use this to change the mapping name. |
|
Sets the From Server field to NULL. This is a flag; do not assign it a value. |
|
Sets the From Server field value. Use this to change the source server name. |
|
Specifies the name of the form containing the request to modify. |
|
Specifies the name of the server on which the form (-s ) containing the request to modify resides. |
Overwriting distributed fields scenario
In the Acme Product Info Archive form on the chicago server, this example procedure sets the following field values in request ID 1234567:
Field |
Value set by ardist example command |
---|---|
From Form |
Acme West Bug Tracking |
Master Flag |
NULL |
From Mapping |
Acme ProdInfoArch W to E |
From Server |
sanfrancisco |
To overwrite distributed fields in a specified request
- Perform one of these actions:
- In Windows, open a DOS session.
- In UNIX, go to step 3.
- Change to the ARSystemServerInstallDir directory containing ardist.
- At the prompt, enter this command:
ardist -i <ARSystemServerInstallDir> -c "Acme West Bug Tracking"
-e 1234567 -M -p "Acme ProdInfoArch W to E"
-r sanfrancisco -s "Acme Product Info Archive" -x chicago
Comments