652 lines
23 KiB
HTML
652 lines
23 KiB
HTML
|
|
||
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<title>Start SQL Interactive Session (STRSQL)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="STRSQL.Top_Of_Page"></a>
|
||
|
|
<h2>Start SQL Interactive Session (STRSQL)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#STRSQL.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRSQL.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRSQL.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRSQL"></a>
|
||
|
|
<p>The Start Structured Query Language (STRSQL) command starts the interactive SQL program. The program starts the statement entry of the interactive SQL program which immediately shows the Enter SQL Statements display. This display allows you to build, edit, enter, and run a SQL statement in an interactive environment. Any messages during the running of the program are shown on this display.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRSQL.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.COMMIT"><b>COMMIT</b></a></td>
|
||
|
|
<td valign="top">Commitment control</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *CHG, *CS, *ALL, *RR, *NC, *UR, *RS</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.NAMING"><b>NAMING</b></a></td>
|
||
|
|
<td valign="top">Naming convention</td>
|
||
|
|
<td valign="top"><b><u>*SYS</u></b>, *SQL</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.PROCESS"><b>PROCESS</b></a></td>
|
||
|
|
<td valign="top">Statement processing</td>
|
||
|
|
<td valign="top"><b><u>*RUN</u></b>, *VLD, *SYN</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.LIBOPT"><b>LIBOPT</b></a></td>
|
||
|
|
<td valign="top">Library option</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *USRLIBL, *ALLUSR, *ALL, *CURLIB</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.LISTTYPE"><b>LISTTYPE</b></a></td>
|
||
|
|
<td valign="top">List type</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *SQL</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.REFRESH"><b>REFRESH</b></a></td>
|
||
|
|
<td valign="top">Data refresh</td>
|
||
|
|
<td valign="top"><b><u>*ALWAYS</u></b>, *FORWARD</td>
|
||
|
|
<td valign="top">Optional, Positional 6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.ALWCPYDTA"><b>ALWCPYDTA</b></a></td>
|
||
|
|
<td valign="top">Allow copy data</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *OPTIMIZE, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.DATFMT"><b>DATFMT</b></a></td>
|
||
|
|
<td valign="top">Date format</td>
|
||
|
|
<td valign="top"><b><u>*JOB</u></b>, *USA, *ISO, *EUR, *JIS, *MDY, *DMY, *YMD, *JUL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.DATSEP"><b>DATSEP</b></a></td>
|
||
|
|
<td valign="top">Date separator character</td>
|
||
|
|
<td valign="top"><b><u>*JOB</u></b>, '/', '.', ',', '-', ' ', *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.TIMFMT"><b>TIMFMT</b></a></td>
|
||
|
|
<td valign="top">Time format</td>
|
||
|
|
<td valign="top"><b><u>*HMS</u></b>, *USA, *ISO, *EUR, *JIS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.TIMSEP"><b>TIMSEP</b></a></td>
|
||
|
|
<td valign="top">Time separator character</td>
|
||
|
|
<td valign="top"><b><u>*JOB</u></b>, ':', '.', ',', ' ', *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.DECPNT"><b>DECPNT</b></a></td>
|
||
|
|
<td valign="top">Decimal point</td>
|
||
|
|
<td valign="top"><b><u>*JOB</u></b>, *PERIOD, *COMMA, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRSQL.SRTSEQ"><b>SRTSEQ</b></a></td>
|
||
|
|
<td valign="top">Sort sequence</td>
|
||
|
|
<td valign="top">Single values: *HEX, <b><u>*JOB</u></b>, *JOBRUN, *LANGIDUNQ, *LANGIDSHR<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Sort sequence</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.LANGID"><b>LANGID</b></a></td>
|
||
|
|
<td valign="top">Language identifier</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b>, *JOBRUN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.PGMLNG"><b>PGMLNG</b></a></td>
|
||
|
|
<td valign="top">Program language</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *C, *CBL, *PLI, *RPG, *FTN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSQL.SQLSTRDLM"><b>SQLSTRDLM</b></a></td>
|
||
|
|
<td valign="top">SQL string delimiter</td>
|
||
|
|
<td valign="top"><b><u>*QUOTESQL</u></b>, *APOSTSQL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRSQL.COMMIT"></a>
|
||
|
|
<h3>Commitment control (COMMIT)</h3>
|
||
|
|
<p>Specifies whether SQL statements are run under commitment control.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u> <i>or</i> <u>*NC</u></b></dt>
|
||
|
|
<dd>Specifies that commitment control is not used. Uncommitted changes in other jobs can be seen. If the SQL DROP SCHEMA statement is included in the program, *NONE or *NC must be used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHG <i>or</i> *UR</b></dt>
|
||
|
|
<dd>Specifies the objects referred to in SQL ALTER, CALL, COMMENT ON, CREATE, DROP, GRANT, LABEL ON, RENAME, and REVOKE statements and the rows updated, deleted, and inserted are locked until the end of the unit of work (transaction). Uncommitted changes in other jobs can be seen.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CS</b></dt>
|
||
|
|
<dd>Specifies the objects referred to in SQL ALTER, CALL, COMMENT ON, CREATE, DROP, GRANT, LABEL ON, RENAME, and REVOKE statements and the rows updated, deleted, and inserted are locked until the end of the unit of work (transaction). A row that is selected, but not updated, is locked until the next row is selected. Uncommitted changes in other jobs cannot be seen.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL <i>or</i> *RS</b></dt>
|
||
|
|
<dd>Specifies the objects referred to in SQL ALTER, CALL, COMMENT ON, CREATE, DROP, GRANT, LABEL ON, RENAME, and REVOKE statements and the rows selected, updated, deleted, and inserted are locked until the end of the unit of work (transaction). Uncommitted changes in other jobs cannot be seen.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RR</b></dt>
|
||
|
|
<dd>Specifies the objects referred to in SQL ALTER, CALL, COMMENT ON, CREATE, DROP, GRANT, LABEL ON, RENAME, and REVOKE statements and the rows selected, updated, deleted, and inserted are locked until the end of the unit of work (transaction). Uncommitted changes in other jobs cannot be seen. All tables referred to in SELECT, UPDATE, DELETE, and INSERT statements are locked exclusively until the end of the unit of work (transaction).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.NAMING"></a>
|
||
|
|
<h3>Naming convention (NAMING)</h3>
|
||
|
|
<p>Specifies the naming convention used for objects in SQL statements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYS</u></b></dt>
|
||
|
|
<dd>The system naming convention (library-name/file-name) is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SQL</b></dt>
|
||
|
|
<dd>The SQL naming convention (schema-name.table-name) is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.PROCESS"></a>
|
||
|
|
<h3>Statement processing (PROCESS)</h3>
|
||
|
|
<p>Specifies what values are used to process the statements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RUN</u></b></dt>
|
||
|
|
<dd>The statements are syntax checked, data checked, and then run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VLD</b></dt>
|
||
|
|
<dd>The statements are syntax checked and data checked but not run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYN</b></dt>
|
||
|
|
<dd>The statements are syntax checked only.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.LIBOPT"></a>
|
||
|
|
<h3>Library option (LIBOPT)</h3>
|
||
|
|
<p>Specifies the list of libraries that are shown when you request list support from the Enter SQL Statements display (F4, F16, F17, F18). If you do not have *EXECUTE authority for a specified library, that library is not shown.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The job's current library is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRLIBL</b></dt>
|
||
|
|
<dd>Only the libraries in the user portion of the job's library list are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All of the libraries in the system, including QSYS, are shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>All user libraries are searched. All libraries with names that do not begin with the letter Q are searched except for the following:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered "user libraries", and are also searched:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
QDSNX QRCL QUSRSYS
|
||
|
|
QGPL QS36F QUSRVxRxMx
|
||
|
|
QGPL38 QUSER38
|
||
|
|
QPFRDATA QUSRINFSKR
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A different library name, of the form QUSRVxRxMx, can be created by the user for each release. VxRxMx is the version, release, and modification level of the library.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be shown.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.LISTTYPE"></a>
|
||
|
|
<h3>List type (LISTTYPE)</h3>
|
||
|
|
<p>Specifies what types of objects are displayed when you request list support from the Enter SQL Statements display (F16, F17, and F18) or from a prompt (F4) display.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All objects are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SQL</b></dt>
|
||
|
|
<dd>Only SQL created objects are displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.REFRESH"></a>
|
||
|
|
<h3>Data refresh (REFRESH)</h3>
|
||
|
|
<p>Specifies when the display select output data is refreshed. This parameter does not apply to any SQL SELECT statements that require the creation of a temporary result.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALWAYS</u></b></dt>
|
||
|
|
<dd>The data is always refreshed. You cannot specify *ALWAYS for this parameter and *OPTIMIZE for the <b>Allow copy of data (ALWCPYDTA)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FORWARD</b></dt>
|
||
|
|
<dd>The data is refreshed only as the user pages forward to the end of the data for the first time. After that, it is not refreshed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.ALWCPYDTA"></a>
|
||
|
|
<h3>Allow copy of data (ALWCPYDTA)</h3>
|
||
|
|
<p>Specifies whether a copy of the data can be used when running a SELECT statement.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>A copy of the data can only be used, if necessary, to run a SELECT statement.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OPTIMIZE</b></dt>
|
||
|
|
<dd>The system chooses whether to use the data retrieved directly from the database or to use a copy of the data. The decision is based on which choice provides the best performance.
|
||
|
|
<p>This value decreases the time required for the total query. Since the copy of the data must be made before returning the first row of the result table, the time to retrieve the first row may be increased.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>A copy of the data is not allowed. If the clauses in the SELECT statement require a copy of the data, an error message is returned. If the SELECT statement runs successfully, current data was used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.DATFMT"></a>
|
||
|
|
<h3>Date format (DATFMT)</h3>
|
||
|
|
<p>Specifies the format used when accessing date result columns. All output date fields are returned in the format you specify. For input date strings, the value you specify is used to determine whether the date is a valid format.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>An input date string that uses the format *USA, *ISO, *EUR, or *JIS is always valid.
|
||
|
|
</p>
|
||
|
|
<p>If you connect to a relational database that is on a system that is not an iSeries system, the format must be *USA, *ISO, *EUR, or *JIS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The format specified for the job at precompile time or when a new interactive SQL session is created is used.
|
||
|
|
<p>Use the Display Job (DSPJOB) command to determine the current date format for the job.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USA</b></dt>
|
||
|
|
<dd>The United States date format <b>mm/dd/yyyy</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ISO</b></dt>
|
||
|
|
<dd>The International Organization for Standardization (ISO) date format <b>yyyy-mm-dd</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EUR</b></dt>
|
||
|
|
<dd>The European date format <b>dd.mm.yyyy</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JIS</b></dt>
|
||
|
|
<dd>The Japanese Industrial Standard date format <b>yyyy-mm-dd</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MDY</b></dt>
|
||
|
|
<dd>The date format <b>mm/dd/yy</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DMY</b></dt>
|
||
|
|
<dd>The date format <b>dd/mm/yy</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YMD</b></dt>
|
||
|
|
<dd>The date format <b>yy/mm/dd</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JUL</b></dt>
|
||
|
|
<dd>The Julian date format <b>yy/ddd</b> is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.DATSEP"></a>
|
||
|
|
<h3>Date separator character (DATSEP)</h3>
|
||
|
|
<p>Specifies the separator to be used when accessing date result columns.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter applies only when *JOB, *MDY, *DMY, *YMD, or *JUL is specified for the <b>Date format (DATFMT)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The date separator specified for the job at precompile time, when a new interactive SQL session is created, or when Run SQL Statement (RUNSQLSTM) command is run.
|
||
|
|
<p>Use the Display Job (DSPJOB) command to determine the current date separator value for the job.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>'/'</b></dt>
|
||
|
|
<dd>A slash is used as the date separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>'.'</b></dt>
|
||
|
|
<dd>A period is used as the date separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>'-'</b></dt>
|
||
|
|
<dd>A dash is used as the date separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>','</b></dt>
|
||
|
|
<dd>A comma is used as the date separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>' ' <i>or</i> *BLANK</b></dt>
|
||
|
|
<dd>A blank is used as the date separator.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.TIMFMT"></a>
|
||
|
|
<h3>Time format (TIMFMT)</h3>
|
||
|
|
<p>Specifies the format used when accessing time result columns. All output time fields are returned in the format you specify. For input time strings, the value you specify is used to determine whether the time is specified in a valid format.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>An input time string that uses the format *USA, *ISO, *EUR, or *JIS is always valid.
|
||
|
|
</p>
|
||
|
|
<p>If you connect to a relational database that is on a system that is not another iSeries system, the time format must be *USA, *ISO, *EUR, *JIS, or *HMS with a time separator of a colon or period.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*HMS</u></b></dt>
|
||
|
|
<dd>The <b>hh:mm:ss</b> format is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USA</b></dt>
|
||
|
|
<dd>The United States time format <b>hh:mmxx</b> is used, where <b>xx</b> is AM or PM.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ISO</b></dt>
|
||
|
|
<dd>The International Organization for Standardization (ISO) time format <b>hh.mm.ss</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EUR</b></dt>
|
||
|
|
<dd>The European time format <b>hh.mm.ss</b> is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JIS</b></dt>
|
||
|
|
<dd>The Japanese Industrial Standard time format <b>hh:mm:ss</b> is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.TIMSEP"></a>
|
||
|
|
<h3>Time separator character (TIMSEP)</h3>
|
||
|
|
<p>Specifies the separator used when accessing time result columns.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter applies only when *HMS is specified for the <b>Time format (TIMFMT)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The time separator specified for the job at precompile time, when a new interactive SQL session is created, or when RUNSQLSTM is run is used.
|
||
|
|
<p>Use the Display Job (DSPJOB) command to determine the current time separator value for the job.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>':'</b></dt>
|
||
|
|
<dd>A colon is used as the time separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>'.'</b></dt>
|
||
|
|
<dd>A period is used as the time separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>','</b></dt>
|
||
|
|
<dd>A comma is used as the time separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>' ' <i>or</i> *BLANK</b></dt>
|
||
|
|
<dd>A blank is used as the time separator.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.DECPNT"></a>
|
||
|
|
<h3>Decimal Point (DECMPT)</h3>
|
||
|
|
<p>Specifies the decimal point character to be used for numeric constants in SQL statements. This value is also used as the decimal point character when casting between character and numeric values.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The representation for the decimal point is the value used by the job running the statement.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The QDECFMT system value is used as the decimal point character.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PERIOD</b></dt>
|
||
|
|
<dd>A period represents the decimal point.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*COMMA</b></dt>
|
||
|
|
<dd>A comma represents the decimal point.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.SRTSEQ"></a>
|
||
|
|
<h3>Sort sequence (SRTSEQ)</h3>
|
||
|
|
<p>Specifies the sort sequence table to be used for string comparisons in SQL statements on the Enter SQL Statements display.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The SRTSEQ value is retrieved when the user starts interactive SQL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBRUN</b></dt>
|
||
|
|
<dd>The SRTSEQ value for the job is retrieved each time the user starts interactive SQL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDUNQ</b></dt>
|
||
|
|
<dd>A unique-weight sort table is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDSHR</b></dt>
|
||
|
|
<dd>A shared-weight sort table is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>A sort sequence table is not used, and the hexadecimal values of the characters are used to determine the sort sequence.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Sort sequence</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the sort sequence table to be used with the interactive SQL session.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.LANGID"></a>
|
||
|
|
<h3>Language identifier (LANGID)</h3>
|
||
|
|
<p>Specifies the language identifier to be used when SRTSEQ(*LANGIDUNQ) or SRTSEQ(*LANGIDSHR) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The LANGID value specified for the job is used when the user starts a new interactive SQL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBRUN</b></dt>
|
||
|
|
<dd>The LANGID value for the job is retrieved each time the user starts interactive SQL.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>language-ID</i></b></dt>
|
||
|
|
<dd>Specify the language identifier to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.PGMLNG"></a>
|
||
|
|
<h3>Program language (PGMLNG)</h3>
|
||
|
|
<p>Specifies the program language syntax rules to use. To use this parameter, you must specify *SYN for the <b>Statement processing (PROCESS)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>You are not using a specific language's syntax check rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*C</b></dt>
|
||
|
|
<dd>You are checking syntax using the C language syntax rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CBL</b></dt>
|
||
|
|
<dd>You are checking syntax using the COBOL language syntax rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PLI</b></dt>
|
||
|
|
<dd>You are checking syntax using the PL/I language syntax rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RPG</b></dt>
|
||
|
|
<dd>You are checking syntax using the RPG language syntax rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FTN</b></dt>
|
||
|
|
<dd>You are checking syntax using the FORTRAN language syntax rules.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSQL.SQLSTRDLM"></a>
|
||
|
|
<h3>SQL string delimiter (SQLSTRDLM)</h3>
|
||
|
|
<p>Specifies the SQL string delimiter if *CBL is specified for the <b>Program language (PGMLNG)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*QUOTESQL</u></b></dt>
|
||
|
|
<dd>The SQL string delimiter is represented by the quotation mark (").
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APOSTSQL</b></dt>
|
||
|
|
<dd>The SQL string delimiter is represented by the apostrophe (').
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRSQL.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRSQL
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts the Interactive SQL program. The program starts the statement entry of the interactive SQL program which immediately shows the Enter SQL Statements display. This display allows you to build, edit, enter, and run a SQL statement in an interactive environment.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRSQL.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF9801</b></dt>
|
||
|
|
<dd>Object &2 in library &3 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9802</b></dt>
|
||
|
|
<dd>Not authorized to object &2 in &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9810</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9820</b></dt>
|
||
|
|
<dd>Not authorized to use library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9822</b></dt>
|
||
|
|
<dd>Not authorized to file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9830</b></dt>
|
||
|
|
<dd>Cannot assign library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL0113</b></dt>
|
||
|
|
<dd>Name &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL6141</b></dt>
|
||
|
|
<dd>Cannot use interactive SQL now.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL6145</b></dt>
|
||
|
|
<dd>Interactive SQL session has exceeded system limit.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL6332</b></dt>
|
||
|
|
<dd>Authorization list &1 does not exist.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL6342</b></dt>
|
||
|
|
<dd>Sort sequence &1 is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL6343</b></dt>
|
||
|
|
<dd>Language identifier &1 is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL9006</b></dt>
|
||
|
|
<dd>DB2 UDB Query Manager and SQL Development Kit for iSeries not at same install level as i5/OS.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SQL9012</b></dt>
|
||
|
|
<dd>DB2 UDB Query Manager and SQL Development Kit for iSeries not available.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSQL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|