Eingabe-und Ausgabeparameter in CLI -Tracedateien interpretieren

Wie jede reguläre Funktion haben auch die Db2 Call Level Interface (CLI )-Funktionen Eingabe- und Ausgabeparameter. In einem CLI -Trace können diese Eingabe-und Ausgabeparameter angezeigt werden, die Details dazu enthalten, wie jede Anwendung eine bestimmte CLI -API aufruft. Die Eingabe-und Ausgabeparameter für jede CLI -Funktion, wie im CLI -Trace gezeigt, können mit der Definition dieser CLI -Funktion in den Referenzabschnitten der CLI der Dokumentation verglichen werden.

Es folgt ein Snippet aus einer CLI -Tracedatei:

SQLConnect( hDbc=0:1, szDSN="sample", cbDSN=-3, szUID="",
            cbUID=-3, szAuthStr="", cbAuthStr=-3 ) 
    ---> Time elapsed - +6.960000E-004 seconds 

SQLRETURN   SQLConnect       (
            SQLHDBC           ConnectionHandle,  /* hdbc */
            SQLCHAR      *FAR ServerName,        /* szDSN */
            SQLSMALLINT       NameLength1,       /* cbDSN */
            SQLCHAR      *FAR UserName,          /* szUID */
            SQLSMALLINT       NameLength2,       /* cbUID */
            SQLCHAR      *FAR Authentication,    /* szAuthStr */
            SQLSMALLINT       NameLength3);      /* cbAuthStr */

Der erste Aufruf der Funktion CLI zeigt die Eingabeparameter und die ihnen zugeordneten Werte (je nach Bedarf) an.

Wenn CLI -Funktionen zurückgegeben werden, zeigen sie die resultierenden Ausgabeparameter an. Beispiel:

SQLAllocStmt( phStmt=1:1 ) 
    <--- SQL_SUCCESS   Time elapsed - +4.444000E-003 seconds 

In diesem Fall gibt die CLI-Funktion SQLAllocStmt( ) einen Ausgabeparameter phStmt mit dem Wert "1:1" (Verbindungshandle 1, Anweisungshandle 1) zurück.