SYS_MGR.GET_POSITIONPARM

How to:

Used in conjunction with the MNTCON EX|RUN –v syntax, the SYS_MGR.GET_POSITIONPARM function retrieves the value of positional parameters passed when invoking a Maintain procedure. If the function is not successful, FOCERROR is set to -1. See also the SYS_MGR.GET_INPUTPARAMS_COUNT function to retrieve the number of a positional parameter, and the MNTCON EX and MNTCON RUN commands using the –v option to pass parameters.


Top of page

x
Syntax: How to Use the SYS_MGR.GET_POSITIONPARM Command

The syntax for the SYS_MGR.GET_POSITIONPARM command is

Var/An = SYS_MGR.GET_POSITIONPARM(i);

where:

Var/An

Is the name of the variable, declared with an alphanumeric format (for example, A0) that you are assigning to the output of the function.

i

Is the position number of the variable whose value you wish to retrieve.



Example: Retrieving the Value of a Positional Parameter Passed to a Maintain Procedure
MNTCON EX START3 -v abc, '24 Houston Center'

Target Maintain procedure START3 could include:

Parm1/a0=sys_mgr.Get_PositionParm(2); 

Here it returns 24 Houston Center, the value of the second keyword parameter, for computed field Parm1.


WebFOCUS