OUT parameters The value of OUT parameter can be changed in the stored procedure and its new value is returned to the calling program. Calling Oracle Stored Procedure with User-Defined Types ... Call a stored procedure with parameters - Visual Studio ... SQL SERVER - How to Pass Parameters to the Stored Procedure? Stored Procedure With Multiple Parameters. The last piece of the trick here is setting up your target dataset within ADF to use this Stored Procedure. Make sure that no whitespace is between the name of the stored procedure and the first parentheses. Using PL/SQL Stored Procedures and REF CURSORs Stored Procedure Parameters: Input, Output, Optional If your stored procedure calls other stored procedures, and is itself likely to be called by other stored procedures . Use Execute query activity under Database. Then, due to lack of sleep I promptly forgot the whole gamut of options displayed here and initially went for the if/begin/end result then 'discovered' this approach - forgetting that this is one of the options you had tried. Null values in procedure input parameters — oracle-tech The only way I can see to udpate the parameter is to select the Edit Queries button under the home tab, highlight the parameter, select which paramter value to use from a list I created on the manage parameters page, then select the Apply and Close button. Input/Output Parameters So you can look through your list of stored procedures and when you find one that looks . When we call the stored procedure, we pass the data values to the stored procedure through input parameters. Run the project as a Mule app. To call a stored procedure using a JDBC program you need to: Register the driver: class using the registerDriver () method of the DriverManager class. Just list each parameter and the data type separated by a comma as shown below. In this stored procedure, we are getting student count from "tblStudentDetails" filtered with student city. cursor.execute('{CALL [SP_NAME](?,? . GOAL. ; For each parameter marker in the CALL statement, call the PDOStatement::bindParam method to bind each parameter marker to the name of the PHP variable that will hold the output value of the parameter after the CALL statement has been issued. You can Store the return output in a DT variable if . The output parameter value may be based on an aggregate function or any computational expression within the stored procedure. The following stored procedure returns the full name of a user after concatenating first and last names. In the Parameters table add a row and select user_id in Schema_Column column. 10. Right-click the user-defined stored procedure that you want and click Execute Stored Procedure. )}', ('value', 'value')) It works, but I need to pass parameter name of stored procedure because order of stored procedure input parameter always changes. Right click on "Parameters" and select "Add . First, specify the parameter mode, which can be IN , OUT or INOUT depending on the purpose of the parameter in the stored procedure. Active 1 year ago. A Stored Procedure is a routine or set of SQL Statements invoked with a CALL statement. figure-1.4. create procedure sp_get_empname(@name varchar(10) out, @id int) as begin select ename from emp where empno=@id end declare @en varchar(10) exec sp_get . For an Oracle query, it is the name of any input parameter in the query excluding the leading colon. Enter the value in VALUE input section Here, "City" is an input parameter and we passed it to our stored procedure to filter and get the student count. The easy way is to right-click on the procedure in Sql Server Management Studio (SSMS), select execute stored procedure… and add values for the input parameters as prompted. This is a useful link if you need to use a stored procedure with output parameters: If the return value is a complex type, such as a VARIANT that contains sub-fields, document those sub-fields. In the following example we will create a very simple procedure. An input parameter can determine which subset of rows a stored procedure will return from a select statement within it. input parameters of stored procedures against any best practices? Creating a stored procedure with parameters. The Java code for calling this stored procedure is as follows: Java My Input Paremeter is working perfectly fine after following the steps which you have outlined above. Then we need to create our Stored Procedure and we'll create a parameter in that Stored Procedure using this data type. Now let's see how to call the same in the Execute Sql Task. As an example, if a user defined function uses "Productname LIKE @ProductName" in WHERE clause of a select statement, and a stored procedure uses the user defined function while passing @ProductName input parameter to the user defined function, is there any security risks? In the sp_executesql transact-sql syntax : @stmt is the nvarchar() variable input string which identifies the t-sql statement. Connected to: Oracle Database 12c Enterprise Edition Release 12.1.0.2.0 - 64bit Production With the Partitioning, OLAP, Advanced Analytics and Real Application Testing options SQL> create or replace procedure isjson (inputjson in clob) 2 as. To work around this, you can define a function within your stored procedure to parse the string as an array. Data Type Indicates the data type of the parameter. Running a PL/SQL Stored Procedure Using an ODP.NET Application. You pass the INPUT parameters while executing a stored procedure, as shown below. The other 2 parameter are IN and OUT parameter respectively (int and varchar (30)) Following is the definitions . SSMS will then generate the code to run the proc in a new query window, and execute it for you. In the Form1 window, enter the connection information, and click Connect. value - Input parameter value. It is stored as an object inside the database server. 1. is it possible to have an unconnected stored procedure without any input parameters. The current implementation supports the calling of the stored procedures which only have input parameters (in our case it's more than enough). A Form1 window appears. Choose command type as Store procedure. Learning to create and manage stored procedures in SQL is another useful SQL databases skill for the DBA and developer. One of the input parameter is varbinary (max). The name, data type, and meaning of the return value. The following SQL statement creates a stored procedure that selects Customers from a particular City with a particular PostalCode from the "Customers" table: The parameter name must follow the naming rules of the column name in MySQL. Further extension should support the calling of the stored procedures which have output parameters as well. Here, "City" is an input parameter and we passed it to our stored procedure to filter and get the student count. Click on Stored Procedure; Click on the select dropdown of Stored procedure name and select the procedure which we created in first step; Next click on Import Parameter. Now obviously input parameter means you have to pass something to the stored procedure, whereas the output parameter will return something back to you. However, if you want to assign your passed parameters to specific variable inside SQL Server, you will have to mention that parameter as mentioned in the second method. IN type parameter sends values to a Stored Procedure. Answer (1 of 2): No, it doesn't. That's the simplest form of Procedure. ; OUT type parameter gets values from the Stored Procedure. Stored Procedures that use parameter values are called "dynamic". By default, all the parameters are INPUT parameters in any stored procedure unless suffix with OUTPUT keyword. Method 2: In this method when we execute the stored procedure, we also include the variable to which we want to assign parameter. Fill the SP name against SQL. Pass the driver class name to it, as parameter. It will import the parameter of that SQL procedure; In the above image we can see that parameter got imported. ; Like most programming language, PL/SQL procedure has defined IN type as default parameter.The OUT parameter is a write-only for procedure as it does not pass the value OUT while executing the procedure but passes . Creating a SQL Stored Procedure with Parameters To create a stored procedure with parameters using the following syntax: CREATE PROCEDURE dbo.uspGetAddress @City nvarchar (30) AS See details and examples below SQL Server Query to Turn into a Stored Procedure Below is the query we want to use to create the stored procedure. Instead, they want me to handle it as: If you omit type, module automatically decide which SQL data type should be used based on JS data type. Ask Question Asked 1 year ago. We can also design the procedure to handle passing parameters into it. In the above stored procedure uspUpdateEmpSalary, the @empId and @Salary are INPUT parameters. The stored procedure takes these input parameters and uses them for completing the operation. Here I created a Stored Procedure " test" with a Input Parameter @PrdKey. The following stored procedure returns the full name of a user after concatenating first and last names. A value for an output parameter can be returned to a calling script. A value for an output parameter can be returned to a calling script. name - Name of the input parameter without @ char. Output Parameter Let us create a SQL Server stored procedure that accepts the input parameters and processes the records based on the input parameter. A stored procedure is a group of one or more pre-compiled SQL statements into a logical unit. Arguments. Passing database name to input parameter from a stored procedure. The name, data type, and meaning of each input parameter. Dec 4, 2008 2:49PM edited Dec 4, 2008 5:02PM in SQL & PL/SQL. When defining a stored procedure in Azure portal, input parameters are always sent as a string to the stored procedure. We also looked at how to call a Stored Procedure from Python. I need to call a SqlServer stored procedure from python2.7 via pyodbc module with input parameter name.. I tried based on documentation by input parameter order:. Creating a stored procedure with multiple parameters Stored procedures can take one or more parameters. In Parameterized Query, call the stored procedure: CALL add_bonus_by_emp_no (:empid,500); In Parameters, click Add Parameter , and enter the following options: Parameter Name: empid. How To Create PL/SQL Stored Procedure without Parameters In Oracle Database. create procedure SimpleInOutProcedure @p_InputInt int, @p_OutputInt int input output As Begin Select * from TestTableCommonA; End The word "input" is not expected, thus not blue-colored in the SQL Server Management Studio: What's wrong with my script, how to declare input-output parameters in SQL Server Stored Procedure/Function? Now when a stored procedure returns something back to you, you have to hold it somewhere obviously in a variable. Here is my stored procedure which I have created in SQL which is working perfectly fine there:- create procedure totalstudents1 @RollNumber int, @NoofStudents int output . As we see in the code above, the "else" section is completely extra in the code, so to get rid of this extra code we use optional parameters in a Stored Procedure. It is a subroutine or a subprogram in the common computing language that has been created and stored in the database. Set the default value in the input parameters of the Stored Procedure that are not mandatory like I have used ='N/A' as the default value. The following statement modifies the uspFindProducts stored procedure by adding one more parameter named @max_list_price to it: Next, it needs to consume results presented as a UDT returned by the SP in OUT and INOUT parameters. It may have input parameters, output parameters and parameters that are both input parameters and output parameters. Required Parameters¶ name ([arg_name arg_data_type] [,.. Specifies the identifier (name) and any input arguments for the stored procedure.For the identifier: The identifier does not need to be unique for the schema in which the procedure is created because stored procedures are identified and resolved by the combination of the name and argument types. The screenshot below is an illustration of SQL Server Management Studio. In properties. When you pass date values as string literals to datetime variables/parameters, the server interprets it based on its regional/language settings So best option would be to use unambiguos format like yyyyMMdd while passing values The below stored procedure takes two parameters - IN and OUT. The above SP has a Input Parameter and hence to provide input value to the parameter select PARAMETERS tab and provide the Parameter value as shown below. [spinsertemployeedetails] @firstname varchar (100), @lastname nvarchar (100), @education nvarchar (200), @occupation nvarchar (200), @yearlyincome float, @sales float as begin begin try begin transaction; insert into … I know that there are a lot of topics about passing a Database name as input but still I couldn't figure out what is the issue my code. After performing the calculation, the stored procedure returns two output parameters, the amount of tax, and the total cost of the item including the tax. Origin of Optional Parameter. Select IN in the Type column as input parameter. The rest is pretty simple, we are adding this table instance "employeesTable" as input parameter to the procedure call. Note that the stored procedure cannot access the initial value of the OUT parameter. Look at this. And the other way is to use a system store procedure. In parameter takes input and OUT parameter gives output. This is one way to look at the definition of a stored procedure. The below stored procedure takes two parameters - IN and OUT. Output parameters allow the stored procedure to pass a data value or a cursor variable back to the caller. Input and output parameters of my stored procedure looks like this: ALTER procedure [dbo]. In this stored procedure, we are getting student count from "tblStudentDetails" filtered with student city. you can do this in a data flow task too, you need a source to . in_and_out: takes an input parameter (inParam) and returns a value (outParam) We can then call the stored procedures using Spring Data JPA repository implementation as below: Java. Following is the example of a stored procedure that accepts the parameter. Go Up to Using Stored Procedure-type Datasets. This generates the contents of that store procedure. @empId is of int type and @salary is of money data type. Add a second row and select Name in Schema_Column column, select Out in Type column as output parameter. Enter the stored procedure name in the SP Name field. Below is the t-sql syntax of sp_executesql system stored procedure. Using a stored procedure with no parameters - JDBC Driver for SQL Server It wasn't deliberate, I read through the question and through the answers. In this example the name is p2. This is a write-only parameter i.e, we cannot pass values to OUT paramters while executing the stored procedure, but we can assign values to OUT parameter inside the stored procedure and the calling program can recieve this output value. Header containing the name of the procedure along with the parameters to be passed. The body contains the declarative part, the execution part (having the SQL . Click to see full answer. ; Input/output parameters, used to pass values to a stored procedure for processing, and used by the . SSIS: Stored procedure Input parameters Output parameters, return value, and stored procedure November 17, 2016 July 25, 2017 Discovery2012 SSIS Scenario : I have a SSIS package which executes a store proc. 2) Once the properties wizard opens then set the connection to the database and . The procedures in PL/ SQL are stored in the database and are invoked through triggers, some other procedures, applications of Java, PHP, etc. Stored Procedure has a header and body. Now, before understanding how to execute a stored procedure with input parameters, one should know how to create input parameters. I have a debate with the application developers (c#) They claim that it is malpractive of passing NULL values into procedure. 1) Drag and drop an Execute Sql Task to control flow and double click or right click and select Edit to set the properties. I have a stored procedure with one input paramater and 10 output parameters and I want call this procedure using LINQ to SQL and as a input parameter get a value from textbox. [myDB_SearchNumber] @part_number varchar (10), @Value1 varchar (50) OUTPUT . Where :paramN matches the Nth parameter in the stored procedure declaration. For a stored procedure, it is the name of any parameter in the procedure that can accept input, such as a column in a lookup table. Hopefuly, you guys can help me out ! That's why you first create a variable to receive the value. An input parameter can determine which subset of rows a stored procedure will return from a select statement within it. However I am unable to run the stored procedure with output paremeters. One way is to simply right-click on that stored procedure Script stored procedure as ->create to ->new creator window. The output parameter value may be based on an aggregate function or any computational expression within the stored procedure. There are four types of parameters that can be associated with stored procedures: Input parameters, used to pass values to a stored procedure for processing. @VVS - oh dear you're right! For example, :param1 would be specified as param1 in the PARAMS clause. ; IN OUT type parameter sends and gets values from the procedure. The input parameter in a stored procedure allows the user or caller to pass a data value to the stored procedure. In Operation, select Stored Procedure. type - SQL data type of input parameter. So, is possible to call a method without providing parameters when actually it requires them? In this case, I've created a user defined . You pass it as CLOB and use validation SQL validation on it to confirm its JSON. Third, specify the data type and maximum length of the parameter. Answer: A stored procedure is more like a function or a method. "@Count" is an output parameter to store a number of student count values. In Parameter pass input values with direction IN. Null values in procedure input parameters. Here we learned why and how to create a Stored Procedure in Postgres to give us more efficiency, power, modularity, security, and ease. Usually, we use stored procedures to perform an operation on some data. And then, we can use that data value within the stored procedure for some operation. Value: # [payload] Accept other defaults and save. INOUT parameters This section demonstrates how to run a PL/SQL stored procedure, such as the GETCURSORS stored procedure, from your ODP application. SQL Server sp_ExecuteSQL syntax. Establish a connection: Connect ot the database using the getConnection () method of the DriverManager class. To call a stored procedure: Call the PDO::prepare method to prepare a CALL statement with parameter markers that represent the OUT and INOUT parameters. Even if you pass an array of strings as an input, the array is converted to string and sent to the stored procedure. The Stored Procedure transformation sends and receives input and output parameters using ports, variables, or by entering a value in an expression, such as 10 or SALES. 2) OUT Parameter: The OUT parameters are used to send the OUTPUT from a procedure or a function. In parameter takes input and OUT parameter gives output. Create a Stored Procedure with both input and Output Parameter : You can use the following stored procedure given below to create the stored procedure with both an input and output parameter. In the Execute Procedure dialog box, specify a value for each parameter and whether it should pass a null value. @params is the nvarchar() parameter declaration string which is consists of a list of parameters and parameter data type declarations. Add an input parameter to the request. should i just declare an dummy input variable in my stored procedure (database) just for taking input from the mapping even though i will not use the input variable ? but has output parameter whats the alternative to this ?. Second, specify the name of the parameter. "@Count" is an output parameter to store a number of student count values. In other words, the stored procedure works only on the copy of the IN parameter. In order to pass table valued parameter to a proc we need to make create instance of mssql.Table class and then add columns to the table, followed by adding the rows to mssql.Table object as shown above. A Mule 3.x flow, after processing an input JSON payload, needs to call an Oracle stored procedure (SP) and send a User-Defined Type (UDT) as INOUT parameter. Parameter Indicates the name of the parameter. Each procedure in SQL Server always contains a name, parameter lists, and . The parameters are separated by commas. But when I execute the stored procedure, none of the output parameters gets their output values set, even after SQLParamData returns SQL_SUCESS. This way is the certain way to assign value to . - [Instructor] I'm looking for a stored procedure in this example that has an input and output parameter. ; Output parameters, used by a stored procedure to pass return values to an application. I will try to keep the example as easy as possible so that all the PL/SQL learning enthusiasts out there can understand the process of creating a stored procedure easily. -- example for sql stored procedure with input parameters use [sql tutorial] go create procedure [dbo]. The stored procedure takes 3 parameters. A stored procedure with parameters is similar to a function or method in a traditional programming language like C++ or Java Let's first look at the basic syntax for creating a stored procedure with parameters: CREATE PROCEDURE procedureName (<input/output parameters>) AS <stored procedure body> The most obvious part we need to break down is the " user586638 Member Posts: 80. When you click on OK by providing the query, you can see new data set added with TWO columns which we can use to define the second parameter. The Procedures allow you to create repeatable code that can be executed using just a database single call. This stored procedure accepts a single input parameter named EmployeeID, which is an integer value, and it returns a recursive list of employees and their managers based on the specified EmployeeID. To run a stored procedure: Run the application. Even though all JDBC drivers must comply with the JDBC specification format, some drivers have their own specifications. Parameters are used to exchange data between stored procedures and functions and the application or tool that called the stored procedure or function: Input parameters allow the caller to pass a data value to the stored procedure or function. Viewed 374 times 0 I have some issue with this application. The . Conclusion. Store proc is a merge statement. This updates my stored procedure and creates the correct table. undefined ans NaN values are automatically converted to null values . If it is not available install the UiPath.Database.Acitivities package.Use configure connection and connect to DB. 1 . Setting up multiple parameters is very easy. Example of a stored procedure, such as a VARIANT that contains sub-fields, those... Use a system store procedure for completing the operation us create a SQL client. Max ) [ SQL tutorial ] go create procedure [ dbo ] a method have some with! The first parentheses params clause for Node.js < /a > GOAL can not access the initial value of the.! Of sp_executesql system stored procedure with output keyword Connect ot the database Server within ADF to use this procedure! Support the calling of the stored procedure through input parameters, one should know how execute! Support the calling program any computational expression within the stored procedure for some operation student values. Procedures, and execute it for you as a VARIANT that contains sub-fields, document those.. We pass the data type which identifies the t-sql statement execute procedure dialog box, specify a value an! Parameter got imported is between the name of the parameter name must the. Viewed 374 times 0 I have a debate with the parameters are parameters. Consume results presented as a UDT returned by the SP name field a stored procedure to handle passing parameters it! Class name to it, as parameter some issue with this application and varchar ( 50 ) output //forum.uipath.com/t/how-to-execute-stored-procedure-in-uipath/51949... Is a subroutine or a subprogram in the type column as input parameter in the parameters are input parameters one... Is itself likely to be passed, document those sub-fields into it ) ) following is the way... A database single call object inside the database using the getConnection ( ) variable input string which is consists a... Containing the name of the stored procedure takes stored procedure with input parameters input parameters use SQL. Extension should support the calling program must follow the naming rules of the stored procedure to pass return values the... The nvarchar ( ) parameter declaration string which is consists of a after. Below is an illustration of SQL Server Management Studio name, data type declarations a VARIANT that contains sub-fields document. Is itself likely to be called by other stored procedures which have output parameters allow the stored procedure more. And save within the stored procedure row and select user_id in Schema_Column column, OUT! An output parameter to store a number of student Count values parameter whats the alternative to this? it... Below is an illustration of SQL Server stored procedure with output keyword parameter gives output, I #... Is to use a system store procedure SP name field empId is int... The SQL 2:49PM edited dec 4, 2008 2:49PM edited dec 4, 2008 5:02PM in SQL & ;. Calling script and when you find one that looks procedure name in MySQL the database.... Through input parameters and processes the records based on an aggregate function or a subprogram in the procedure... Enter the connection information, and used by the quot ; @ Count & quot ; @ Count & ;... > how to create repeatable code that can be returned to the stored procedure to the! Procedure takes these input parameters in any stored procedure, as shown below strings! This way is to use a system store procedure for an output parameter < href=! Output keyword input parameter is varbinary ( max ) the definitions procedure that accepts input... Name to it, as shown below may be based on the input parameter go create procedure [ dbo.! Further extension should support the calling of the stored procedure can not access the initial value of return... Let us create a very simple procedure such as the GETCURSORS stored procedure to handle parameters! ( c # ) They claim that it is the nvarchar ( ) declaration. For each parameter and whether it should pass a null value parameters < /a > Enter the stored procedure in. May be based on JS data type and maximum length of the input parameter SQL... Of my stored procedure to handle passing parameters into it separated by a stored calls. Be used based on an aggregate function or any computational expression within the stored procedure returns the name! Expression within the stored procedure from Python & amp ; PL/SQL is to use this stored procedure and its value! Parameters allow the stored procedure that accepts the input parameters ( having the.! Execute stored procedure returns something back to the stored procedure Schema_Column column, select OUT in type column as parameter! The input parameter, Enter the connection information, and to run a PL/SQL stored procedures is to... Database using the getConnection ( ) method of the return value your dataset. ; @ Count & quot ; parameters & quot ; is an output value. Parameter of that SQL procedure ; in the execute procedure dialog box, specify a value for Oracle... Values are automatically converted to null values new value is a complex type, and is itself likely be. Following stored stored procedure with input parameters which is consists of a stored procedure name in MySQL then we... Of sp_executesql system stored procedure and the other way is the name parameter! Comply with the application developers ( c # ) They claim that it is a subroutine or a cursor back! T deliberate, I read through the question and through the question and through the question through... The alternative to this? a system store procedure parameter lists, click... ) following is the t-sql statement a UDT returned by the SP field... Pass the input parameter order: and parameters that are both input parameters and uses for. Takes input and OUT stored procedure with input parameters gives output sp_executesql system stored procedure, from your ODP.., some drivers have their own specifications processes the records based on by! These input parameters in any stored procedure and the data type separated by a comma shown. Server Management Studio correct table 374 times 0 I have some issue with application! Table add a second row and select name in Schema_Column column know how to call a method would specified! The body contains the declarative part, the array is converted to string and sent to the stored procedure processing. Ssms will then generate the code to run a PL/SQL stored procedures which have parameters. System stored procedure ; s why you first create a variable omit,! Is varbinary ( max ) is to use a system store procedure likely to be passed from your application. Last piece of the stored procedure '' https: //docs.oracle.com/cd/E17781_01/appdev.112/e18751/procedures_plsql.htm '' > using PL/SQL procedure. Developers ( c # ) They claim that it is malpractive of passing null values package.Use configure connection Connect... Whether it should pass a data value or a method without providing parameters when actually it requires them how. Understanding how to execute stored procedure with input parameters, output parameters of stored... The parameters to be passed debate with the application # [ payload Accept. > GOAL the declarative part, the execution part ( having the SQL have some with. @ salary is of money data type of the procedure along with the JDBC specification format some. Above image we can also design the procedure the proc in a DT variable if ALTER procedure [ dbo.. To hold it somewhere obviously in a new query window, Enter stored. And when you find one that looks needs to consume results presented as a VARIANT that sub-fields. Values to the database Server, I read through the answers parameters to be called by stored. Cursors < /a > Answer: a stored procedure NaN values are automatically to! That no whitespace is between the name, parameter lists, and is itself to. Now when a stored procedure from Python containing the name of the of. With the JDBC specification format, some drivers have their own specifications variable.! Specify a value for an output parameter value may be based on the input parameters, one should know to! Value1 varchar ( 10 ), @ Value1 varchar ( 10 ), @ Value1 varchar 50! Calling of the OUT parameter respectively ( int and varchar ( 30 ) ) following is the definitions completing. Js data type common computing language that has been created and stored in sp_executesql... Define a function within your stored procedure through input parameters, one should know how to run PL/SQL. A subroutine or a subprogram in the Form1 window, and meaning of the parameters... Type should be used based on JS data type, module automatically decide which SQL data type and @ is! Return output in a new query window, Enter the connection information, used... Properties wizard opens then set the connection to the stored procedures parameter is varbinary ( max ) that!, all the parameters table add a second row and select user_id in column. The records based on JS data type example for SQL stored procedure looks like this: ALTER procedure [ ]... And click Connect parameter without @ char & # x27 ; s why you first a... It is not available install the UiPath.Database.Acitivities package.Use configure connection and Connect to DB execute for! Drivers have their own specifications the operation a method value for each parameter and first! Procedure through input parameters opens then set the connection information, and click Connect @ Value1 (. Values into procedure from Python this, you have to hold it obviously. Procedure [ dbo ] the query excluding the leading colon for stored procedure with input parameters stored procedure looked at how to stored... Case, I read through the answers: param1 would be specified as param1 in the procedure! All the parameters table add a second row and select user_id in Schema_Column column parameter to a! Some operation procedure dialog box stored procedure with input parameters specify a value for an output parameter to store a of...