File version - Revision history

Jane.doe at 09:27, 18 September 2023

2023-09-18T09:27:55Z

← Older revision		Revision as of 09:27, 18 September 2023
Line 1:		Line 1:
	A '''file version number''' is a part of the [[File specification\|file specification]] preceded with a semicolon (;) or a period(.) that tells you which version of the file that is. Each file version is stored as a separate file with different [[File ID\|FID]]s.		A '''file version number''' is a part of the [[File specification\|file specification]] preceded with a semicolon (;) or a period(.) that tells you which version of the file that is. Each file version is stored as a separate file with different [[File ID\|FID]]s.

	Version numbers are decimal numbers from 1 to 32,767. When you create a file with a [[File name\|file name]] that is unique in the directory, the file is assigned version number 1 (unless a different version number is explicitly specified). If a file with a non-unique name is created, it is assigned the next file version. If you attempt to create a new file with a version number higher than 32767, you will receive an error message.		Version numbers are decimal numbers from 1 to 32,767. When you create a file with a [[File name\|file name]] that is unique in the directory, the file is assigned version number 1 (unless a different version number is explicitly specified). If a file with a non-unique name is created, it is assigned the next file version. If you attempt to create a new file with a version number higher than 32767, you will receive an error message - this also means that you cannot edit the files with version 32767 even as a privileged user.

	=Version number defaults=		=Version number defaults=

Jane.doe at 20:08, 10 October 2022

2022-10-10T20:08:21Z

← Older revision		Revision as of 20:08, 10 October 2022
Line 44:		Line 44:

	=See also=		=See also=
	* [https://docs.vmssoftware.com/guide-to-openvms-file-applications \| OpenVMS Guide to File Applications]		* [https://docs.vmssoftware.com/guide-to-openvms-file-applications OpenVMS Guide to File Applications]
	* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual \| OpenVMS User's Manual]		* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual OpenVMS User's Manual]

Jane.doe at 20:07, 10 October 2022

2022-10-10T20:07:59Z

← Older revision		Revision as of 20:07, 10 October 2022
Line 44:		Line 44:

	=See also=		=See also=
	* [https://docs.vmssoftware.com/guide-to-openvms-file-applications\| OpenVMS Guide to File Applications]		* [https://docs.vmssoftware.com/guide-to-openvms-file-applications \| OpenVMS Guide to File Applications]
	* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual\|OpenVMS User's Manual]		* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual \| OpenVMS User's Manual]

Jane.doe at 20:07, 10 October 2022

2022-10-10T20:07:35Z

← Older revision		Revision as of 20:07, 10 October 2022
Line 44:		Line 44:

	=See also=		=See also=
	* [https://docs.vmssoftware.com/guide-to-openvms-file-applications/\| OpenVMS Guide to File Applications]		* [https://docs.vmssoftware.com/guide-to-openvms-file-applications\| OpenVMS Guide to File Applications]
	* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual/\|OpenVMS User's Manual]		* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual\|OpenVMS User's Manual]

Jane.doe at 20:07, 10 October 2022

2022-10-10T20:07:03Z

← Older revision		Revision as of 20:07, 10 October 2022
Line 44:		Line 44:

	=See also=		=See also=
	* [~~http~~://~~h30266~~.~~www3.hpe~~.com/~~odl/i64os/opsys/vmsos84/documentation~~/~~pdf/OVMS_731_file_app.PDF~~\| OpenVMS Guide to File Applications]		* [https://docs.vmssoftware.com/guide-to-openvms-file-applications/\| OpenVMS Guide to File Applications]
	* [https://~~support~~.~~hpe~~.com/~~hpsc~~/~~doc/public/display?docId=emr_na-c04623190~~\|OpenVMS User's Manual]		* [https://docs.vmssoftware.com/vsi-openvms-user-s-manual/\|OpenVMS User's Manual]

Darya.zelenina: Created page with "A '''file version number''' is a part of the file specification preceded with a semicolon (;) or a period(.) that tells you which version of the file th..."

2018-12-19T08:31:12Z

Created page with "A '''file version number''' is a part of the file specification preceded with a semicolon (;) or a period(.) that tells you which version of the file th..."

New page

A '''file version number''' is a part of the [[File specification|file specification]] preceded with a semicolon (;) or a period(.) that tells you which version of the file that is. Each file version is stored as a separate file with different [[File ID|FID]]s.

Version numbers are decimal numbers from 1 to 32,767. When you create a file with a [[File name|file name]] that is unique in the directory, the file is assigned version number 1 (unless a different version number is explicitly specified). If a file with a non-unique name is created, it is assigned the next file version. If you attempt to create a new file with a version number higher than 32767, you will receive an error message.

=Version number defaults=
Various commands default to different version numbers.
{| class="wikitable"
|-
! Command !! Default version numbers
|-
| TYPE || Highest version number
|-
| DIRECTORY|| All version numbers
|-
| PURGE || All version numbers but the highest (you cannot specify a version number; if you need to keep more than one version, use the /KEEP qualifier)
|-
| DELETE || No default (version must be specified explicitly)
|}

=Relative version numbers=
Relative version numbers can be used to point to various versions of a file if the actual file versions are unknown.

{| class="wikitable"
|-
! Relative version number !! Meaning
|-
| None (;) || Highest version
|-
| 0 || Highest version
|-
| -1 || Second highest version
|-
| -2 || Third highest version
|-
| -0 || Lowest version
|}

=Version limit=
A version limit can be imposed on a file or all files created in a given directory. If a file version is created beyond the limit, the lowest existing version of that file will be purged.

To set a version limit on a file, use the SET FILE/VERSION_LIMIT=n command. By default, the version limit is 0, which means unlimited versions (the number is still limited by the [[Files-11]] architectural limit of 32,767.
To set a version limit on all files created in a certain directory, use the /VERSION_LIMIT qualifier with the SET DIRECTORY or CREATE/DIRECTORY command.
To view the version limit on a file, use the DIRECTORY/FULL command or [[F$FILE_ATTRIBUTES()|F$FILE_ATTRIBUTES(filename,"VERLIMIT")]] [[Lexical functions|lexical function]].

=See also=
* [http://h30266.www3.hpe.com/odl/i64os/opsys/vmsos84/documentation/pdf/OVMS_731_file_app.PDF| OpenVMS Guide to File Applications]
* [https://support.hpe.com/hpsc/doc/public/display?docId=emr_na-c04623190|OpenVMS User's Manual]