src.com.ibm.as400.access.DBBaseReplyDS Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jt400-jdk8 Show documentation
Show all versions of jt400-jdk8 Show documentation
The Open Source version of the IBM Toolbox for Java
The newest version!
///////////////////////////////////////////////////////////////////////////////
//
// JTOpen (IBM Toolbox for Java - OSS version)
//
// Filename: DBBaseReplyDS.java
//
// The source code contained herein is licensed under the IBM Public License
// Version 1.0, which has been approved by the Open Source Initiative.
// Copyright (C) 1997-2001 International Business Machines Corporation and
// others. All rights reserved.
//
///////////////////////////////////////////////////////////////////////////////
package com.ibm.as400.access;
import java.io.InputStream;
import java.io.IOException;
import java.io.PrintStream;
import java.util.Vector;
//--------------------------------------------------------------------
//
// Each reply consists of 3 parts: Header, Template, and
// Optional / Variable-length Data
//
// Header: Bytes 1 - 4: Length of the reply
// 5 - 6: Header id
// 7 - 8: Client/Server id
// 9 - 12: Client/Server instance
// 13 - 16: Correlation id
// 17 - 18: Length of template
// 19 - 20: Reply id
//
// Template: This is fixed length data that is required.
// Each reply has it's own template format and may vary
// depending on both the request id and client/server id.
// The operational results are stored on the IBM i
// system and can be received at a later time.
// Bitmap: Used to identify the operation results to
// return. Bit 1 is the left-most bit when it
// arrives at the IBM i system
// Bit 1: 1=reply should be sent immediately to
// the client application
// 0=reply is not sent and the rest of
// the bit map is ignored
// Bit 2: Message Id
// Bit 3: First Level Text
// Bit 4: Second Level Text
// Bit 5: Data Format
// Bit 6: Result Data
// Bit 7: SQLCA SQL Communications Area
// Bit 8: Server Attributes
// Bit 9: Parameter Marker format
// Bit 10: Translation Tables
// Bit 11: Data Source Information
// Bit 12: Package Information
// Bit 13: Request is RLE compressed @E2A
// Bit 14: RLE compression reply desired @E2A
// Bit 15: Extended column descriptors @K54
// Bit 16: Varying Character Column Compression @K54
// Bit 17: Cursor Attributes @cur
// Bit 18-32: Reserved @E2C @K54
// Reserved Area:
// Bit 1: Are indicators and data compressed? // @D1A
// Bit 2-32: Reserved // @D1A
// RTNORS: Numeric value of the Operation Results Set
// (ORS) that contains the data to be returned
// to the client.
// It must be non-negative.
// RTN_FID: Contains the ID of the function that
// requested this data to be returned to the
// client application
// RQSD_FID: Contains the ID of the function that
// requested this data to be put in the ORS
// Error Data: Contains the error level and the
// error return code for that level.
//
// Optional / Variable-length Data:
// This is optional data and/or mandatory data that
// varies in length. The following fields may be
// returned.
//
// Message ID: A seven character field that contains
// the id of the message generated as a
// results of the last operation performed
// by the system.
// First Level Message Text:
// The first level text of the message
// generated as a result of the last operation
// performed by the system.
// Second Level Message Text:
// The second level text of the message
// generated as a result of the last operation
// performed by the system.
// Server Attributes:
// Character string that contains the server
// attribute information.
// SQLCA: Character string that contains SQL
// information.
// Data Format: Contains the format (lay out) of the
// result data.
// Result Data: A string of data that was requested by
// function identified in the result function
// ID field.
// Parameter Marker Format:
// Contains the format (lay out) of the
// parameter markers for the statement.
// Translation Table Information:
// Two 256 byte translate tables are returned.
//
// See the readAfterHeader() method for the complete
// list.
//
//---------------------------------------------------------------------
/**
This is the base class for all database server reply data
streams. Every concrete database server reply data stream
should inherit from this class.
Here are the steps needed to handle a reply data stream
from the IBM i system.
1. Add a prototype reply data stream to the collection
of reply prototypes. There must be a prototype reply
for every type of reply that must be constructed
automatically.
static
{
AS400Server.addReplyStream (new DBReplyRequestedDS (),
"as-database");
}
2. Send a request and ask for reply data
DBReplyRequestedDS reply = sendAndReceive (request);
a. AS400Server run method will call ClientAccessDataStream
construct method.
b. ClientAccessDataStream construct method will call
readAfterHeader which parses out the data stream
3. Check for errors
An error class and return code are always returned. These
report on the success or failure of the request. The
meanings of the various error classes and return codes
are described in the database server specification.
int ErrorClass = requestedData.getErrorClass();
int ErrorClassReturnCode = requestedData.getReturnCode()
4. Use the methods provided to get the information needed from
the data stream. The results returned will depend on the
values in the Operation Results Bitmap.
**/
//
// Performance note:
//
// (C.Nock 06/30/97):
//
// I have been investigating how to speed up the construction of
// replies. I would like to reuse storage between replies (like
// is done with requests) using DBStorage and DBStoragePool objects.
// There are two reasons why this is currently not possible.
//
// * We are not responsible for allocating the byte array. This
// is done in ClientAccessDataStream.construct().
//
// * Reusing storage for replies requires the code to explicitly
// state that it is done using a particular reply, which would
// make the code really messy. Of course, we could release the
// storage in the finalize() method of the reply, but this would
// somewhat unreliable.
//
// It was suggested that we override DataStream.read(), but all that
// does is the copying of the bytes from an input stream into a
// byte array. This is a necessary action and I am not sure how
// we could improve on it.
//
// Performance note:
//
// (C. Smith 09/07/01):
//
// I am pooling reply datastreams. It is not messy.
abstract class DBBaseReplyDS
extends ClientAccessDataStream
{
// Constants.
private static final String NODATA_ = "0";
private static final int TEMPLATE_LENGTH_ = 20;
// Template variables.
private int errorClass_ = 0;
private int returnCode_ = 0;
// Optional variables.
private int byteCount_ = -1; // @E2A
private long currentLOBLength_ = -1; // @E1A, see @E6 comment below
private DBDataFormat dataFormat_ = null;
private DBExtendedColumnDescriptors extendedColumnDescriptors_ = null; // @G4A
private String firstLevelMessageText_ = null;
private DBLobData lobData_ = null; // @D2C
// @C1D private int lobLocatorHandle_ = -1;
private String messageId_ = null;
private DBReplyPackageInfo packageInfo_ = null;
private DBDataFormat parameterMarkerFormat_ = null;
private DBData resultData_ = null;
private boolean rleCompressed_ = false; // @E3A
private String secondLevelMessageText_ = null;
private DBReplyServerAttributes serverAttributes_ = null;
private Vector sqlca_ = null; // Vector of DBReplySQLCA
private DBReplyXids xids_ = null; // @E0A
private String alternateServer_ = null; // @X1A
// Don't pool this objects, but rely on the pooling of DBReplayRequestedDS objects
DBStorage storage_ = DBDSPool.storagePool_.getUnpooledStorage(); //@P0A @B5C
private boolean inPool_ = false; // Is this reply part of a pool? @B5A
private int holdable = -1; //@cur
private int scrollable = -1; //@cur
private int updatable = -1; //@cur
private int sensitive = -1; //@cur
private int isolationLevel = -1; //@isol
//@P0A - Call this in place of constructing a new reply datastream.
final void initialize()
{
data_ = storage_.getData();
errorClass_ = 0;
returnCode_ = 0;
byteCount_ = -1;
currentLOBLength_ = -1;
dataFormat_ = null;
firstLevelMessageText_ = null;
lobData_ = null;
messageId_ = null;
packageInfo_ = null;
parameterMarkerFormat_ = null;
resultData_ = null;
rleCompressed_ = false;
secondLevelMessageText_ = null;
serverAttributes_ = null;
sqlca_ = null;
xids_ = null;
holdable = -1; //@cur
scrollable = -1; //@cur
updatable = -1; //@cur
sensitive = -1; //@cur
extendedColumnDescriptors_ = null; //@79jqev
isolationLevel = -1; //@isol
alternateServer_ = null; // @X1A
}
/**
Output the byte stream contents to the specified PrintStream.
The output format is two hex digits per byte, one space every
four bytes, and sixteen bytes per line.
@param ps the output stream
**/
void dump(PrintStream ps)
{
DBBaseRequestDS.dump(ps, data_, data_.length);
// Report whether or not the datastream was compressed. @E3A
if (rleCompressed_) // @E3A
ps.println("Reply was received RLE compressed."); // @E3A
}
// See @E6 comment below
public long getCurrentLOBLength() // @E1A
{ // @E1A
return currentLOBLength_; // @E1A
} // @E1A
//@cur new method
/**
Returns the cursor attribute holdable.
@return The server attribute holdable. (1 is holdable, 0 is not holdable, -1 if unknown (pre-550))
**/
public int getCursorAttributeHoldable()
{
return holdable;
}
//@cur new method
/**
Returns the cursor attribute Scrollable.
@return The server attribute Scrollable. (1 is Scrollable, 0 is not Scrollable, -1 if unknown (pre-550))
**/
public int getCursorAttributeScrollable()
{
return scrollable;
}
//@cur new method
/**
Returns the cursor attribute Updatable.
@return The server attribute Updatable. (1 is Updatable, 0 is not Updatable, -1 if unknown (pre-550))
**/
public int getCursorAttributeUpdatable()
{
return updatable;
}
//@cur new method
/**
Returns the cursor attribute Sensitive.
@return The server attribute Sensitive. (1 is Sensitive, 0 is not Sensitive, -1 if unknown (pre-550))
**/
public int getCursorAttributeSensitive()
{
return sensitive;
}
/**
Returns the data format.
@return The data format, or null if not included or empty.
**/
public DBDataFormat getDataFormat()
{
return dataFormat_;
}
/**
Returns the error class.
@return The error class.
**/
public int getErrorClass()
{
return errorClass_;
}
//@G4A
/**
Returns the extended column descriptors.
@return The extended column descriptors, or null if not included or empty.
**/
public DBExtendedColumnDescriptors getExtendedColumnDescriptors ()
{
return extendedColumnDescriptors_;
}
/**
Returns the first level message text.
@return The first level message text, or null if not included or empty.
**/
public String getFirstLevelMessageText()
{
return firstLevelMessageText_;
}
//@isol
/**
Returns the cursor isolation level.
@return The cursor isolation level.
**/
public int getCursorIsolationLevel()
{
return isolationLevel;
}
/**
Returns the LOB data.
@return The LOB data, or null if not included or empty.
**/
public DBLobData getLOBData() // @D2C
{
return lobData_;
}
// @C1D /**
// @C1D Returns the LOB locator handle.
// @C1D
// @C1D @return The LOB locator handle, or -1 if not included or empty.
// @C1D **/
// @C1D public int getLOBLocatorHandle ()
// @C1D {
// @C1D return lobLocatorHandle_;
// @C1D }
/**
Returns the message id.
@return The message id, or null if not included or empty.
**/
public String getMessageId()
{
return messageId_;
}
/**
Returns the package info.
@return The package info, or null if not included or empty.
**/
public DBReplyPackageInfo getPackageInfo()
{
return packageInfo_;
}
/**
Returns the parameter marker format.
@return The parameter marker format, or null if not included or empty.
**/
public DBDataFormat getParameterMarkerFormat()
{
return parameterMarkerFormat_;
}
/**
Returns the result data.
@return The result data, or null if not included or empty.
**/
public DBData getResultData()
{
return resultData_;
}
/**
Returns the return code.
@return The return code.
**/
public int getReturnCode()
{
return returnCode_;
}
/**
Returns the function id of the corresponding request.
@return The function id of the corresponding request.
**/
public int getReturnDataFunctionId()
{
return get16bit(30);
}
/**
Returns the second level message text.
@return The second level message text, or null if not
included or empty.
**/
public String getSecondLevelMessageText()
{
return secondLevelMessageText_;
}
//@X1A
/**
Returns the alternate server information .
@return The alternate server information , or null if not
included or empty.
**/
public String getAlternateServer()
{
return alternateServer_;
}
/**
Returns the server attributes.
@return The server attributes, or null if not included or empty.
**/
public DBReplyServerAttributes getServerAttributes()
{
return serverAttributes_;
}
/**
Returns the SQLCA.
@return SQLCA, or null if not included or empty.
**/
public DBReplySQLCA getSQLCA()
{
if (sqlca_ == null) {
return null;
} else {
if (sqlca_.size() == 0) {
return null;
} else {
return (DBReplySQLCA) sqlca_.elementAt(0);
}
}
}
/**
Returns the SQLCA.
@return the Vector of DBReplySQLCA, or null if not included or empty.
**/
public Vector getSQLCAs()
{
return sqlca_;
}
// @E0A
/**
Returns the Xids.
@return The Xids, or null if not included or empty.
**/
public DBReplyXids getXids()
{
return xids_;
}
/**
Parses the datastream.
**/
public int readAfterHeader(InputStream in)
throws IOException
{
byteCount_ = super.readAfterHeader(in); // @E2C
return byteCount_; // @E2C
}
// @E2A - Moved from readAfterHeader().
void parse(int dataCompression) // @E2A
throws IOException // @E2A
{ // @E2A
//Determine if the variable-length fields have been compressed. //@K54
boolean vlfCompressed = ((get16bit(20) & 0x0001) ==0x0001); //@K54
boolean dataCompressed = ((get32bit(24) & 0x80000000) == 0x80000000); // @D1A
boolean oldCompressed = (dataCompressed && // @E2A
(dataCompression == AS400JDBCConnectionImpl.DATA_COMPRESSION_OLD_)); // @E2A
// Check to see if the data is RLE compressed. If so, expand it. // @E2A
rleCompressed_ = (dataCompressed && // @E2A
(dataCompression == AS400JDBCConnectionImpl.DATA_COMPRESSION_RLE_)); // @E2A
if (rleCompressed_)
{ // @E2A
// Decompress the bytes not including the 44 bytes header and template. @E2A
// @E2A
// The format of the header and template is this: @E2A
// Bytes: Description: @E2A
// 4 LL - Compressed length of the entire datastream. @E2A
// 36 The rest of the uncompressed header and template. @E2A
// 4 ll - Length of the compressed data + 10. @E3A
// 2 CP - The compression code point. @E3A
// 4 Decompressed length of the data. @E2A
// LL-10 Compressed data. @E2A @E3C
//
// After decompression, the header and template should look like this: @E2A
// Bytes: Description: @E2A
// 4 LL - Length of the entire datastream after decompress. @E2A
// 36 The rest of the uncompressed header and template. @E2A
// LL-40 Decompressed data. @E2A
// Check the CP to determine the compression scheme. We currently only // @E3A
// handle RLE. // @E3A
int compressionSchemeCP = get16bit(44); // @E3A
if (compressionSchemeCP != AS400JDBCConnectionImpl.DATA_COMPRESSION_RLE_) // @E3A
throw new IOException(); // @E3A
int lengthOfDecompressedData = get32bit(46); // @E2A @E3C
byte[] newData = new byte[lengthOfDecompressedData + 40]; // @E2A
BinaryConverter.intToByteArray(newData.length, newData, 0); // @E2A
System.arraycopy(data_, 4, newData, 4, 36); // @E2A
DataStreamCompression.decompressRLE(data_, 50, get32bit(0)-50, // @E2A @E3C
newData, 40, DataStreamCompression.DEFAULT_ESCAPE, true); // @E2A
data_ = newData; // @E2A
byteCount_ = data_.length - 20; // @E2A
} // @E2A
// Read the template portion of data stream.
errorClass_ = get16bit(34);
returnCode_ = get32bit(36);
// Move offset to the start of the optional - variable
// length portion of the data stream.
int offset = HEADER_LENGTH + TEMPLATE_LENGTH_;
// Using offset as a pointer into the datastream,
// walk through the optional - variable length portion
// of the data stream.
while (offset < byteCount_ + HEADER_LENGTH)
{ // @E2C
int parmLength = get32bit (offset);
int codePoint = get16bit (offset + 4);
// There may be times when a length (ll) and a
// codepoint were returned but no data. In this
// case the length will be = 6. We will treat
// this as if no such parameter came down.
switch (codePoint)
{
// Message ID.
case 0x3801:
// 8 = length (4) + codePoint (2) + ccsid (2)
if (parmLength != 6)
{ // data was sent
ConverterImplRemote converter = ConverterImplRemote.getConverter (get16bit (offset + 6), system_); // @D0C
messageId_ = converter.byteArrayToString (data_, offset + 8, parmLength - 8);
}
else // no data was sent
messageId_ = NODATA_;
break;
// First level message text.
case 0x3802:
// 10 = length (4) + codePoint (2) + ccsid (2) + streamlength (2)
if (parmLength != 6)
{ // data was sent
ConverterImplRemote converter = ConverterImplRemote.getConverter (get16bit (offset + 6), system_); // @D0C
firstLevelMessageText_ = converter.byteArrayToString (data_, offset + 10, parmLength - 10);
}
else // no data was sent
firstLevelMessageText_ = NODATA_;
break;
// Second level message text.
case 0x3803:
// 10 = length (4) + codePoint (2) + ccsid (2) + streamlength (2)
if (parmLength != 6)
{ // data was sent
ConverterImplRemote converter = ConverterImplRemote.getConverter (get16bit (offset + 6), system_); // @D0C
secondLevelMessageText_ = converter.byteArrayToString (data_, offset + 10, parmLength - 10);
}
else // no data was sent
secondLevelMessageText_ = NODATA_;
break;
// Server attributes.
case 0x3804:
try
{
serverAttributes_ = new DBReplyServerAttributes (data_,
offset + 8,
parmLength);
}
catch (DBDataStreamException x)
{
throw new IOException ();
}
break;
// Data format.
case 0x3805:
if (parmLength != 6)
{
dataFormat_ = new DBOriginalDataFormat ();
dataFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty data format."); //@79jqev
}
break;
// Result data.
case 0x3806:
if (parmLength != 6)
{
resultData_ = new DBOriginalData (parmLength, oldCompressed); // @D1C @E2C
resultData_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty result data."); //@79jqev
}
break;
// SQLCA.
case 0x3807:
if (sqlca_ == null) {
sqlca_ = new Vector();
}
sqlca_.add(new DBReplySQLCA (data_, offset + 6, parmLength));
break;
// Parameter marker format.
case 0x3808:
if (parmLength != 6)
{
parameterMarkerFormat_ = new DBOriginalDataFormat ();
parameterMarkerFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty parameter marker format."); //@79jqev
}
break;
// Translation table information.
// case 0x3809:
// We don't care much about translatation
// table information.
// break;
// DSN attributes.
// case 0x380A:
// We don't care much about DSN attributes.
// break;
// Package return information.
case 0x380B:
packageInfo_ = new DBReplyPackageInfo (data_,
offset + 6, parmLength, system_.getCcsid()); // @D3C
break;
// Extended data format.
case 0x380C:
if (parmLength != 6)
{
dataFormat_ = new DBExtendedDataFormat ();
dataFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty extended data format."); //@79jqev
}
break;
// Extended parameter marker format.
case 0x380D:
if (parmLength != 6)
{
parameterMarkerFormat_ = new DBExtendedDataFormat ();
parameterMarkerFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty extended parameter marker format."); //@79jqev
}
break;
// Extended result data.
case 0x380E:
if (parmLength != 6)
{
//@K54D if(vlfCompressed) //@K54 //Note: oldCompressed should always be false for V5R1 systems and greater
resultData_ = new DBExtendedData(parmLength, oldCompressed, vlfCompressed); //@K54
//@K54D else //@K54
//@K54D resultData_ = new DBExtendedData(parmLength, oldCompressed); // @D1C @E2C @K54C
resultData_.overlay (data_, offset + 6);
// @C1D // This doubles as lob data.
// @C1D lobData_ = new DBByteSubarray (parmLength - 6);
// @C1D lobData_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty extended result data."); //@79jqev
}
break;
// LOB locator data. // @C1A
case 0x380F:
if (parmLength != 6)
{ // @C1A
// @C1D lobLocatorHandle_ = get32bit (offset + 6);
// @D2D int ccsid = get16bit (offset + 6); // @C1A
int length = get32bit (offset + 8); // @C1A
lobData_ = new DBLobData (length, parmLength -12, oldCompressed); // @C1A @D2C @D4C @E2C @E4C
lobData_.overlay (data_, offset + 12); // @C1A
} // @C1A
else //@79jqev
{ //@79jqev
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty lob locator."); //@79jqev
} //@79jqev
break;
// @E6 Warning, currentLOBLength_ is wrong if the lob is a
// graphic lob (DBClob)! It is too hard to get that
// information through the collective so this code
// can do the right thing. At the time of the @E6
// change, the only code that uses this value is JDLobLocator,
// and it fixes it up because it knows the field is a
// graphic field.
// Current LOB length. // @E1A
case 0x3810: // @E1A
int sl = get16bit(offset + 6); // @E1A
if (sl == 0) // @E7A
currentLOBLength_ = 0; // @E7A
else if (sl == 4) // @E1A @E7C
currentLOBLength_ = get32bit(offset + 8); // @E1A
else // @E1A
currentLOBLength_ = get64bit(offset + 8); // @E1A
break; // @E1A
// Xids. // @E0A
case 0x38A1: // @E0A
xids_ = new DBReplyXids(data_, offset, parmLength); // @E0A @E5C
break; // @E0A
// @G4A Extended column descriptors information (can be turned on and off by the user
// @G4A with the "extended metadata" property)
case 0x3811:
if (parmLength != 6) // @G4A
{ // @G4A
extendedColumnDescriptors_ = new DBExtendedColumnDescriptors( // @G4A
data_, offset + 6); // @G4A
} // @G4A
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty extended column descriptor."); //@79jqev
}
break;
// Super Extended data format. //@540
case 0x3812:
if (parmLength != 6)
{
//System.out.println("Extended data format: ");
dataFormat_ = new DBSuperExtendedDataFormat ();
dataFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty super extended data format."); //@79jqev
}
break;
// Super Extended parameter marker format. //@540
case 0x3813:
if (parmLength != 6)
{
//System.out.println("extended parameter marker format");
parameterMarkerFormat_ = new DBSuperExtendedDataFormat ();
parameterMarkerFormat_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty parameter marker format."); //@79jqev
}
break;
// Cursor attributes //@cur
case 0x3814:
if (parmLength != 6)
{
int attrs = get32bit(offset + 6); //4 bytes, 1 per byte
holdable = (attrs >> 24) & 0x0001;
scrollable = (attrs >> 16) & 0x0001;
updatable = (attrs >> 8) & 0x0001;
sensitive = ((attrs >> 0) & 0x0001) == 1 ? 0 : 1; //attr from zda is INsensitive
attrs = get32bit(offset + 10); //@isol
isolationLevel = (attrs >> 24) & 0x000f; //@isol
/*(Byte 5 - Cursor Isolation Level
'0' None
'1' Cursor Stability
'2' Uncommitted Read (*CHG)
'3' Read Stability (*ALL)
'4' Repeatable Read */
}
else //@79jqev
{ //@79jqev
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty cursor attributes."); //@79jqev
}
break;
case 0x3901: //@array
// Variable result data. (used when getting output parms from stored procedure if a parm is an array)
if (parmLength != 6)
{
//ouput parms
resultData_ = new DBVariableData(); // x3901 codepoint
resultData_.overlay (data_, offset + 6);
}
else //@79jqev
{
if (Trace.traceOn_) //@79jqev
Trace.log(Trace.DIAGNOSTIC, "Received empty extended result data."); //@79jqev
}
break;
case 0x3846: // Alternate server @X1A
if (parmLength > 10) {
// 10 = length (4) + codePoint (2) + ccsid (2) + streamlength (2)
{ // data was sent
ConverterImplRemote converter = ConverterImplRemote.getConverter (get16bit (offset + 6), system_); // @D0C
alternateServer_ = converter.byteArrayToString (data_, offset + 10, parmLength - 10);
}
} else {
if (Trace.traceOn_)
Trace.log(Trace.DIAGNOSTIC, "Received empty alternate server.");
}
break;
//README: When adding a new codepoint, please add any needed initializations
//of references to the initialize() method since this object gets reused.
}
offset += parmLength;
}
}
void setInPool(boolean inPool) {
inPool_ = inPool;
} /*@B5A*/
synchronized void returnToPool() {
//
// Note: At this point the data_ pointer contains memory that was allocated
// in the static ClientAccessDataStream.construct(). This data_ pointer has
// probably been shared with other data structures. Reset the data_ pointer
// to the one from the storage object so that the one allocated by
// ClientAccessDataStream.construct() will not be overwritten by
// super.returnToPool();
//
//
data_ = storage_.getData();
super.returnToPool();
// In this is not in the pool, go ahead and free the storage
if (!inPool_) {
// Note: storage_ was allocated using getUnpooledStorage.
// We do not need to return it to the pool.
// if (storage_ != null) {
// storage_.returnToPool();
// }
storage_ = null;
data_ = null;
}
} /*@B5A*/
// Make sure the storage is freed before going away. @B5A
synchronized protected void finalize()
throws Throwable
{
// Note: storage_ was allocated using getUnpooledStorage.
// We do not need to return it to the pool.
// if (storage_ != null) {
// storage_.returnToPool();
// }
storage_ = null;
data_ = null;
super.finalize();
} /*@B5A*/
}