Panel
Table of Contents

Anchor
1153511 1153511

Syntax

Wiki Markup
*call* _script\-file_ \[_parameter\-name_=_parameter\-value_\]...

Anchor
1153513 1153513

Description

Anchor
1153514 1153514

The call command loads and executes a command script.

Anchor
1153515 1153515

Scripts are interpreted line by line, with parameter substitution made just before each line is executed. Parameter substitution is indicated with a $(PARAMETER_NAME) sequence in the called script. Parameters are replaced by the value corresponding with the parameter's name (name=value format) in the call command itself. Each parameter of the call command must have a corresponding value.

Anchor
1153516 1153516

call commands can be nested in called scripts up to ten levels deep.

Anchor
1153517 1153517

If a parameter with the same name appears more than once in call, the first instance of the parameter with that name is used. If a parameter is referenced in the script, but was not passed in via the call command, an error is issued when the line with the reference is parsed.

Anchor
1153518 1153518

Parameters

HTML Table
cellspacing 0 style text-align: left; width: 100%; class Table_with_Header
Table Row (tr) Table Cell (td) style background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 144pt; Anchor 1153521 1153521 Parameter Table Cell (td) style background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 360pt; Anchor 1153523 1153523 Description Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153525 1153525 script-file Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153527 1153527 Filename of the script to process. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153529 1153529 parameter-name Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153531 1153531 Name of a parameter to pass to the script. Table Row (tr) Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153533 1153533 parameter-value Table Cell (td) style border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; Anchor 1153535 1153535 Value to be set for the parameter.

Anchor
1153537 1153537

Anchor
1153538 1153538

Examples

Anchor
1153539 1153539

To invoke a script called script.udm.

• Parameter file has a value of *.
• Parameter src has a value of c:\source.
• Parameter dst has the value /etc/dest.

Panel

Anchor
1153545 1153545

To invoke a script under IBM i, the member name is required and can be *FILE:

Panel

Anchor
1153547 1153547

Specifying *FILE invokes the normal default IBM i file search order.

Anchor
1153549 1153549

To invoke a script under IBM i included as an inline file in a database job, the call must specify *FIRST as the database member name.

Anchor
1153550 1153550

The following example illustrates both:

• Invocation of an inline script, CALLME, using the STRUDM command from a database job.
• Invocation of an inline script, CALL1, using the CALL command from a database job.

Panel