&ALLPARMS

A user variable that supplies a single string for all parameters specified when an NCL procedure is invoked.

&ALLPARMS is a user variable that is a single string containing all parameters entered when the procedure was invoked.

&ALLPARMS is created automatically when the process is invoked if any data was supplied on the initiating command.

Examples: &ALLPARMS

If a procedure is invoked with the following command:

EXEC ROUTPROC text of command to be sent to remote location

then &ALLPARMS is set to ”text of command to be sent to remote location”.

The variable can then be used in commands such as:

ROUTE NM2 &ALLPARMS

Notes:

&ALLPARMS is set only when a procedure is invoked with parameters. If the procedure is invoked without parameters, &ALLPARMS is set to null. Subsequent functions such as &PAUSE which allow the operator to enter more optional variables do not cause &ALLPARMS to be reset.

The data contained within &ALLPARMS is referenced on an individual variable basis using &1, &2, and so on. These variables, however, remain available only until reset by another function or assignment that specifically references that variable. The maximum length of data that is set in &ALLPARMS is 256 characters.

Because &ALLPARMS is a user variable, it is deleted by the procedure if necessary.