EGL library SysLib

The EGL library SysLib contains a number of functions and a single variable.

Function Description
beginDatabaseTransaction([database]) Begins a relational-database transaction, but only when the EGL runtime is not committing changes automatically.
result = bytes(field) Returns the number of bytes in a named area of memory.
calculateChkDigitMod10 (text, checkLength, result) Places a modulus-10 check digit in a character item that begins with a series of integers.
calculateChkDigitMod11 (text, checkLength, result) Places a modulus-11 check digit in a character item that begins with a series of integers.
callCmd (commandString[, modeString]) Runs a system command and waits until the command finishes.
commit() Saves updates that were made to databases, MQSeries® message queues, and CICS® recoverable files since the last commit. A generated Java™ program or wrapper also saves the updates done by a remote, CICS-based COBOL program (including updates to CICS recoverable files), but only when the call to the remote COBOL program involves a client-controlled unit of work, as described in luwControl in callLink element.
result = conditionAsInt (booleanExpression) Accepts a logical expression (like myVar == 6) , returning a 1 if the expression is true, a 0 if the expression is false.
connect (database, userID, password[, commitScope[, disconnectOption[, isolationLevel[, commitControl]]]]) Closes all cursors, releases locks, ends any existing connection, and connects to the database.
convert (target, direction, conversionTable) Converts data between EBCDIC (host) and ASCII (workstation) formats or performs code-page conversion within a single format.
defineDatabaseAlias (alias, database) Creates an alias that can be used to establish a new connection to a database to which your code is already connected.
disconnect ([database]) Disconnects from the specified database or (if no database is specified) from the current database.
disconnectAll () Disconnects from all the currently connected databases.
errorLog () Copies text into the error log that was started by the system function SysLib.startLog.
result = getCmdLineArg (index) Returns the specified argument from the list of arguments with which the EGL program was involved. The specified argument is returned as a string value.
result = getCmdLineArgCount () Returns the number of arguments that were used to start the main EGL program.
result = getMessage (key [, insertArray]) Returns a message from the file that is referenced in the Java runtime property vgj.message.file.
result = getProperty(propertyName) Retrieves the value of a Java runtime property. If the specified property is not found, the function returns a null string ("").
loadTable (filename, insertintoClause[, delimiter]) Loads data from a file into a relational database.
result = maximumSize (arrayName) Returns the maximum number of rows that can be in a dynamic array of data items or records; specifically, the function returns the value of the array property maxSize.
queryCurrentDatabase (product, release) Returns the product and release number of the currently connected database.
rollback () Reverses updates that were made to databases and MQSeries message queues since the last commit. That reversal occurs in any EGL-generated application.
setCurrentDatabase (database) Makes the specified database the currently active one.
setError (itemInError, msgKey{, itemInsert})

setError (this, msgKey{, itemInsert})

setError (msgText)

Associates a message with an item in a PageHandler or UI record or with the PageHandler or UI record as a whole. The message is placed at the location of a JSF message or messages tag in the JSP and is displayed when the related Web page is displayed.
setLocale (languageCode, countryCode[, variant]) Used in PageHandlers and in programs that run in a Web application.
setRemoteUser (userID, passWord) Sets the userid and password that are used on calls to remote programs from Java programs.
result = size (arrayName) Returns the number of rows in the specified data table or the number of elements in the specified array. The array may be a structure-item array, a static array of data items or records, or a dynamic array of data items or records.
startCmd (commandString[, modeString]) Runs a system command and does not wait until the command finishes.
startLog (logFile) Opens an error log. Text is written into that log every time your program invokes SysLib.errorLog.
startTransaction (termID[, prID[, termID]]) Invokes a main program asynchronously, associates that program with a printer or terminal device, and passes a record. If the receiving program is generated by EGL, the record is used to initialize the input record; if the receiver is produced by VisualAge® Generator, the record is used to initialize the working storage.
unloadTable (filename, selectStatement[, delimiter]) Unloads data from a relational database into a file.
verifyChkDigitMod10 (input, checkLength, result) Verifies a modulus-10 check digit in a character item that begins with a series of integers.
verifyChkDigitMod11 (input, checkLength, result) Verifies a modulus-11 check digit in a character item that begins with a series of integers.
wait (timeInSeconds0 Suspends execution for the specified number of seconds.
writeStderr() (textString0 Writes the text string to stderr (Java) or to the COBOL output device.
writeStdout() (textString0 Writes the text string to stdout (Java) or to the COBOL output device.
Variable Description
currentException A dictionary that identifies the exception that was thrown most recently in the run unit.
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.