Rational Developer for Power Systems Software
V7.6

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

java.lang.Object
  extended by 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

Rational Developer for Power Systems Software
V7.6

Copyright 2011 IBM Corp. All Rights Reserved.

Note: This documentation is for part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.