Launch parameters
The following parameters are valid when launching a view from an external browser:
Parameter name | Details |
|---|---|
type | The type path (physical or logical) for the view. A valid launch request must specify one and only one of the following options: a) the type and inst parameters (both must be used together), b) the profile and model parameters (both must be used together), or c) the oid parameter. |
inst | The instance path (physical or logical) associated with the specified type path. A valid launch request must specify one and only one of the following options: a) the type and inst parameters (both must be used together), b) the profile and model parameters (both must be used together), or c) the oid parameter. |
profile | The name of the BTM profile that contains a generated model instance whose view is being launched. A valid launch request must specify one and only one of the following options: a) the type and inst parameters (both must be used together), b) the profile and model parameters (both must be used together), or c) the oid parameter. |
model | The name of the generated model instance within the specified profile. A valid launch request must specify one and only one of the following options: a) the type and inst parameters (both must be used together), b) the profile and model parameters (both must be used together), or c) the oid parameter. |
oid | Comma separated type, high identifier, and low identifier of the physical or logical type. For example: 40,1,1 A valid launch request must specify one and only one of the following options: a) the type and inst parameters (both must be used together), b) the profile and model parameters (both must be used together), or c) the oid parameter. |
user | The user name to use when running the TMTM Monitor Console; this is optional. If the user is already logged in on the specified host, that session is used. If the user is not currently logged in, or this parameter is not used, a login dialog box is displayed allowing for normal login. |
tab | The name of the tab on the view to be displayed; if not specified, the first tab is used. |
close | If specified, the external browser window is closed after the TMTM Monitor Console view is launched. This parameter has no associated value. |
begin-time | The begin date/time of a history query. This must be specified in the medium formata for the current locale. Valid only if launching to the BTM History View tab of a view for a BTM generated model. A valid history request must either specify the begin-time and end-time parameters, or the id parameter, but not both. The begin-time and end-time parameters must be used together. |
end-time | The end date/time of a history query. This must be specified in the medium formatb for the current locale. Valid only if launching to the BTM History View tab of a view for a BTM generated model. A valid history request must either specify the begin-time and end-time parameters, or the id parameter, but not both. The begin-time and end-time parameters must be used together. |
query-type | Specifies how to use the begin and end times in a history query (defaults to min if not specified):
|
id | A transaction or alias prefix. This matches all transactions that begin with the specified id prefix. Valid only if launching to the BTM History View tab of a view for a BTM generated model. A valid history request must either specify the begin-time and end-time parameters, or the id parameter, but not both. The begin-time and end-time parameters must be used together. |
result-set | Specifies the number of transaction to return in the query result. Valid only if launching to the BTM History View tab of a view for a BTM generated model. |
- When the locale of the Application Service machine is English, medium format dates take the form of "Feb 3, 2011, 1:38:22 PM".
- When the locale of the Application Service machine is English, medium format dates take the form of "Feb 3, 2011, 1:38:22 PM".
This URL displays the first tab of the network host view "myhost":
*http://myhost:15007/launch/view?user=myuser&type=ComMQSoftwareNetworkHost&inst=myhost*
This URL displays the "Queue Depth" tab of the view corresponding to the Oid with type 304, high identifier of 1, and low identifier of 0. After displaying the view, the browser in which the URL was specified is closed:
http://myhost:15007/launch/view?user=myuser&oid=304,1,0&tab=Queue Depth&close
This query displays the results of a BTM history query, showing transactions with a transaction ID that begin with "3632_1326225":
http://myhost:15007/launch/view?user=myuser&oid=50,1,1&tab=BTM History View&id=3632_1326225
This query displays the results of a BTM history query, showing the first 10 transactions in which both the minimum and maximum times fall between the specified begin and end times:
http://myhost:15007/launch/view?user=myuser&type=profileLogical!Prf167840303-925911888Mod167840303-925911872&inst=Profile0!Model0 Generated 01/10/2012 02:03:13&tab=BTM History View&begin-time=Jan 10, 2012 2:00:00 PM&end-time=Jan 10, 2012 2:30:00 PM&query-type=both&result-set=10
This query uses the profile and model parameters to perform a BTM history query, using the 5th generated model instance of Model0 within the profile Profile0:
http:// myhost:15007/launch/view?user= myuser &profile=Profile0&model=Model0_5&tab=BTM History View&begin-time=Jan 27, 2012 3:00:00 PM&end-time=Jan 27, 2012 4:00:00 PM
Comments
Log in or register to comment.