com.ibm.etools.iseries.rse.ui.resources
Class QSYSLibraryUtility

java.lang.Object
  com.ibm.etools.iseries.rse.ui.resources.QSYSLibraryUtility

public class QSYSLibraryUtility
extends Object

Field Summary

static String

copyright

Constructor Summary

QSYSLibraryUtility()

Method Summary

static IQSYSLibrary	createLibrary(Shell shell, IBMiConnection connection, String libName, String libType, String libText, String libAut, String libCrtAut, String libAddlParms) Static helper method to create a new library
static IQSYSLibrary	getRSETempLibrary(Shell shell, IBMiConnection connection, String libName, String msgId) Static helper method to create, if necessary, the RSE temporary library.

Methods inherited from class java.lang.Object

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

Field Detail

copyright

public static String copyright

Constructor Detail

QSYSLibraryUtility

public QSYSLibraryUtility()

Method Detail

getRSETempLibrary

public static IQSYSLibrary getRSETempLibrary(Shell shell,
                                             IBMiConnection connection,
                                             String libName,
                                             String msgId)
                                      throws SystemMessageException

Static helper method to create, if necessary, the RSE temporary library. Since the RSE can't use QTEMP due to toolbox restrictions, whenever a temporary library is needed we try to use the same one: QRSETEMP.
This method will test for the existance of this library, and if not found, will create prompt the user to create it, and if agreed to will run the CRTLIB command for it, and also change the object owner to be QSYS. The library attribute is set to *TEST

Parameters:

shell - - the shell to host any prompts or message dialogs

connection - - the ISeries connection object to use to create the library

libName - - the name for the new library. Pass null for the default name of QRSETEMP

msgId - - the id of the message to use to ask the user if they want to create the library. Pass null to use our default message or *NONE for no message, else the message is assumed to have one substitution variable, which is the name of the library.

Returns:

the QRSETEMP library handle if it exists or was created via this call, or null if the user chose not to create it, or something went wrong.

Throws:

SystemMessageException

createLibrary

public static IQSYSLibrary createLibrary(Shell shell,
                                         IBMiConnection connection,
                                         String libName,
                                         String libType,
                                         String libText,
                                         String libAut,
                                         String libCrtAut,
                                         String libAddlParms)
                                  throws SystemMessageException

Static helper method to create a new library

Parameters:

shell - - the shell to host any prompts or message dialogs

connection - - the iSeries connection object to use to create the library

libName - - the name of the library to create

libType - - "*PROD" or "*TEST".

libText - - optional text description for the new library. We will add single quote delimiters

libAut - - optional value for the AUT parameter. Eg, "*ALL"

libCrtAut - - optional value for the CRTAUT parameter. Eg, "*ALL"

libAddlParms - - any additional fully-formed parameters to tack onto the end of the CRTLIB command

Throws:

SystemMessageException