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/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.


Information Builders