Page tree
Skip to end of metadata
Go to start of metadata

Description

Creates a version of the database specified.

Syntax

status = CIAOMakeVersion( <SourcePath>, <VersionLabel>, <Comment>, <VersionFlags>, <Flags> )

Parameters

ParameterInput/OutputTypeDescription
SourcePathInputStringThe path to the Notes database that you want to process. Separate server and pathname with !! This database must be under CIAO! control and have the correct log specified in the CIAO! configuration.
VersionLabelInputStringThe version label used in the Make Version process. This string cannot be blank.
CommentInputStringThe version comment. This string can only be blank if Force Comments is not set in the CIAO! configuration.
VersionFlagsInputLongFlags to control the change in the version number of the new release.
FlagsInputLongFlags to control what is written to the report.

Version Flags

FlagDescription
CIAO_MVERSION_NO_BUMPDo not change the version number.
CIAO_MVERSION_BUMP_MAJORIncrease the major version number, for example from 3.x.x to 4.0.0.
CIAO_MVERSION_BUMP_MINORIncrease the minor version number, for example from 4.1.x to 4.2.0.
CIAO_MVERSION_BUMP_POINTIncrease the point version number, for example from 5.2.3 to 5.2.4.

Flags

FlagDescription
CIAO_COMMENT_PROMPTPrompt for a comment.
CIAO_MVERSION_SILENTDo not display the status bar.
CIAO_MVERSION_PROMPTDisplay the Make Version dialog box.
CIAO_MVERSION_DATAInclude documents in the version database.
CIAO_MVERSION_ACLInclude the ACL in the version database.
CIAO_MVERSION_REPIDInclude the Replica ID in the version database.
CIAO_MVERSION_ODS_NOTES5Force the version database to have an R5.x ODS.
CIAO_MVERSION_ODS_NOTES4Force the version database to have an R4.x ODS.
CIAO_MVERSION_SAVE_ZIPPEDSave the version database as a zip file.
CIAO_MVERSION_DEFAULTDoes not display the status bar. Saves the version database as a zip file.
CIAO_MVERSION_UI_SHOW_STATUSUpdates the Notes status bar with the progress of the version operation.
CIAO_MVERSION_UI_SHOW_PROGRESSDisplays the progress bar.
CIAO_MVERSION_NO_UIDoes not display the UI. All options must be passed into the CIAOMakeVersionImp call.
CIAO_MVERSION_FULL_UIEnable all options in the Make Version window. Without this, the version number fields are disabled.

Return Value

Return ValueTypeDescription
statusLongZero (0) indicates that no error occurred. If the return value is non-zero, use CIAOStringLoad to get the error message associated with the error code.

Example

Dim status As Long
Dim strPath As String
strPath = ""
If strDatabaseServer <> "" Then
	strPath = strDatabaseServer + "!!"
End If
strPath = strPath + strDatabasePath
status = CIAOMakeVersionImp( strPath, "BASELINE", "Initial baseline version", CIAO_MVERSION_DEFAULT )
If status <> 0 Then
	Dim szBuffer As String*255
	CIAOStringLoad status, szBuffer, 255
	MessageBox Left$( szBuffer, Instr( szBuffer, Chr(0) ) - 1 )
End If

 

 

  • No labels