Skip to main content

ISQL Vs SQLCMD - How they return value?!

ISQL is not supported in SQL Server 2005. SQLCMD is a replacement for ISQL utility. I don’t go in detail about SQLCMD. Instead I’m going to explain one big difference between these two utilities that require attention.

SQLCMD does not support passing of stored procedure return value to the exit value. Let me explain this with examples.

Consider a simple Stored Procedure.

CREATE PROC dbo.Sample

@Val INT

AS

BEGIN

IF @Val = 1

RETURN 1

ELSE

RETURN 0

END

This stored proc is self explanatory.

When this SP is called from ISQL, the RETURN value is passed to EXIT command of ISQL. That means we can capture this return value and process accordingly.

In case of SQLCMD, the RETURN value will not be passed to EXIT command. Because, SQLCMD expects SP to SELECT return value. That is, if we change SP as shown below, this works with SQLCMD.

CREATE PROC dbo.Sample

@Val INT

AS

BEGIN

IF @Val = 1

SELECT 1

ELSE

SELECT 0

END

Assume that you have batch files where you are calling many SPs using ISQL. And you have to change from ISQL to SQLCMD. Normally, in batch files the returned value is used for error handling. If you have huge number of SPs, then it would be a lot of effort to change each and every SP to return value using SELECT. Instead you can change batch files so that it’ll handle return value and no change is required in SP. Let us see an example here.

SET SP=dbo.Sample 2

SET SQL=

SET SQL=%SQL% DECLARE @Return INT

SET SQL=%SQL% SET @Return = -100

SET SQL=%SQL% EXEC @Return = %SP%

SET SQL=%SQL% SELECT @Return

CALL SQLCMD -Q "exit( %SQL% )" -b /S MyServer /d MyDB /E

Here, you are executing SP using EXEC statement. Then RETURNed value is SELECTed and passed to EXIT command of SQLCMD. Actually you are executing following statements using SQLCMD.

DECLARE @Return INT

SET @Return = -100

EXEC @Return = dbo.Sample 1

SELECT @Return

Here, @Return is set to -100 before executing SP. SQLCMD returns -100 if any error encounters before selecting return value.

This way, you can keep all your existing SPs intact.

Comments

Post a Comment

Popular posts from this blog

All about SharePoint List View Styles

Sometimes, there are out of the box features which we tend to ignore and later when we do apply, we are more than happy about the feature which is readily available in SharePoint. One such feature is List View Style. I never thought I would write a post on this. However, whenever I spoke about this with users, people were excited to see the result. That prompted me to write this post. Instead of getting into only theory part, I will basically take use cases where these styles can be applied and also touch up on on some minor limitations with certain style. When you are creating/modifying a List view, you will get an option to select View Style. As shown below, there are 8 options available and Default is always set if you ignore this style. List of View Styles I will take typical Contact List and Announcement List to explian about these styles. Let us go one by one. Default: This view, as name suggest, is the default style in a view. This is one of the widely seen style ...
1 comment
Read more

Document ID Service - New Feature in SharePoint

When I explored this new feature of SharePoint in Online (this feature is available in SharePoint 2013 also), I found it interesting because it solved one of the common problems people faced in SharePoint. I will first explain about this feature and I'll cover the problem and the solution in another post. This feature allows Site Collection Admin assign a unique ID to every document in the site collection out of the box. If you recall, there was no out of the box way to assign a unique number to the documents across libraries in a site collection. Yes ID column is unique but only within a library. Document ID column contains a number which is unique across libraries. To start with, let's have a look at a typical document library. This is a familiar view for SP guys. By default, you don't get Document ID column in a library. All Items View To get Document ID column, you need to activate a site collection feature "Document ID Service" as shown below. S...
Post a Comment
Read more

How to update Person field with multiple values using REST API

Person or Group field in SharePoint is similar to a Lookup field. When you are updating this field using REST API, you need to append "Id" to the name of the column in the body construct. For example, the body construct looks like this: data: { "__metadata": { "type": "SP.Data. ListName ListItem" }, "Title": "First Item", " PeopleField Id": "4" }; The highlighted portions should be replaced by the actual List Name and Column Name. In the above example, the REST call is updating a List item with Title and People columns. How to get the value for user ID ("4" in the above example) needs a separate explanation and that will be my next post! The above example works fine if Person field is configured to accept only one value. If we change the Person field to accept multiple values, how do we pass more than one value in the REST call? Since we normally separate user names with semicolon in peop...
12 comments
Read more