SAVE_PSVSET
This activity saves processing sequence variables and their values to a PSV file. The variables and their values may subsequently be loaded into the same or a different processing sequence using the LOAD_PSVSET activity or transformed using a Transformation Map. Built-in variables (and other variables used internally by LANSA Composer) are not saved.
If no processing sequence variables are selected, the activity completes normally and a valid PSV file is created (containing no <psVariable> elements). The value of the PSVCOUNT output parameter will be zero in this case.
The PSV file created by this activity will always contain a single PSV set (<psvSet> element). However, PSV files created by other means (for example, as the output from a Transformation Map) may contain more than one PSV set (processing sequence variables set) and the LOAD_PSVSET activity is capable of processing files containing one or more PSV sets.
For more information about PSV files, refer to the following.
Saving, Loading and Transforming Processing Sequence Variables
INPUT Parameters:
PSVFILEPATH : Required
This parameter must specify the path and file name of the PSV file to be created. By convention, we suggest using a file extension of '.PSV', though this is not a requirement. If the specified file already exists, it will be replaced by this activity.
PSVSELECT : Optional
This parameter may optionally specify a generic name of the processing sequence variables to be saved. For example, specify 'ORDER' to save the processing sequence variables whose names begin with the characters 'ORDER'. Note that processing sequence variable names are case-insensitive. It does not matter whether you specify the generic name using upper or lowercase characters, or a mixture of both. If the generic name specified ends with '*' (a common "generic" notation), the trailing asterisk is removed before performing the comparisons. If this parameter is not specified, a default value of '*ALL' is assumed. Values of '*', '*ALL' or blank will result in all processing sequence variables being selected.
PSVSETID : Optional
This parameter may optionally specify a value to be written to the 'id=' attribute of the <psvSet> element in the PSV file. The value of this atribute will be available, if required, to the processing sequence that loads the variable set using the LOAD_EACHPSVSET activity.
PSVCOMMENT : Optional
This parameter may optionally specify a value to be written to the 'comment=' attribute of the <psvSet> element in the PSV file. The value of this atribute will be available, if required, to the processing sequence that loads the variable set using the LOAD_EACHPSVSET activity.
OUTPUT Parameters:
PSVCOUNT:
Upon successful completion, this output parameter will contain a count of the processing sequence variables saved.