LOG COMMENT [ ALLBASE/SQL Reference Manual ] MPE/iX 5.5 Documentation
ALLBASE/SQL Reference Manual
LOG COMMENT
The LOG COMMENT statement permits the entry of comments into the
ALLBASE/SQL DBELog file. These comments can be extracted using the Audit
Tool.
Scope
ISQL or Application Programs
SQL Syntax
{'String' }
{:HostVariable }
LOG COMMENT {:ProcedureParameter }
{:ProcedureLocalVariable}
{? }
Parameters
String specifies the comment as a constant character
string (up to 3996 bytes)[REV BEG]
HostVariable specifies the comment to be logged as a host
variable. No indicator may be specified. The
data type of the host variable must be CHAR or
VARCHAR. If the value is null, an error is
returned and no comment is logged.
ProcedureParameter or specifies the comment to be logged as a procedure
ProcedureLocalVariable parameter or local variable. If the value is
null, an error is returned and no comment is
logged. The data type must be CHAR or VARCHAR.
? specifies the comment to be logged as a dynamic
parameter. The data type is assumed to be
VARCHAR(3996). If the value is null, an error is
returned and no comment is logged.
Description
* The maximum length of a comment is 3996 bytes.
* A comment can use the DBEnvironment language or the native
language.
* An error is returned if LOG COMMENT is used and audit logging is
not enabled with the COMMENT audit element or the COMMENT
PARTITION is NONE.
[REV END]
Authorization
Any user can issue this statement from within a database session.
Example
Generate a comment audit log record.
LOG COMMENT 'Select From Table PurchDB.Parts';
SELECT PartNo FROM PurchDB.Parts WHERE PartNo='1234';
MPE/iX 5.5 Documentation