• Empty string ("") if there is no lock or if the data file used is not a HFSQL Client/Server data file.
• Information about the lock. This information is separated by TAB characters and it has the following format:
  
  <Physical name of the data file relative to the database> + TAB +
  <Record number> + TAB +
  <User> + TAB + <Name of client computer> + TAB +
  <IP address of client computer> + TAB + <Name of client application> + TAB +
  <Type of lock> + TAB + <Date of lock implementation> + TAB +
  <Number of seconds since start of lock> + CR
  • <Record number> is set to -1 if the lock was set on the data file.
  • The <Type of lock> parameter can correspond to:
    • W: Lock in write mode.
    • RW: Lock in read/write.
    • W-T: Lock in write mode set by a transaction.
    • RW-T: Lock in read/write set by a transaction.
  • <Start date of lock> has the following format: YYYYMMDDHHMMSS. This date is in UTC format (Universal Time Coordinated).

Name of data file used.
If this parameter corresponds to an empty string (""), HInfoLock handles the last data file used by the last HFSQL management function (function starting with "H").

Number of the record for which the lock information is requested.
If this parameter is not specified, HInfoLock lists all the locks of the data file.

Information about the lock. This information is separated by TAB characters and it has the following format:

<Physical name of file relative to the database> + TAB + <Record number> +
TAB + <User> + TAB + <Name of client computer> + TAB +
<IP address of client computer> + TAB + <Name of client application> +
TAB + <Type of lock> + TAB + <Start date of lock> + TAB +
<Nb of seconds since start of lock> + CR

• <Record number> is set to -1 if the lock was set on the data file.
• The <Type of lock> parameter can correspond to:
  • W: Lock in write mode.
  • W-T: Lock in write mode set by a transaction.
  • RW: Lock in read/write.
  • RW-T: Lock in read/write set by a transaction.
• <Start date of lock> has the following format: YYYYMMDDHHMMSS.

Connection for which the lock information is requested. This connection corresponds to:

• the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
• the name of a Connection variable.

If this parameter does not correspond to a connection name, HInfoLock considers that this parameter corresponds to the name of a data file.

Full path of the data file, relative to the database defined by <Connection name>.
This parameter is ignored if <Connection name> corresponds to the logical name of a data file.
If this parameter is not specified, all the locks set on all the data files of the database are returned.

Number of the record for which the lock information is requested.
If this parameter is not specified, HInfoLock lists all the locks of the data file.