Package dev.galasa.zosliberty

Interface IZosLibertyServerLog

public interface IZosLibertyServerLog

Method Summary

Modifier and Type	Method	Description
long	checkpoint()	Checkpoint this IZosLibertyServerLog
void	delete()	Delete the IZosUNIXFile if it exists
long	getCheckpoint()	Return the current checkpoint on this IZosLibertyServerLog
String	getName()	Returns the name of the specified log file
IZosUNIXFile	getZosUNIXFile()	Returns the IZosUNIXFile associated with this IZosLibertyServerLog
OutputStream	retrieve()	Returns the contents of a specified log
OutputStream	retrieveSinceCheckpoint()	Returns the contents of log since the last checkpoint
void	saveToResultsArchive(String rasPath)	Save the log to the Results Archive Store
String	searchForPattern(Pattern searchPattern)	Searches contents of log for specified search Pattern
String	searchForPattern(Pattern searchPattern, Pattern failPattern)	Searches contents of log for specified search or fail Pattern
String	searchForPatternSinceCheckpoint(Pattern searchPattern)	Searches contents of log for specified search Pattern since the last checkpoint
String	searchForPatternSinceCheckpoint(Pattern searchPattern, Pattern failPattern)	Searches contents of log for specified search or fail Pattern since the last checkpoint
String	searchForText(String searchText)	Searches contents of log for specified search text
String	searchForText(String searchText, String failText)	Searches contents of log for specified search or fail String
String	searchForTextSinceCheckpoint(String searchText)	Searches contents of log for specified search text String since the last checkpoint
String	searchForTextSinceCheckpoint(String searchText, String failText)	Searches contents of log for specified search or fail String since the last checkpoint
String	waitForPattern(Pattern searchPattern, long timeout)	Wait for a search Pattern to appear in specified log.
String	waitForPattern(Pattern searchPattern, Pattern failPattern, long timeout)	Wait for a search or fail Pattern or fail Pattern to appear in specified log.
String	waitForPatternSinceCheckpoint(Pattern searchPattern, long timeout)	Wait for a search Pattern to appear in specified log since the last checkpoint.
String	waitForPatternSinceCheckpoint(Pattern searchPattern, Pattern failPattern, long timeout)	Wait for a search or fail Pattern or fail Pattern to appear in specified log since the last checkpoint.
String	waitForText(String searchText, long timeout)	Wait for a search search String to appear in specified log.
String	waitForText(String searchText, String failText, long timeout)	Wait for a search String or fail text to appear in specified log.
String	waitForTextSinceCheckpoint(String searchText, long timeout)	Wait for a search String to appear in specified log since the last checkpoint.
String	waitForTextSinceCheckpoint(String searchText, String failText, long timeout)	Wait for a search or fail String to appear in specified log since the last checkpoint.

Method Details

getName

String getName()
        throws ZosLibertyServerException

Returns the name of the specified log file

Returns:

the file name

Throws:

ZosLibertyServerException

getZosUNIXFile

IZosUNIXFile getZosUNIXFile()
                     throws ZosLibertyServerException

Returns the IZosUNIXFile associated with this IZosLibertyServerLog

Returns:

Liberty server log file

Throws:

ZosLibertyServerException

retrieve

OutputStream retrieve()
               throws ZosLibertyServerException

Returns the contents of a specified log

Returns:

contents of log

Throws:

ZosLibertyServerException

delete

void delete()
     throws ZosLibertyServerException

Delete the IZosUNIXFile if it exists

Throws:

ZosLibertyServerException

saveToResultsArchive

void saveToResultsArchive(String rasPath)
                   throws ZosLibertyServerException

Save the log to the Results Archive Store

Parameters:

rasPath -

Throws:

ZosLibertyServerException

checkpoint

long checkpoint()
         throws ZosLibertyServerException

Checkpoint this IZosLibertyServerLog

Returns:

checkpoint

Throws:

ZosLibertyServerException

getCheckpoint

long getCheckpoint()

Return the current checkpoint on this IZosLibertyServerLog

Returns:

checkpoint

retrieveSinceCheckpoint

OutputStream retrieveSinceCheckpoint()
                              throws ZosLibertyServerException

Returns the contents of log since the last checkpoint

Returns:

contents of log

Throws:

ZosLibertyServerException

searchForText

String searchForText(String searchText)
              throws ZosLibertyServerException

Searches contents of log for specified search text

Parameters:

searchText - the text to search

Returns:

true if text found

Throws:

ZosLibertyServerException

searchForText

String searchForText(String searchText,
 String failText)
              throws ZosLibertyServerException

Searches contents of log for specified search or fail String

Parameters:

