Chapter 21 Import Operations Format

This supplement describes the PAR import operations list format.

Operations Format

Each operation (op) on the command line, must be specified as a pipe (|) separated list of keywords that can have values, most of which are optional. The operations are in space separated list. Each operation is in the following format:

dpnode=dn,entry=name,provider[=name],channel[=name],container=name[,avail=name,selected]

Here:

dpnode

Specifies the distinguished name in the directory server (or the keyword global) for the display profile document that this operation is targeted at. This may not apply if the context it is being specified in has already provided this. For example, if the import subcommand defines the distinguished name, the distinguished name in the file is ignored.

entry

Specifies the entry name in the .par file. This is not needed if the:

• .par file only contains one entry, as the operation defaults to that entry

• Operation is already associated with an entry such as the auto extract option for an entry.

The utility defaults to the first entry in the file if an entry is not specified.

provider

Indicates that a provider extraction is to take place. If the name is missing, it uses the name packaged with the provider in the .par file.

channel

Indicates that a channel extraction is to take place. If the name is missing, it uses the name provided with the channel in the .par file.

container

Indicates which container the channel is to be inserted into and applies only to channel extractions. If omitted, the channel is inserted into the channels element at the display profile document root.

avail

Indicates a container whose avail (or available) list is to receive a reference to the new channel and applies only to channel extractions. If omitted, no new channel reference is created.

selected

Indicates that the container whose avail list received a reference, also has a reference placed in its selected list and applies only if avail was used.

If the op information is in both the import subcommand and in the .par file, the command information takes precedence