SYS_MGR.GET_NAMEPARM

How to:

Used in conjunction with the MNTCON EX|RUN –v syntax, the SYS_MGR.GET_NAMEPARM function returns the value of a keyword parameter passed at the time the Maintain procedure was invoked. If the function is not successful, FOCERROR is set to -1. See also 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_NAMEPARM Command

The syntax for the SYS_MGR.GET_NAMEPARM command is

MyParm/format = SYS_MGR.GET_NAMEPARM('ParmName')

where:

MyParm/format

Is the name of the variable or format that you are assigning to the output of the function.

ParmName

Is the actual keyword parameter name used when passing the value.

Note: The SYS_MGR.GETNAME_PARM function is case-sensitive. Use the same case for the parameter name when retrieving the value as used when passing it.



Example: Retrieving the Value for a Keyword Parameter Passed to a Maintain Procedure
MNTCON EX START2 -v ADDR='Cape Canaveral', COUNTRY=USA

Target Maintain procedure START2 could include:

Address/a0=sys_mgr.Get_NameParm('ADDR');

Here it returns Cape Canaveral to the variable Address.


WebFOCUS