DBServer Message Trace

DATABridge Server Accessory message tracing is available via the -t 4 or -t 0x4 command line option. The DATABridge host API calls highlight pertinent information during communications with the Server Accessory on the host. Server Accessory messages are listed in the log file and include the following:

Message

Description

Common_Process: DBDeSelect Table=name, stridx= nnnn, rslt= errorcode

The DBDeselect API call is used to deselect data sets that need to be excluded from change tracking. An example would be a data set whose AA values are invalidated by a garbage collection reorganization. This message shows the name of the data set and its related structure index. If the errorcode is nonzero, this message is followed by a Host message.

Common_Process: DBSelect Table=name, stridx=nnnn, rslt=errorcode

The DBSelect API call is used to select data sets when the DATABridge Client starts a process or a clone command. This message shows the name of the data set and its related structure. If the errorcode is nonzero, this message is followed by a Host message.

Datasets_CB: dataset_name (strnum), subtype = dd

CB stands for callback. This message shows the receipt of a data set information record from DBServer during the execution of a dbutility define or redefine command.

Define_Table_Items: table = name,
item = data_item_name data_type (sql_length)

This message shows the data type and SQL length of data items as they are inserted in the client control tables. This occurs during execution of the dbutility define or redefine command.

Get_Response: Req=requesttype Rslt=resulttype Len=length

where requesttype is the request type (API call name), resulttype is the returned status (typically OK), and length is the number of bytes of data that follow the status in the response packet

This message indicates that the DATABridge Client received a response to a remote procedure call other than DBREAD or DBWAIT.

Layout_CB: DataSet = name[/rectype],
item (number) = name, data_type = dd,
dlen = dd, scaling = dd

CB stands for callback. This message shows the receipt of a data set item layout information record from DBServer during the execution of a dbutility define or redefine command.

Read_CB: Type=typename Strnum=sss Idx=iii SNR=rr,
aa= hhhhhhhhhhhh

This message indicates that the DATABridge Client received a response from DBServer in response to a DBREAD or DBWAIT call.

typename is the response name (CREATE, DELETE, MODIFY, STATE, DOC, MODIFY_BI, or MODIFY_AI)

sss is the structure number as stored in the strnum column in the DATASETS table

iii is the structure index assigned to the structure when it is selected via the DBSELECT call

rr is the stack number (For protocol levels greater than 6, this value is 0 as it is not provided by the server.)

hhhhhhhhhhhh is the value of the absolute address of the DMSII record (For protocol levels greater than 6, this value is all zeros unless the data set uses the AA value as a key.)

Read_CB: Type=DOC Action=actioncode TranCount=ttt StrNum=nnnn SNR=number

This message is printed only when the enable_doc_records parameter is set to Yes in the configuration file. The DATABridge Client uses the DOC record only for debugging purposes. DOC records are documentation records that are optionally sent by the DBEngine to document the events that occur while DBEngine is reading the audit files.

Read_CB: Type=LINK_AI StrNum= number
Idx= number SNR=number aa=hex_value

This message indicates that the DATABridge Client received a DMSII LINK from DBServer in response to a DBREAD or DBWAIT API call.

Stateinfo: mode, AFN afn, ABSN absn, SEG seg, INX, inx, DMSII Time timestamp

Stateinfo shows a location in the audit file. Mode is the same as ds_mode, which indicates whether or not a data set has been cloned, reorganized, purged, and so forth.