beautypg.com

Parms – Visara Master Console Center Scripting Guide User Manual

Page 161

background image

Chapter 5 Script Commands

Scripting Guide

161

PARMS

Syntax:

PARMS var1[, var2 [, var3, ..., [varn]...]]]

Description:

Receives parameters into the script.

Action:

Values passed from the calling entity are received sequentially, one-to-

one, into the variables in the PARMS command.

Parameters:

Var. Numeric or string variable. The passing of arrays is allowed.

Returns:

N/A.

Notes:

1. If used, the PARMS command must be the first executed command

in the script.

2. Up to 255 parameters can be passed or received.
3. Automatic variable type conversion will happen when necessary—

strings are converted to numerics (with the same result as VAL()),

and numerics are converted to strings (with the same result as
STR()). Refer to the examples below.

Example:

//Script Name: SCRIPT1

$SysName := "SYS5"
%LparQty := 4

//call the script SCRIPT2 and pass parameters
SCRIPT2( $SysName, $LparQty)

//call the script SCRIPT3 and pass parameters
SCRIPT3( $SysName, $LparQty)



//Script Name: SCRIPT2

//Here, the parms are the same type as in
//the calling script

PARMS $Name, $Qty

// more processing commands


//Script Name: SCRIPT3

//here the "$Qty" parm is automatically converted
//to a string via its syntax in the PARMS
//statement

PARMS $Name, $Qty

// more processing commands

See Also:

N/A

Each
statement

calls its

respective

script