Deprecation of Commands Requires Replacement Command

[awharn]

Describe the bug

If a command is deprecated, the functionality in Imperative only handles if a command was deprecated with a suggested replacement. With the deprecation of IMS, there is no replacement for any of these commands. The function should be able to take in an empty string for the recommended replacement, and if the string is empty, it should not display the recommended replacement message.

zowe-cli/packages/imperative/src/utilities/src/CliUtils.ts

Lines 379 to 395 in 5667624

	public static showMsgWhenDeprecated(handlerParms: IHandlerParameters) {
	if (handlerParms.definition.deprecatedReplacement) {
	// form the command that is deprecated
	let oldCmd: string;
	if (handlerParms.positionals.length >= 1) {
	oldCmd = handlerParms.positionals[0];
	}
	if (handlerParms.positionals.length >= 2) {
	oldCmd = oldCmd + " " + handlerParms.positionals[1];
	}
	// display the message
	handlerParms.response.console.error("\nWarning: The command '" + oldCmd + "' is deprecated.");
	handlerParms.response.console.error("Recommended replacement: " +
	handlerParms.definition.deprecatedReplacement);
	}
	}

Additional context

This could also be considered an enhancement, but with V2 entering maintenance soon, I believe this should qualify as a bug fix. This will allow extenders to add this message to any deprecated plug-ins / commands that may go away in the future, and potentially begin to warn consumers in V2. There is currently no way to warn consumers of a deprecated command without a replacement, aside from displaying the line Recommended replacement: none.

[github-actions]

Thank you for creating a bug report.
We will investigate the bug and evaluate its impact on the product.
If you haven't already, please ensure you have provided steps to reproduce the bug and as much context as possible.

[gejohnston]

Would it be beneficial to the consumer if apps supply replacement text that is similar to the following text?
"Obsolete component. No replacement exists."