Server/Daemon Messages

The messages in this section are written to the Client service log file, which is located in the logs directory in the global working directory.

Closing [{CNS | IPC}] Session dd, socket = nnn

This message indicates that the corresponding Console or IPC socket is being closed. IPC sockets are used to pass messages between spawned client runs (DBClient or DBClntCfgServer) and the service/daemon (DBClntControl)

CNS Session dd, socket = nnn initialization complete

This message indicates that a console session has successfully been initialized. After the signon RPC is received and validated, the following message appears ("CNS Session nn,...signon complete").

CNS Session nn, userid = userid, role = role, signon complete

This message indicates that a Console session has successfully signed on the service. The supplied userid and role are listed in the log file for reference.

Configuration information read from binary file "dbcontrol.cfg"

This message, which is logged when the configuration parameter debug is set to True, confirms that the service has successfully read the binary configuration file.

CreateProcess: cd = "workingdir"

(Windows only) This message is logged when the configuration parameter debug is set to True. It shows the working directory used by a spawned run.

CreateProcess: cmdline = "cmdline"

(Windows only) This message is logged when the configuration parameter debug is set to True. It shows the command line for a spawned run.

CreateProcess: module = "filename"

(Windows only) This message is logged when the configuration parameter debug is set to True. It shows the program file used to spawn a run.

Current activity: nnn console sessions, mmm ipc sessions

This message shows the number of active sessions for Consoles and spawned runs. Each run uses one IPC connection.

Daemon Log File switched to "filename" (reason)

This message indicates that the log file was switched to the specified file for the provided reason, which can include Operator Keyin, Max File Size, or Date Change.

Data Source name disabled (client exit_code = nnnn)

This message indicates that the service disabled a data source after an unrecoverable error (Client abend) to prevent any further Client runs until the problem is resolved. After the problem is resolved, you must enable the data source from the Client Console.

Data Source name disabled because the client crashed

If the service detects a Client crash, it displays this message and disables the data source. After the problem is resolved, you must enable the data source from the Client Console.

Data Source name disabled by the console operator

This message indicates that the data source was disabled by the operator.

DATABridge Client Control Program Version version

This message identifies the version of the code. It is logged when the program starts.

DBClntControl automatically launching a {generate | redefine} command for data source name

This message is logged when the auto_redefine or auto_generate options are enabled for a data source. It indicates that the service has launched a DBClntCfgServer run to perform the specified command. These options are designed to automate the handling of simple DMSII reorganizations without interrupting production.

DBClntControl shutting down; listen socket closed

This message is logged when the service shuts down and its associated socket closes.

Deleting working directory tree for data source name

This message is logged when a request is received from the Console to remove a data source and its directories.

End_of_run: data_source = name, process_id = nnnn, exit_code = dddd

This message is logged when a launched client notifies the service that a run is terminating. To determine which type of run it is, you must find the corresponding “Start_of_run: … ” message.

IPC Session dd, socket = nnn initialization complete

This message indicates that a launched run has initialized its IPC session.

Log file switched to "filename" (reason)

This message is logged when the log file is about to be switched. It contains the new filename and the reason for the switch, which include Operator Keyin, Max File Size, and Date Change.

Manager for data_source name timed out -- stopping DBClntCfgServer

When the Console connects to the service, it requests information about the data source the service does not have. The service launches DBClntCfgServer to run a manage command, which allows the service to indirectly get access to the database. To avoid tying up resources, such runs are brief in duration and terminate after a minute of inactivity.

Non-standard data source working directory for srcname, files not deleted

This message is logged when processing a request from the Console to remove a data source's working directory. ies. If it is not a subdirectory of the service’s working directory, it is not removed and this message is logged. This prevents the deletion of a directory that has been moved to a different location for safekeeping purposes. We recommend that you always use the directory structure imposed by the service.

Notify received for data source src, afn = afn from ip_address = ipaddr

This message is logged when the notify thread receives a request from the NOTIFY program on the mainframe. The message typically contains a data source name and an audit file number. The service will then launch a process command for the specified data source unless one is already running. If the run is launched, the AFN is passed to it via the /F command-line option. If a process command is running, it is sent a console request to stop after the specified AFN.

RC_rpc_name

This message, which is logged when the debug option is enabled, identifies the RPC being executed. This is intended to be used in conjunction with a service trace.

Removing data source name

In some cases, the removal of a data source and its directories must be deferred until the spawned DBClntCfgServer run terminates. In those cases, this message appears when the process of removing the data source begins.

Service Log File switched to "filename" (reason)

This message indicates that the log file was switched to the specified file for one of the following reasons: Operator Keyin; Max File Size; Date change.

Session dd (sesstype), socket nnn, capabilities = nn

This message, which is logged when the debug option is enabled, shows information about Console sessions and sessions whose origins have not been determined. This message is logged every time the “Current activity: nnn console sessions, mmm ipc sessions” message is logged and is intended to help debug sessions that hang.

Session dd (sesstype), socket nnn, capabilities = nn, source = name, op = options, mgr_timeout = 0xhhhhhhhh

This message, which is only logged when the debug option is enabled, is intended to display information about IPC sessions. It is logged every time the “Current activity: nnn console sessions, mmm ipc sessions” message is logged. It was added to help debug hung sessions.

Start_of_run: data_source = name, process_id = dddd, command = name, originator = who[(sched_type)]

This message is logged whenever the service launches a client run for a data source. The command is named client command, which translates to process or clone for DBClient and manage, configure, verifysource, redefine or generate for DBClntCfgServer.

The launched run is can be initiated by any of the following: scheduler, select, console, config, verify, auto-redefine or auto-generate. If the run is started by scheduler, the sched_type value defines the type of scheduling used for the client run. Possible values for sched_type include: daily, fixed delay, err_retry or startup.

Starting [scheduled] process command for data source name

This message is logged when the service launches a process command as a result of scheduling or the receipt of a request by the notify thread. The word “scheduled” is omitted when the action is caused by a notify request.

Starting Session dd, socket = nnn, IP address = ipaddr

This message is logged when a connect request is successfully handled. These requests include Console and Client Configurator connections and IPC connections from spawned runs.

Starting verifysource command for data source name

When the service adds a data source, it launches DBClntCfgServer to execute a verifysource command. This command determines whether the database and server access parameters are valid. If they are invalid, the Console operator must correct them.