edmiRemoteTraceServer

EdmiError edmiRemoteTraceServer (SdaiServerContext       serverContextId,
                                  SdaiString              password,
                                  SdaiInteger             traceFunction,
                                  SdaiInteger             appServerClientId,
                                  SdaiInteger             options,
                                  SdaiInteger             maxTraceFileSize,
                                  SdaiString              traceFile,
                                  SdaiString              localFile,
                                  SdaiString             *hosts,
                                  SdaiString             *groups,
                                  SdaiString             *users,
                                  SdaiString             *cmd_code,
                                  SdaiInteger            *clientId);

Operates the EDMinterface server trace facilities from a thin EDMclient. The EDMinterface server trace facilities is a powerful trace mechanism to assist EDMServer system administrators in a trouble shooting process, either by analyzing the trace output themselves, or by forwarding the trace to EPM support.
Several options for tracing may be specified. The resulting trace output will be in plain ASCII.
Running with the EDMinterface server trace active will normally reduce the performance of EDMinterface operations considerably. Users are therefore adviced to operate the system without tracing under normal conditions. The trace should be switched on, only in trouble shooting sessions. Currently there is no run-time option for tracing a single application server process. However, this feature is obtainable but requires a full remake the EDMserver.

Arguments

Type	Name	Comment
SdaiServerContext	serverContextId	Context identification, from edmiDefineServerContext
SdaiString	password	The password of the superuser. If the superuser is the specified calling user in the server context, then this password argument may be omitted. This command will be available for any user when the database is closed or when no thick EDMclients are connected to the EDMserver
SdaiInteger	traceFunction	The EDMinterface_ server trace operation to perform. Available operations are: DEFINE_TRACE: Define EDMinterface server trace conditions. START_TRACE: Start EDMinterface server trace with the defined trace conditions STOP_TRACE: Stop EDMinterface server trace. CLOSE_TRACE: Stop EDMinterface trace and close the EDMinterface server trace file, if open. GET_SRV_TRACE_FILE: Read the server trace file(s) from the server and put them in the <localFile(s)>.
SdaiInteger	appServerClientId	The clientId of the EDMapplicationServer process to trace. At the moment there is no run-time option for tracing a single application server process. However, this feature is obtainable but requires a full remake the EDMserver. When this parameter is set zero, the EDMServer will be traced. The clientIds of the EDMapplicationServer processes may be obtained by the EDMSupervisor_ commands Aux->WhoIsOn or RemoteSystems->Aux->WhoIsOn. This parameter is only applicable in combination with the DEFINE_TRACE function.
SdaiInteger	options	See description of available options below. Options may be joined by using the bitwise OR operator
SdaiInteger	maxTraceFileSize	The maximum number of bytes in the <traceFile>. When this threshold value is exceeded, the trace file will be chopped. A zero value will disable the trace file chopping feature. Only a single trace file will be generated. When chopping a trace file, the first chop will be named <tracefile>. Any subsequent chops will be named TF_<no>_<tracefile>, where <no> is an increasing sequence number. This parameter is only applicable in combination with the DEFINE_TRACE function.
SdaiString	traceFile	Name of the EDMinterface server trace file. This parameter is only applicable in combination with the DEFINE_TRACE function.
SdaiString	localFile	The name of the file on the local file system to copy the server trace file(s) to. In case of multiple trace file chops, all files may be obtained by using the ALL_CHOPPED_FILES option. This parameter is only applicable in combination with the GET_SRV_TRACE_FILE function.
SdaiString	hosts	Currently not used.
SdaiString	groups	Currently not used.
SdaiString	users	Currently not used.
SdaiString	cmd_code	Currently not used.
SdaiInteger	clientId	Currently not used.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options

