Package com.softwaremining.cics

Class PooledServicesFactory

java.lang.Object

com.softwaremining.cics.PooledServicesFactory

public class PooledServicesFactory
extends Object

this Factory class provides Instantiation of CICS programs using Transaction IDS or Program-Names. On termination of the program execution, the program instance will enter a pool of reusable objects.

Constructor Summary

Constructors

Constructor	Description
PooledServicesFactory()

Method Summary

Modifier and Type	Method	Description
static String	convertTransactionIdFullClassName(String transactionId)	For Internal Use only.
static String	convertTransactionIdFullClassName(String transactionId, boolean suppressExceptions)	For Internal Use only.
static BaseService	createService(String programCode, CicsBaseService owner, String sysId)	Translation of CICS LINK Statement - creates instance of a program based on 8 Character Program name or Transaction-ID.
static BaseService	createService(String programCode, CicsBaseService owner, String sysId, boolean synchOnReturn)	Translation of CICS LINK Statement - creates instance of a program based on 8 Character Program name or Transaction-ID.
static BaseService	createService(String programCode, ICicsBaseService owner)	Translation of CICS LINK Statement - creates instance of a program based on 8 Program name or Transaction-ID.
static BaseService	getService(String className, ICicsBaseService parent, SessionManager sessManager)	For internal use only
static String	getTransactionID(Class clazz)	Get Transaction id as defined in services.perperties file for the class
static String	getTransactionID(String className)
static int	getTwaSizeForTransactionId(String transactionId, boolean suppressExceptions)
static void	manualReleaseAllPooledServices()	for manual use
static void	releaseService(CicsBaseService baseService)	ReInitialie referenced variables/DAO, then store the class into the Pool.
static void	releaseService(CicsBaseService baseService, boolean doCommit)	ReInitialie referenced variables/DAO, then store the class into the Pool.
static void	releaseService(CicsBaseService baseService, boolean doCommit, boolean restoreInitialValues)	ReInitialie referenced variables/DAO, then store the class into the Pool.

Methods inherited from class java.lang.Object

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

Constructor Details

PooledServicesFactory

public PooledServicesFactory()

Method Details

getService

public static BaseService getService(String className,
 ICicsBaseService parent,
 SessionManager sessManager)

For internal use only

Parameters:

className -

parent -

Returns:

releaseService

public static void releaseService(CicsBaseService baseService)

ReInitialie referenced variables/DAO, then store the class into the Pool.

Parameters:

baseService -

releaseService

public static void releaseService(CicsBaseService baseService,
 boolean doCommit)

ReInitialie referenced variables/DAO, then store the class into the Pool.

Parameters:

baseService -

doCommit -

releaseService

public static void releaseService(CicsBaseService baseService,
 boolean doCommit,
 boolean restoreInitialValues)

ReInitialie referenced variables/DAO, then store the class into the Pool.

Parameters:

baseService -

doCommit -

restoreInitialValues -

getTransactionID

public static String getTransactionID(Class clazz)

Get Transaction id as defined in services.perperties file for the class

Parameters:

clazz -

Returns:

getTransactionID

public static String getTransactionID(String className)

convertTransactionIdFullClassName

public static String convertTransactionIdFullClassName(String transactionId)

For Internal Use only. convert TransactionId to FullClassName using the information in services.properties file

Parameters:

transactionId -

Returns:

convertTransactionIdFullClassName

public static String convertTransactionIdFullClassName(String transactionId,
 boolean suppressExceptions)

For Internal Use only. convert TransactionId to FullClassName using the information in services.properties file

Parameters:

transactionId -

Returns:

getTwaSizeForTransactionId

public static int getTwaSizeForTransactionId(String transactionId,
 boolean suppressExceptions)

createService

public static BaseService createService(String programCode,
 ICicsBaseService owner)

Translation of CICS LINK Statement - creates instance of a program based on 8 Program name or Transaction-ID. On Cics this must be defined in the Program Definitions (PD) as a local program.

Parameters:

programCode - - 8 Character Program-name

owner -

Returns:

createService

public static BaseService createService(String programCode,
 CicsBaseService owner,
 String sysId)

Translation of CICS LINK Statement - creates instance of a program based on 8 Character Program name or Transaction-ID. On Cics this must be defined in the Program Definitions (PD) as a local program.

Parameters:

programCode - - 8 Character name (transaction-id)

owner -

sysId - - Address of the remote system where the program resides

Returns:

createService

public static BaseService createService(String programCode,
 CicsBaseService owner,
 String sysId,
 boolean synchOnReturn)

Translation of CICS LINK Statement - creates instance of a program based on 8 Character Program name or Transaction-ID. On Cics this must be defined in the Program Definitions (PD) as a local program.

Parameters:

programCode - - 8 Character name (transaction-id)

owner -

sysId - - Address of the remote system where the program resides

synchOnReturn - - Indicates that the server program should perform a Syncpoit when it returns Control to the client program. If omitted (false), the sysnchpoint is taken when the client program ends

Returns:

manualReleaseAllPooledServices

public static void manualReleaseAllPooledServices()

for manual use