TrainzUtil - Revision history

Deneban: /* Command Line Arguments */ Added to "status": Note that the asset need not be locally installed, it only needs to be resident in the Download Station.

2023-09-24T11:32:56Z

Command Line Arguments: Added to "status": Note that the asset need not be locally installed, it only needs to be resident in the Download Station.

← Older revision		Revision as of 11:32, 24 September 2023
Line 182:		Line 182:
	:''Provides a 'next content ID' hint for the KUID generator.''		:''Provides a 'next content ID' hint for the KUID generator.''
	* TrainzUtil status <KUID>		* TrainzUtil status <KUID>
	:''Print the status of the specified asset.''		:''Print the status of the specified asset. Note that the asset need not be locally installed, it only needs to be resident in the Download Station.''
	:''This will output + <KUID> : <Flags> : <category> : <username> where flags are a series of letters with case indicating Boolean state. (capital letters are flagged true and lowercase are flagged false.)''		:''This will output + <KUID> : <Flags> : <category> : <username> where flags are a series of letters with case indicating Boolean state. (capital letters are flagged true and lowercase are flagged false.)''
	:''As Trainz evolves, the TrainzUtil command adds more status flags (all listed in caps for illustration purposes only). The order of the status flag output is shown below, and has varied at the service-pack level:''		:''As Trainz evolves, the TrainzUtil command adds more status flags (all listed in caps for illustration purposes only). The order of the status flag output is shown below, and has varied at the service-pack level:''

Deneban: Added to first paragraph: "Please note this page has not been updated for TRS22."

2023-01-04T04:09:17Z

Added to first paragraph: "Please note this page has not been updated for TRS22."

← Older revision		Revision as of 04:09, 4 January 2023
Line 1:		Line 1:
	[[TrainzUtil]] is a command line [[Content Management]] tool.		[[TrainzUtil]] is a command line [[Content Management]] tool. <i>Please note this page has not been updated for TRS22</i>

	=Functionality=		=Functionality=

Deneban: /* Known Issues */

2022-11-17T12:02:48Z

Known Issues

← Older revision		Revision as of 12:02, 17 November 2022
Line 62:		Line 62:
	= Known Issues =		= Known Issues =

	1. Some TRS19 compilations of TrainzUtil (~~SP3~~ and earlier) will erroneously report "TANE.exe is not running" when TRS19 is not running. This was corrected in April 2021 with the release of TRS19SP3 to report "Trainz" is not running.		1. Some TRS19 compilations of TrainzUtil (SP2 and earlier) will erroneously report "TANE.exe is not running" when TRS19 is not running. This was corrected in April 2021 with the release of TRS19SP3 to report "Trainz" is not running.

	2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.		2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.

Deneban: /* Known Issues */ Added to item 1 what the correction did.

2022-11-17T12:02:20Z

Known Issues: Added to item 1 what the correction did.

← Older revision		Revision as of 12:02, 17 November 2022
Line 62:		Line 62:
	= Known Issues =		= Known Issues =

	1. Some TRS19 compilations of TrainzUtil will erroneously report "TANE.exe is not running". This was ~~fixed~~ in April 2021 with the release of TRS19SP3.		1. Some TRS19 compilations of TrainzUtil (SP3 and earlier) will erroneously report "TANE.exe is not running" when TRS19 is not running. This was corrected in April 2021 with the release of TRS19SP3 to report "Trainz" is not running.

	2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.		2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.

Deneban: /* Known Issues */ Added item 3, "version" argument issue.

2022-11-17T11:55:47Z

Known Issues: Added item 3, "version" argument issue.

← Older revision		Revision as of 11:55, 17 November 2022
Line 65:		Line 65:

	2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.		2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.

			3. The "help" argument incorrectly states that the "version" argument yields the "TrainzUtil build version." In fact, there is no such thing, and in actuality this argument reports the Trainz executable build number.

	=Accessibility=		=Accessibility=

Deneban: /* Known Issues */

2022-11-17T11:49:03Z

Known Issues

← Older revision		Revision as of 11:49, 17 November 2022
Line 64:		Line 64:
	1. Some TRS19 compilations of TrainzUtil will erroneously report "TANE.exe is not running". This was fixed in April 2021 with the release of TRS19SP3.		1. Some TRS19 compilations of TrainzUtil will erroneously report "TANE.exe is not running". This was fixed in April 2021 with the release of TRS19SP3.

	2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running, it is ~~mere~~ that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.		2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running. Rather, the issue is that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.

	=Accessibility=		=Accessibility=