Option	Comment
SRV_TRACE_CMD	Trace the command messages sent from the client to the server.
SRV_TRACE_REPLY	Trace the reply messages sent back from the server.
SRV_TRACE_HEADER	Trace the command and reply headers
SRV_TRACE_BODY	Trace the command and reply bodies
SRV_TRACE_TO_STDOUT	Send the trace output to the terminal window in which the EDMserver was started.
SRV_TRACE_TO_FILE	Send the trace output to a file on the remote file system.
SRV_TRACE_ERRORS	Trace any erroneous client server communication
SRV_TRACE_VERBOSE	Trace events such as getting and releasing semaphores etc.
SRV_TRACE_TIME	Trace the time elapsed for execution of commands by the EDMserver.
SRV_TRACE_FLUSH_ON	Flush the server trace after each printout. This ensures that all the trace information will be available even in case of unforeseen events like a server crash.
SRV_TRACE_FULL	All options
SRV_TRACE_BRIEF	Only the clientId, the sequence number and the command and reply names will be traced. Example output: #3 [53] CMD: Cmd_WhoIsOnServer #3 [53] REPLY: R_WhoIsOnServer #3 REPLY: completed.
SRV_TRACE_STDOUT_BRIEF	Same as for SRV_TRACE_BRIEF, but the trace will not be written to a trace file.
SRV_TRACE_ALL_SERVERS	Trace the main server as well as all connected EDMapplicationServer processes.
SRV_TRACE_ALL_CHOPPED_FILES	Read the specified trace file and all its chops from the server to the local file system. This option is only applicable in combination with the GET_SRV_TRACE_FILE function.

Example

  
 /* Convert a model with brief
 tracing to a single trace file */ 
 EdmiError rstat;
 SdaiServerContext myContext;
 SdaiInteger nErr, nWrn, userStatus;
 SdaiOptions options;
  
 /* Define Remote Server Context */
 rstat = edmiDefineServerContext("MyRemoteServerContext",
 "Johnny", "Supervisor", "cf37ftr", 
 "TCP", "9090", "MyServerHost", 
 NULL, NULL, NULL, NULL, NULL, &myContext); 
  
 /* Define the tracing */
 options = SRV_TRACE_BRIEF;
 options |= SRV_TRACE_TO_FILE;
 options |= SRV_TRACE_ALL_SERVERS;
 rstat = edmiRemoteTraceServer(myContext, "xf667cx", DEFINE_TRACE,
 0, options, 0, "myTrace.trc", NULL, NULL,  
 NULL, NULL, NULL, NULL); 
  
 /* Start tracing */
 rstat = edmiRemoteTraceServer(myContext, "xf667cx", START_TRACE,
 0, 0, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL); 
  
 /* Convert a model */
 rstat = edmiRemoteConvertModels(myContext, "DataRepository.MYMODEL_V1",
 "MYSCHEMA_V1_TO_V2", "DataRepository.MYMODEL_V2", 
 NULL, NULL, "c:/temp/myschema_v1_to_v2.dia", 104857600, 
 "c:/temp/myschema_v1_to_v2.out", 0, NULL, 
 FULL_LOG | LOG_TO_FILE, &userStatus, &nWrn, &nErr, NULL, 2, 
 sdaiBOOLEAN, sdaiTRUE, sdaiINTEGER, 128); 
  
 /* Stop tracing */
 rstat = edmiRemoteTraceServer(myContext, "xf667cx", STOP_TRACE,
 0, 0, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL); 
  
 /* Terminate tracing */
 rstat = edmiRemoteTraceServer(myContext, "xf667cx", CLOSE_TRACE,
 0, 0, 0, "myTrace.trc", NULL, NULL, NULL,  
 NULL, NULL, NULL); 
  
 /* Read the trace file from the
 remote to the local file system */ 
 rstat = edmiRemoteTraceServer(myContext, "xf667cx", GET_SRV_TRACE_FILE,
 0, 0, 0, "myTrace.trc", "c:/tmp/myTrace.trc",  
 NULL, NULL, NULL, NULL, NULL); 
 . . .

EDMsix

edmiRemoteTraceServer

Arguments

Return Value

Options

Example

See also

Filter by label