ConnectionStartTimeString (System function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
(Automatically generated page update)
Line 8: Line 8:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%string</th><td>The returned value is the connection start time; it is a string in the format specified by the <var class="term">format</var> argument, if the thread is a TCP/IP server (for example, <var class="product">Janus Web Server</var>) thread, or the null string otherwise.</td></tr>
<tr><th>%string</th><td>The returned value is the connection start time; it is a string in the format specified by the <var class="term">format</var> argument, if the thread is a TCP/IP server (for example, <var class="product">Janus Web Server</var>) thread, or the null string otherwise.</td></tr>
<tr><th><var>%(System)</var></th>
<tr><th><var class="nobr">%(System)</var></th>
<td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods|shared]] method. <var>ConnectionStartTimeString</var> can also be invoked via a <var>System</var> object variable, which may be null.</td></tr>
<td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods|shared]] method. <var>ConnectionStartTimeString</var> can also be invoked via a <var>System</var> object variable, which may be null.</td></tr>
<tr><th>format</th>
<tr><th>format</th>

Revision as of 00:26, 16 February 2014

Time of connection start as string (System class)

[Introduced in Sirius Mods 7.8]


The purpose of this method is to help provide service time statistics for web requests.

Syntax

%string = %(System):ConnectionStartTimeString[( [format])] Throws InvalidDateString

Syntax terms

%stringThe returned value is the connection start time; it is a string in the format specified by the format argument, if the thread is a TCP/IP server (for example, Janus Web Server) thread, or the null string otherwise.
%(System) The class name in parentheses denotes a shared method. ConnectionStartTimeString can also be invoked via a System object variable, which may be null.
format A datetime format string. This is an optional argument; the default format is YYYYMMDDHHMISSXXX.

Usage notes

  • The connection time is as of the earliest detection of the connection. For a new connection, this means when the Janus TCP PST sees the first request for a connection.
  • To do your own service time calculations, you can do something like:

    %serviceTime = %(system):currentTimeMilliseconds - %(system):connectionStartTimeString

    A satisfactory result is not guaranteed if this code is run on a VTAM 3270 thread.

See also