SysVar

The qualifier SysVar can precede the name of each EGL system variable listed in the next table. These variables are useful for various purposes.

System variable Description
arrayIndex

Contains a number:

  • The number of the first element in an array that matches the search condition of a simple logical expression with an in operator.
  • Zero, if no array element matches the search condition.
  • The number of the last element modified in the target array after a move ... for count statement.
callConversionTable Contains the name of the conversion table that is used to convert data when your program does the following at run time:
  • Passes arguments in a call to a program on a remote system
  • Passes arguments when invoking a remote program by way of the system function sysLib.startTransaction
  • Accesses a file at a remote location
errorCode Receives a status code after any of the following events:
  • The invocation of a call statement, if that statement is in a try block
  • An I/O operation on an indexed, MQ, relative, or serial file
  • The invocation of almost any system function in these cases--
    • The invocation is within a try block; or
    • The program is running in VisualAge® Generator Compatibility mode and VGVar.handleSysLibraryErrors is set to 1
formConversionTable Contains the name of the conversion table that is used for bidirectional text conversion when an EGL-generated Java™ program acts as follows:
  • Shows a text or print form that includes a series of Hebrew or Arabic characters; or
  • Shows a text form that accepts a series of Hebrew or Arabic characters from a user.
overflowIndicator Is set to 1 when arithmetic overflow occurs. By checking the value of this variable, you can test for overflow conditions.
returnCode Contains an external return code, as set by your program and made available to the operating system.
sessionID Contains an ID that is specific to the Web application server session.
sqlca Contains the entire SQL communication area (SQLCA).
sqlcode Contains the return code for the most recently completed SQL I/O operation. The code is obtained from the SQL communications area (SQLCA) and can vary with the relational database manager.
sqlState Contains the SQL state value for the most recently completed SQL I/O operation. The code is obtained from the SQL communications area (SQLCA) and can vary with the relational database manager.
systemType Identifies the target system in which the program is running.
terminalID

Is initialized from the Java Virtual Machine system property user.name and is blank if the property cannot be retrieved.

transactionID As described in the topic transactionID.
transferName Allows you to specify, at run time, the name of the program or transaction to which you want to transfer.
userID Contains a user identifier in environments where one is available.

Related concepts
References to variables in EGL
Scoping rules and "this" in EGL

Related reference
System variables outside of EGL libraries

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.