MKPROPAGATIONLIST / MKPL 

Use

Creates a propagation list. In most cases, propagation lists are used to propagate changes between workspaces. Typically, a propagation list is created to capture the current state of a workspace. In other words, active versions of the objects exposed in the workspace are put into the propagation list including deletion versions. Then, this propagation list is integrated into another workspace, which effectively means that changes are propagated into this workspace. In case the target workspace (the workspace where the changes are propagated to) is not in the same repository as the propagation list, then the EXPORT and IMPORT commands are used to physically transport the propagation list from one repository to another. 

Syntax

Syntax	MKPROPAGATIONLIST [-s] [-c "description"] [-n "displayName"] [-p "propagtionListName"] <-w "workspacePath"> [-rind "dateRange"]
Arguments
[-s]	Will suppress the popup window for changing the propagation list description and display name.
[-c "description"]	Used to set a description of the propagation list in non-user interface mode.
[-n "displayName"]	Used to set a display name of the propagation list in non-user interface mode .
[-p "propagtionListName"]	Name of the propagation list to be created. If none is specified then a name is generated based on the workspace, user and current time.
<-w "workspacePath">	Workspace path to specify the workspace for which the summarizing of changes will be done. If the workspace is not specified, the current working directory is used.
[-rind "dateRange"]	Use this argument if the propagation list population has to be based on a time range. -rind @indlowerlimit [@indupperlimit] Both indlowerlimit and indupperlimit are timestamps. The format of the timestamp is: yyyy-mm-dd hh:mm:ss. -rind "@2007-04-01 00:00:00" "@2007-05-01 00:00:00" Here a propagation list of all changes in the workspace between 1st April 2007 and 1st May 2007 will be created. -rind "@2007-04-01 00:00:00" Here a propagation list is created of all changes in the workspace after April 1, 2007.
-risn	This option should be specified if the listing has to be based on Integration Sequence Numbers (ISNs) of the activity. Populates propagation list with activities whose ISN is between 3 and 8: -risn @3 @8 Populates propagation list with activities whose ISN is greater than 8: -risn @8
Description	Creates, populates and closes a propagation list.

Examples

Creating a Propagation List

...

To create a propagation list p1 which will capture the current state of workspace //path/to/wsp, execute:

mkpl –p p1 –w //path/to/ws

Creating a Propagation List to Show Recent Changes

The propagation list p1 from the previous example was created on May 1, 2007 and integrated into another workspace //path/to/ws2.

The requirement is to capture the state of workspace //path/to/ws again into a new propagation list and to integrate this propagation list into the target workspace //path/to/ws2. You could do that the same way as in the previous example. However, you can also create the propagation list p2 in such a way that it captures only changes in the workspace //path/to/ws, which occurred after the propagation list p1 was created (after May 1, 2007). This way, the propagation list p2 might be significantly smaller in size. This is done in the next command:

mkpl –p p2 –w //path/to/ws –rind “2007-05-01 00:00:00”