ConnectionStartTimeString (System function): Difference between revisions
Jump to navigation
Jump to search
m (→Usage notes) |
No edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:System:ConnectionStartTimeString subtitle}} | {{Template:System:ConnectionStartTimeString subtitle}} | ||
The purpose of this method is to help provide service time statistics for web requests. | |||
==Syntax== | ==Syntax== | ||
| Line 6: | Line 7: | ||
<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> | ||
| Line 19: | Line 20: | ||
<p class="code">%serviceTime = %(system):currentTimeMilliseconds - %(system):connectionStartTimeString </p> | <p class="code">%serviceTime = %(system):currentTimeMilliseconds - %(system):connectionStartTimeString </p> | ||
A satisfactory result is not guaranteed if this code | A satisfactory result is not guaranteed if this code is run on a VTAM 3270 thread. | ||
</ul> | </ul> | ||
Latest revision as of 19:05, 3 September 2015
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
| %string | The 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.