IBM Books

API Reference

sqluqry - Load Query

Queries the server as to the status of the load.

Authorization

None

Required Connection

Database

API Include File

sqlutil.h

C API Syntax 



/* File: sqlutil.h */
/* API: Load Query */
/* ... */
SQL_API_RC SQL_API_FN
  sqluqry (
    char * pLocalMsgFileName,
    char * pRemoteMsgFileName,
    struct sqlca * pSqlca);
/* ... */

Generic API Syntax 



/* File: sqlutil.h */
/* API: Load Query */
/* ... */
SQL_API_RC SQL_API_FN
  sqlgqry (
    unsigned short LocalMsgFileNameLen,
    unsigned short RemoteMsgFileNameLen,
    char * pLocalMsgFileName,
    char * pRemoteMsgFileName,
    struct sqlca * pSqlca);
/* ... */

API Parameters

LocalMsgFileNameLen
Input. A 2-byte unsigned integer representing the length in bytes of the name of the local message file.
RemoteMsgFileNameLen
Input. A 2-byte unsigned integer representing the length in bytes of the name of the remote message file.
pLocalMsgFileName
Input. A string containing the name of the local file to be used for output messages.
pRemoteMsgFileName
Input. A string containing the base name to be used on the server for temporary files of a load currently in progress.
pSqlca
Output. A pointer to the sqlca structure. For more information about this structure, see SQLCA.

REXX API Syntax

This API can be called from REXX through the SQLDB2 interface. See How the API Descriptions are Organized, or the Embedded SQL Programming Guide. For a description of the syntax, see the Command Reference.

Sample Programs

C
\sqllib\samples\c\qload.sqc

COBOL
\sqllib\samples\cobol\qload.sqb

FORTRAN
\sqllib\samples\fortran\qload.sqf

Usage Notes

This API reads queries the status of the load from the file specified by pRemoteMsgFileName and places the results in the file specified by pLocalMsgFileName. The remote file specified will be the same as the remote file specified on the call to the LOAD API.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]

[ DB2 List of Books | Search the DB2 Books ]