5.7.5 Inserting an option letter before the value

When the specification of a command parameter requires that both the option and the value specified for the option be specified, if option-letter input-value-variable is specified as the value of the parameter in an item, the command ends in an error when there is no user-input value.

This entry can serve the following purpose: Whenever a user-input value is specified, it is prefixed with an option letter, and when no user-input value is specified, a variable to which an input value is assigned is used without option letters.

Example: Executing the cpasetprof command with -d input-value when there is a user-input value

Open the Action dialog box from the Item Design View, specify the information described in the following table in an item, and then register the item.

Table 5‒15: Information specified for the input item "Option letters"

	Specifics of where each piece of information is defined			Information to be specified
	Main window	Where to transition to	Location where the information is specified
1	Item Design View +--Action dialog box	Basic settings	Command	cpasetprof
2			Parameter	${JDS:prof}
3			Execution type	Do not show the window
4		Input item settings +--Define input items dialog box	Variable name	prof
5			Label	Name of the profile to be deleted
6			Input type	Text box
7			Option letters	-dΔ#

#

Δ denotes a half-width space.

The following figure shows what the dialog box looks like when the created item is to be used in a job.

Figure 5‒16: An item that has an option letter

When there is a user-input value, cpasetprof -d input-value is executed, and when there is no user-input value, cpasetprof is executed.

For details on the cpasetprof command, see cpasetprof in 9. Commands.

Important

Depending on the input type of the item, no option letter is inserted in the following cases:

• List box

  The list has no corresponding value.

• Check box

  The option of the check box has no corresponding value.

To Page Top