Network Shell Script Job - Parameters
The Parameters panel lets you review and modify values for parameters that are used when the script runs. Any values you enter on the Parameters panel override the default values that were defined for parameters when the script was added to the Depot. This panel also lets you choose whether parameter flags and values should be used when the job runs.
When entering a string value for a parameter, you can parameterize the string by inserting a variable that represents a property value. When the job runs, the property references are resolved using values defined for target servers. You can only insert property references in this way when the script is defined to use either the "runscript" or the "copy and execute" command (that is, you chose the first or third script types when defining the Network Shell script). Property references cannot be used when Network Shell scripts execute centrally against target servers because the property references cannot be resolved for each target server.
For each parameter listed on this panel, do the following:
- To specify whether the job should use a flag for this parameter, click in the Flag runtime usage column. A drop-down list appears. Select one of the following:
- Use — The job uses the parameter flag.
- Ignore — The job does not use the parameter flag.
If the Network Shell script is defined so the job requires a flag for this parameter, this cell is set to Required and you cannot modify the setting.
- To modify the value of the parameter, double-click in the Value column for that parameter and enter a new value. The maximum length of any parameter value in an NSH script is 255 characters.
You can only modify parameters that are defined to be editable when the Network Shell script was created.
If you want to include a reference to a property in the parameter, enter a variable for that property in the Value column, bracketed with double question marks (such as
??WINDIR??/rsc). Alternatively, you can click Select Property to find and enter the appropriate property.
- To specify whether the job should use a value for this parameter, click in the Value runtime usage column. A drop-down list appears. Select one of the following:
- Use — The job uses this parameter value.
- Ignore — The job does not use this parameter value.
If the Network Shell script is defined so the job requires a value for this parameter, this cell is set to Required and you cannot modify the setting.
If the parameter is defined so it does not accept a value, and the parameter has never had a value associated with it, this cell is set to N/A and you cannot modify the setting.