ConnectionStartTimeString (System function)

From m204wiki
Revision as of 23:37, 25 June 2012 by JAL2 (talk | contribs)
Jump to navigation Jump to search

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