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
`-C`	Sets the From Form field to NULL. This is a flag; do not assign it a value.
`-c`	Sets the From Form field value. Use this to change the source form name.
`-d`	Runs the program in Debug mode, printing debug information to the terminal. This is a flag; do not assign a value to it.
`-e`	Specifies the ID of the request to modify.
`-i`	Specifies the directory in which the AR System server is installed.
`-L`	Sets the From Pool field to NULL. This is a flag; do not assign it a value.
`-l`	Sets the From Pool field value. Use this to change the source pool name.
`-M`	Sets the Master Flag field to NULL. This is a flag; do not assign it a value.
`-m`	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.
`-P`	Sets the From Mapping field to NULL. This is a flag; do not assign it a value.
`-p`	Sets the From Mapping field value. Use this to change the mapping name.
`-R`	Sets the From Server field to NULL. This is a flag; do not assign it a value.
`-r`	Sets the From Server field value. Use this to change the source server name.
`-s`	Specifies the name of the form containing the request to modify.
`-x`	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

Distributed Server Administration program

Overwriting distributed fields scenario

To overwrite distributed fields in a specified request

Comments