Deneban: /* Set Up */

2022-11-17T11:46:10Z

Set Up

← Older revision		Revision as of 11:46, 17 November 2022
Line 58:		Line 58:
	[[TrainzUtil]] presumes it has access to dynamic link libraries (.dll's) that accompany it. Therefore, it is not only important to maintain TrainzUtil with the main exexcutable it came with, it also has to be kept in the identical location it was provided relative to other Trainz program files. Failure to comply with this will result in error messages.<br><br>		[[TrainzUtil]] presumes it has access to dynamic link libraries (.dll's) that accompany it. Therefore, it is not only important to maintain TrainzUtil with the main exexcutable it came with, it also has to be kept in the identical location it was provided relative to other Trainz program files. Failure to comply with this will result in error messages.<br><br>

	Finally, many TrainzUtil commands require the main Trainz executable program to be running in parallel. Otherwise, TrainzUtil will return a response stating the Trainz ".exe" is not running.~~<br>~~<br>		Finally, many TrainzUtil commands require the main Trainz executable program to be running in parallel. Otherwise, TrainzUtil will return a response stating the Trainz ".exe" is not running.<br>

	= Known Issues =		= Known Issues =

Deneban: /* Set Up */ was plit into new header "Known Issues" by moving the final item from Set Up under this new header. Also added item 2, "Trainz is not running..." known issue.

2022-11-17T11:45:45Z

Set Up: was plit into new header "Known Issues" by moving the final item from Set Up under this new header. Also added item 2, "Trainz is not running..." known issue.

← Older revision		Revision as of 11:45, 17 November 2022
Line 58:		Line 58:
	[[TrainzUtil]] presumes it has access to dynamic link libraries (.dll's) that accompany it. Therefore, it is not only important to maintain TrainzUtil with the main exexcutable it came with, it also has to be kept in the identical location it was provided relative to other Trainz program files. Failure to comply with this will result in error messages.<br><br>		[[TrainzUtil]] presumes it has access to dynamic link libraries (.dll's) that accompany it. Therefore, it is not only important to maintain TrainzUtil with the main exexcutable it came with, it also has to be kept in the identical location it was provided relative to other Trainz program files. Failure to comply with this will result in error messages.<br><br>

	Finally, many TrainzUtil commands require the main Trainz executable program to be running in parallel. Otherwise, TrainzUtil will return a response stating the Trainz ".exe" is not running.<br>		Finally, many TrainzUtil commands require the main Trainz executable program to be running in parallel. Otherwise, TrainzUtil will return a response stating the Trainz ".exe" is not running.<br><br>
	<i>~~Note: some~~ TRS19 compilations of TrainzUtil will erroneously report "TANE.exe is not running". This was fixed in April 2021 with the release of TRS19SP3.~~</i><br><br>~~
			= Known Issues =

			1. Some TRS19 compilations of TrainzUtil will erroneously report "TANE.exe is not running". This was fixed in April 2021 with the release of TRS19SP3.

			2. TrainzUtil, when invoked from a console or third-party software, erroneously reports "- Trainz is not running. Please start Trainz and try again." when in fact Trainz is running, it is mere that "Advanced Debug Tools" is not enabled in the "devs" tab of the "Trainz Settings" window.

	=Accessibility=		=Accessibility=

Deneban: /* Return to Content Creation / Tools */

2022-10-24T00:08:12Z

Return to Content Creation / Tools

← Older revision		Revision as of 00:08, 24 October 2022
Line 277:		Line 277:
	*The console output of a TrainzUtil command is not the same as when it is executed from the Trainz program launch window		*The console output of a TrainzUtil command is not the same as when it is executed from the Trainz program launch window

			<br>
	=Return to Content Creation / Tools=		=Return to Content Creation / Tools=

	[[Tools]]		[[Tools]]

Deneban: /* Return to Content Creation */

2022-10-24T00:06:07Z

Return to Content Creation

← Older revision		Revision as of 00:06, 24 October 2022
Line 277:		Line 277:
	*The console output of a TrainzUtil command is not the same as when it is executed from the Trainz program launch window		*The console output of a TrainzUtil command is not the same as when it is executed from the Trainz program launch window

	=Return to Content Creation=		=Return to Content Creation / Tools=

	[[~~Content Creation~~]]		[[Tools]]