blackberry.com
BlackBerry Dynamics
Runtime library for iOS applications
from the application developer portal
Public Types | Public Member Functions | Static Public Member Functions | Protected Types | Properties

GDDiagnostic Class Reference

BlackBerry Dynamics diagnostic checks and information. More...

#import <GDDiagnostic.h>

List of all members.

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Properties


Detailed Description

This class contains a number of programming interfaces for running checks and retrieving information for diagnostic purposes.

Use the application programming interface (API) of this class if the application encounters an error that might involve the BlackBerry Dynamics infrastructure or configuration in some way. The API includes functions to:

The return values are generally structured text that is intended to be logged by the application and then made available to technical support staff. The structure and content aren't documented.


Member Function Documentation

+ (GDDiagnostic *) sharedInstance

This function returns a reference to the BlackBerry Dynamics diagnostic object, which is a "singleton class".

Returns:
Reference that can be used to call, for example, the currentSettings function.
- (NSInteger) checkApplicationServerReachability: (NSString *)  host
withPort: (NSInteger)  port
useSSL: (BOOL)  ssl
validateCertificate: (BOOL)  validateCertificate
withTimeOut: (NSTimeInterval)  timeOut
callbackBlock: (GDDiagnosticReachabilityResultsBlock block 

Call this function to check the reachability of an application server by BlackBerry Dynamics communication. The application server endpoint is specified as a host name and port number.

When this function is called, the BlackBerry Dynamics runtime will make a number of attempts to reach the specified server. One or more routes may be used, depending on enterprise configuration. For example, the runtime could attempt to connect through the BlackBerry Dynamics proxy infrastructure via an endpoint behind the enterprise firewall. The results of all attempts are returned in a single text string that can be logged by the application for diagnostic purposes.

This function is asynchronous. Results are returned by invocation of a code block.

Every call to this function is issued a unique request identifier. The identifier is returned synchronously, as the return value of this function, and asynchronously, with the results. The identifier can be used to match results with calls, in the case that the application initiates multiple concurrent reachability checks.

A time out can be specified. If it is, and checking hasn't completed when the time out expires, then the results up to that point are returned.

Parameters:
hostNSString containing the hostname of the server to check.
portNSInteger for the port number to check.
sslYES to check reachability using a Secure Socket Layer connection or Transport Layer Security (SSL/TLS).
NO to use a plain socket connection without SSL/TLS.
validateCertificateIf using SSL/TLS:
YES to require a valid certificate, and treat an invalid certificate as a connection error.
NO to switch off certificate checking.
If the ssl parameter is NO, this flag is ignored.
timeOutNSTimeInterval representing the time out, in seconds.
blockGDDiagnosticReachabilityResultsBlock for the results callback.
Returns:
NSInteger value that identifies this call.
- (NSArray*) checkManagementConsoleReachability: (NSTimeInterval)  timeOut
callbackBlock: (GDDiagnosticReachabilityResultsBlock block 

Call this function to check the reachability of the BlackBerry Dynamics management console. The management console is a service within every BlackBerry Dynamics deployment, with which the end user of the application is associated by BlackBerry Dynamics activation processing. The service can run on a single server, or on a cluster of servers operating as a node.

When this function is called, the BlackBerry Dynamics runtime will make a number of attempts to reach each of the servers that provide the management console service. One or more routes may be used for each server, depending on enterprise configuration. For example, the runtime could attempt to connect through the BlackBerry Dynamics proxy infrastructure via an endpoint behind the enterprise firewall. The results of all attempts are returned in a number of text strings, one for each server. The text strings can be logged by the application for diagnostic purposes.

This function is asynchronous. Results are returned by multiple invocations of a code block.

Every call to this function is issued an array of unique request identifiers. The array is returned synchronously, as the return value of this function. Individual values within the array are also returned asynchronously, with each of the results. The identifier can be used to match results with calls, in the case that the application initiates multiple concurrent reachability checks.

A time out can be specified. If it is, and checking hasn't completed when the time out expires, then the results up to that point are returned.

Parameters:
timeOutNSTimeInterval representing the time out, in seconds.
blockGDDiagnosticReachabilityResultsBlock for the results callback.
Returns:
NSArray of NSInteger containing identifier values.

Property Documentation

- (NSString*) currentSettings [read, assign]

A number of current application configuration settings, which can be logged by the application for diagnostic purposes.


The documentation for this class was generated from the following file: