sysLib.startTransaction

The system function sysLib.startTransaction 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.

The default behavior of this function is to start a program that resides in the same Java package. To change that behavior, specify an asynchLink element in the linkage options part that is used to generate the invoking program.

A Java program can transfer only to another Java program on the same machine.


sysLib.startTransaction syntax diagram

request

The name of a basic record, which must have the following format:

  • The first 2 bytes (of type SMALLINT or of type BIN without decimals) contain the length of the data to be passed to the started transaction, plus 10 for the two fields (including this one) that are not passed.

  • The next 8 bytes (of type CHAR) are also not passed, but contain the name of the program to be started.

  • The remaining part of the request record is passed.

prID

This 4-byte item is ignored if specified.

termID

This 4-byte item of type CHAR is ignored if specified. You must specify termID if you specify prID.

Related reference
asynchLink element
sysVar.errorCode
sysVar.printerAssociation
transfer