searchText - the text to search

Returns:

true if text found

Throws:

ZosLibertyServerException

searchForTextSinceCheckpoint

String searchForTextSinceCheckpoint(String searchText)
                             throws ZosLibertyServerException

Searches contents of log for specified search text String since the last checkpoint

Parameters:

searchText - the text to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

searchForTextSinceCheckpoint

String searchForTextSinceCheckpoint(String searchText,
 String failText)
                             throws ZosLibertyServerException

Searches contents of log for specified search or fail String since the last checkpoint

Parameters:

searchText - the text to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

searchForPattern

String searchForPattern(Pattern searchPattern)
                 throws ZosLibertyServerException

Searches contents of log for specified search Pattern

Parameters:

searchPattern - the Pattern to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

searchForPattern

String searchForPattern(Pattern searchPattern,
 Pattern failPattern)
                 throws ZosLibertyServerException

Searches contents of log for specified search or fail Pattern

Parameters:

searchPattern - the Pattern to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

searchForPatternSinceCheckpoint

String searchForPatternSinceCheckpoint(Pattern searchPattern)
                                throws ZosLibertyServerException

Searches contents of log for specified search Pattern since the last checkpoint

Parameters:

searchPattern - the Pattern to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

searchForPatternSinceCheckpoint

String searchForPatternSinceCheckpoint(Pattern searchPattern,
 Pattern failPattern)
                                throws ZosLibertyServerException

Searches contents of log for specified search or fail Pattern since the last checkpoint

Parameters:

searchPattern - the Pattern to search

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForText

String waitForText(String searchText,
 long timeout)
            throws ZosLibertyServerException

Wait for a search search String to appear in specified log. Will check every 3 seconds until one of:

• the searchText is found;
• the failText is found;
• the specified timeout is reached.

Parameters:

searchString - the text to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForText

String waitForText(String searchText,
 String failText,
 long timeout)
            throws ZosLibertyServerException

Wait for a search String or fail text to appear in specified log. Will check every 3 seconds until one of:

• the searchText is found;
• the failText is found;
• the specified timeout is reached.

Parameters:

searchString - the text to search

failString - the failure text to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForTextSinceCheckpoint

String waitForTextSinceCheckpoint(String searchText,
 long timeout)
                           throws ZosLibertyServerException

Wait for a search String to appear in specified log since the last checkpoint. Will check every 3 seconds until one of:

• the searchText is found;
• the failText is found;
• the specified timeout is reached.

Parameters:

searchText - the text to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForTextSinceCheckpoint

String waitForTextSinceCheckpoint(String searchText,
 String failText,
 long timeout)
                           throws ZosLibertyServerException

Wait for a search or fail String to appear in specified log since the last checkpoint. Will check every 3 seconds until one of:

• the searchText is found;
• the failText is found;
• the specified timeout is reached.

Parameters:

searchText - the text to search

failText - the failure text to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForPattern

String waitForPattern(Pattern searchPattern,
 long timeout)
               throws ZosLibertyServerException

Wait for a search Pattern to appear in specified log. Will check every 3 seconds until one of:

• the searchPattern is found;
• the failPattern is found;
• the specified timeout is reached.

Parameters:

searchPattern - the Pattern to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForPattern

String waitForPattern(Pattern searchPattern,
 Pattern failPattern,
 long timeout)
               throws ZosLibertyServerException

Wait for a search or fail Pattern or fail Pattern to appear in specified log. Will check every 3 seconds until one of:

• the searchPattern is found;
• the failPattern is found;
• the specified timeout is reached.

Parameters:

searchPattern - the Pattern to search

failPattern - the failure pattern to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForPatternSinceCheckpoint

String waitForPatternSinceCheckpoint(Pattern searchPattern,
 long timeout)
                              throws ZosLibertyServerException

Wait for a search Pattern to appear in specified log since the last checkpoint. Will check every 3 seconds until one of:

• the searchPattern is found;
• the failPattern is found;
• the specified timeout is reached.

Parameters:

searchPattern - the Pattern to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException

waitForPatternSinceCheckpoint

String waitForPatternSinceCheckpoint(Pattern searchPattern,
 Pattern failPattern,
 long timeout)
                              throws ZosLibertyServerException

Wait for a search or fail Pattern or fail Pattern to appear in specified log since the last checkpoint. Will check every 3 seconds until one of:

• the searchPattern is found;
• the failPattern is found;
• the specified timeout is reached.

Parameters:

searchPattern - the Pattern to search

failPattern - the failure pattern to search

timeout - timeout value in seconds

Returns:

the string found or null

Throws:

ZosLibertyServerException