sirius.biz.i5

Class I5Connection

java.lang.Object

sirius.biz.i5.I5Connection

public class I5Connection
extends Object

Represents a connection to an IBM AS400 also known as i5.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	borrowed
protected com.ibm.as400.access.AS400	i5
protected String	lastJob
protected long	lastUse
protected sirius.biz.i5.I5ConnectionPool	pool

Constructor Summary

Constructors

Constructor and Description
I5Connection()

Method Summary

Modifier and Type	Method and Description
void	call(String pgm, com.ibm.as400.access.ProgramParameter... params) Calls a program on the i5.
boolean	check() Checks if the connection is still healthy.
void	close() Closes the connection by returning it back to the connection pool.
String	getLastJob() The id of the last job executed on the host
String	getLastUse() Returns the timestamp of the last usage of this connection.
void	initialize() Initializes the connection and verifies the installed version of OS400.
boolean	isBorrowed() Determines if the connection is currently borrowed or not.
List<com.ibm.as400.access.DataQueueEntry>	readQueue(String queue, int timeoutSeconds) Reads all entries available in the given queue.
void	release() Releases / closes the connection.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

i5

protected com.ibm.as400.access.AS400 i5

pool

protected sirius.biz.i5.I5ConnectionPool pool

borrowed

protected boolean borrowed

lastUse

protected long lastUse

lastJob

protected String lastJob

Constructor Detail

I5Connection

public I5Connection()

Method Detail

release

public void release()

Releases / closes the connection.

initialize

public void initialize()

Initializes the connection and verifies the installed version of OS400.

check

public boolean check()

Checks if the connection is still healthy.

Returns:

true if the connection is still healthy, false otherwise.

close

public void close()

Closes the connection by returning it back to the connection pool.

call

public void call(String pgm,
                 com.ibm.as400.access.ProgramParameter... params)

Calls a program on the i5.

Parameters:

pgm - the name of the program to call

params - the parameters to pass

readQueue

@Nonnull
public List<com.ibm.as400.access.DataQueueEntry> readQueue(String queue,
                                                                    int timeoutSeconds)
                                                             throws Exception

Reads all entries available in the given queue.

Parameters:

queue - the name of the queue to read

timeoutSeconds - the max timeout to wait for entries

Returns:

the list of entries read

Throws:

Exception - in case of a communication or host error

getLastUse

public String getLastUse()

Returns the timestamp of the last usage of this connection.

Returns:

the last time the connection was used as formatted timestamp

getLastJob

public String getLastJob()

The id of the last job executed on the host

Returns:

the id of the last job

isBorrowed

public boolean isBorrowed()

Determines if the connection is currently borrowed or not.

Returns:

true if the connection is currently in use, false if it is idle in a connection pool

toString

public String toString()

Overrides:

toString in class Object