Host Messages That Appear on the Client
The following host messages may appear onscreen and in the log file of the Client. If tracing is enabled, messages are also captured in the trace file.
All host messages are followed by a second message that provides an error number.
HOST ERROR: hosterrortext
Error Text: text
where hosterrortext is a message from the Client, as listed in this section.
Where | Is |
---|---|
hosterrortext | A message from the Client, as listed in this section. Host messages are prefixed by the timestamp hh:mm:ss, where hh is hours, mm is minutes, and ss is seconds. This message typically identifies the API (Engine entry point) being called and provides additional about the task being performed, whenever this is relevant. |
text | A message from the DBEngine or DBServer on the host, or Enterprise Server. All such messages contain a number whose range determines the origin of the message. DBEngine messages start at 0000, DBServer messages start at 1000, and Enterprise Server messages start at 1100. |
HOST ERROR: Databridge call failed for ATMEcho, error_number = number
HOST ERROR: Databridge call failed for DB_PumpMsg, error number = number
DB_PumpMsg
is an RPC to DBServer on the host that creates data traffic to test the speed of
the TCP/IP connection. This error can occur during a tcptest
command and indicates that
the RPC failed.
HOST ERROR: Databridge call failed for DB_Select on table datasetname, error number = number
This error can occur during a process
or clone
command, and it indicates that the
Databridge Engine was unable to select the requested data set. As part of initialization, the
Client send a DB_Select request for every data that it to be cloned or tracked. The DB_Select
RPC data include the State Information for the data set, which includes the mode and the audit location
from which to resume tracking changes. If the data set is to be cloned, the State Information consists of
all zeroes.
HOST ERROR: Databridge call failed for dbinfo, error number = number
This message, which can occur when you run a define
or redefine
command, indicates
that the Client was unable to retrieve information about the DMSII database from the
Databridge Engine using the DB_Info RPC. This error can also occur during a process
or
clone
command. The Client uses this RPC to determine if the update level of the DMSII
database has changed and makes the appropriate change to the update level value in the
DATASOURCES Client control table when the Client ignores an update level change. It also uses
this information to inhibit clones during periods where there is a DMSII reorganization that the
client has not yet caught up to.
HOST ERROR: Databridge call failed for initialize, error number = number
The Databridge initialize remote procedure call could not initialize the session between
DBServer and the Client. This message occurs after three unsuccessful attempts for a TCP/IP
connection. This message can occur when you run a define
, redefine
, process
, clone
,
or switchaudit
command.
HOST ERROR: Databridge call failed for initialvalue, error number = number
The Client uses the initialvalue remote procedure call (RPC) to get the initial value for a data
set. It uses this information to assign values to columns that are added as a result of a DMSII
reorganization. This message only occurs during a redefine
command.
HOST ERROR: Databridge call failed for keys, error number = number
Databridge was unable to retrieve information on keys. This message can occur when you run
a define
or redefine
command.
HOST ERROR: Databridge call failed for layout, error number = number
Databridge was unable to retrieve information on the layout of a data set. This message can
occur when you run a define
or redefine
command.
HOST ERROR: Databridge call failed for nullrecord, error number = number
The Client was unable to retrieve the nullrecord information for a data set. This message can
occur during a define
or redefine
command when the parameter read_null_records
is set to True. A null record is a DMSII record for a data set where all items are set to NULL using
the null values defined in the DASDL. The Client uses this information to construct the
null record file, which is used to determine if items are NULL.
HOST ERROR: Databridge call failed for open_audit, error_number = number
The Client uses this API during the redefine
command to force the Databridge Engine to use
the correct description file by opening the audit file that was being read when the DMSII
reorganization was detected. This technique makes it possible to process multiple
reorganizations when the Client is far behind DMSII.
The Client also uses this API during process
commands to ensure that the Engine uses the
correct description file when processing DMSII data. When the client has not yet caught up
with a DMSII reorganization, the proper description file must be used.
HOST ERROR: Databridge call failed for parameters CONCURR_EXTR, error number = number
The Client could not override the Databridge Engine parameter WORKERS = number during the
execution of a process
or clone
command.
HOST ERROR: Databridge call failed for parameters TG_BLOCKS, error number = number
The Client could not override the Databridge Engine parameter CHECKPOINT every number AUDIT
BLOCKS during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for parameters TG_ELAPSED, error number = number
The Client could not override the DBEngine parameter CHECKPOINT every number seconds
during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for parameters TG_TRANS, error number = number
The Client could not override the Databridge Engine parameter CHECKPOINT every number
TRANSACTIONS during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for parameters TG_UPDATES, error number = number
The Client could not override the Databridge Engine parameter CHECKPOINT every number
UPDATE RECORDS during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for primary_key, error number = number
The Client was unable to retrieve information on the primary keys for a data set. This message
can occur when you run a define
or redefine
command.
HOST ERROR: Databridge call failed for primary_set, error number = number
The Client was unable to retrieve information on the primary_set for a data set. This message
can occur when you run a define
or redefine
command.
HOST ERROR: Databridge call failed for reset_option LONGTRANS, error number = number
The Client could not reset the Databridge Engine parameter CHECKPOINT LONG TRANSACTIONS during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for reset_option NO REVERSALS, error number = number
Error Text: Host error text
The Client could not reset the Databridge Engine parameter NO REVERSALS during
the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for server_option INHIBIT_WFL, error number = number
The Client was unable to set the server option that inhibits the running of a WFL when an audit file is processed by the Engine. Normally such a WFL would be used to remove the audit files, once the Engine is done with them.
HOST ERROR: Databridge call failed for server_option STOP_{BEFORE | AFTER}_NAME, error number = number
The Client was unable to set the server option that causes the Engine to stop processing audit files when the specified task name is encountered is in the audit trail. The Engine can stop at the quiet point before or after the specified task is encountered. These values are defined in the client configuration file using the parameters stop before task
or stop after task
.
HOST ERROR: Databridge call failed for server_option STOP_{BEFORE | AFTER}_TIME, error number = number
The Client was unable to set the server option that causes the Engine to stop processing audit files when the specified time is reached. These values are defined in the client configuration file using the parameters stop before task
or stop after task
.
HOST ERROR: Databridge call failed for set_option DOC, AFN, error number = number
Databridge could not set the DBServer option that requests DOC records to be sent when a
new audit file is open during audit file processing. This message can occur at the start of a
process
or clone
command. The Client uses the DBSetOption remote procedure call to
request that the Databridge Engine provide documentation (DOC) records for all audit files
when the Engine starts processing them.
HOST ERROR: Databridge call failed for set_option NO REVERSALS, error number = number
Error Text: Host error text
The Client could not set the Databridge Engine parameter NO REVERSALS during the execution of a process
or clone
command.
HOST ERROR: Databridge call failed for sets, error number = number
Databridge was unable to retrieve information on sets. This message can occur when you run a switchaudit
command.
HOST ERROR: Databridge call failed for version, error number = number
The Client remote procedure call on the DBVERSION API failed. This message can occur at the start of any command that connects to the Databridge server.