Determining the Outcome of a Process
The select statistics command is used to examine Process statistics from the Connect:Direct® statistics file. The type of information in the statistics report includes copy status and execution events.
The search criteria provide flexibility in selecting information you want to display. The parameters used with the select statistics command determine search criteria and the form in which the information is presented. You can specify records to select by condition code, Process name, Process number, identification type, category, secondary node, start time, stop time, and submitter node specification and user ID.
There are no required parameters for this command. If you do not indicate a search requirement with an optional parameter, Connect:Direct selects all statistics records; however, the volume of records can be excessive. Following are parameters for the select statistics command:
Parameter | Description | Value | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ccode | Selects statistics records based on the completion code operator and return code values associated with Step Termination. You must specify the return code. | operator, nn operator—Specifies the completion code operator. Following are the valid completion code operators: eq or = or == (equal) This is the default. ge or >= or => (greater than or equal) gt or > (greater than) le or <= or =< (less than or equal) lt or < (less than) ne or != (not equal) The return code is the exit status of the UNIX command or the Connect:Direct Process or command. nn—Specifies the return code value associated with Step Termination. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
destfile | Selects statistics based on a destination file name. This parameter can be abbreviated as dest. | dest=/path/file name For example: sel stat dest=/sci/payroll/june.payroll; This parameter can be used in combination with the srcfile parameter to select statistics based on a source file name and a destination file name, for example: sel stat srcf=/sci/accounting/june.payroll dest=/sci/payroll/june.payroll |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pname | Locate the statistics to select by Process name. The Process name is limited to 8 characters on Connect:Direct for Microsoft Windows and Connect:Direct for z/OS®. |
name | generic | (list) name—Specifies the Process name, up to 8 alphanumeric characters. generic—Specifies a nonspecific value for the Process name. This generic value, containing pattern-matching characters, evaluates to a list of zero or more pname strings. list—Specifies a list of Process names. Enclose the list in parentheses, and separate each value with a comma. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pnumber | Locate the statistics to select by Process number. Connect:Direct assigns the Process number when the Process is submitted. | number from 1–99,999 | (list) number—Specifies the Process number. list—Specifies a list of Process numbers. Enclose the list in parentheses, and separate each value with a comma. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
reccat | Specifies whether the selection of statistics file records is based on events or related to a Process. | CAEV | CAPR | (CAEV, CAPR) CAEV—Specifies that the selection of statistics file records is related to an event, such as a IBM® Connect:Direct shutdown. CAPR—Specifies that the selection of statistics file records is related to one or more IBM Connect:Direct Processes. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
recids | Specifies the statistics file records to be selected by record ID. This parameter identifies particular types of statistics records, such as a copy termination records or Connect:Direct initialization event records. | record id | (list) record id—Selects statistics file records for the specified record ID. list—Specifies a list of Process names. Enclose the list in parentheses, and separate each value with a comma. Some of the most common Rec ID (Identifiers) are listed below. Other Rec IDs are typically derived from the first 4 letters of a message ID. The message text will provide the necessary details.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
snode | Locate the statistics file record by the secondary node name. This parameter can
be used to specify a specific remote node, a generic value for matching remote node names (using
pattern matching), or a list of multiple remote node names. The secondary node name typically contains the 1–16 character remote Connect:Direct node name, but can be any string up to 256 alphanumeric characters long. You can also specify a remote node name as an IP address or hostname and a port number. |
remote node specification | generic |
(list) remote node specification—Identifies a specific remote node name. generic—Specifies a nonspecific value for the remote node name. This generic value, containing pattern-matching characters, evaluates to a list of zero or more remote node names. list—Specifies a list of remote node specifications. Enclose the list in parentheses, and separate each value with a comma. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
srcfile | Selects statistics based on a source file name. This parameter can be abbreviated as srcf. | srcf=/path/file name For example: sel stat srcf=/sci/accounting/june.payroll; This parameter can be used in combination with the destfile parameter to select statistics based on a source file name and a destination file name, for example: sel stat srcf=/sci/accounting/june.payroll dest=/sci/payroll/june.payroll |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
startt | Selects records produced both at and since the specified time. The date or day and time are positional. If you do not specify date or day, a comma must precede time. | [date | day] [, hh:mm:ss [am|pm]] date—Specifies the day (dd), month (mm), and year (yy), which you can code as mm/dd/yyyy or mm-dd-yyyy. If you only specify date, the time defaults to 00:00:00. The current date is the default. day—Specifies the day of the week. Values are today, monday, tuesday, wednesday, thursday, friday, saturday, and sunday. hh:mm:ss [am | pm]—Specifies the time of day in hours (hh), minutes (mm), and seconds (ss). You can specify the hour in either 12- or 24-hour format. If you use 12-hour format, then you must specify am or pm. The default is the 24-hour format. The default value is 00:00:00, which indicates midnight. If you specify only the day value, the time defaults to 00:00:00. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
stopt | Specifies that Connect:Direct searches for statistics records up to and including the designated date, day, and time positional parameters. If you do not specify date or day, a comma must precede time. | [date | day] [, hh:mm:ss [am|pm]] date—Specifies the day (dd), month (mm), and year (yy), which you can code as mm/dd/yyyy or mm-dd-yyyy. If you only specify date, the time defaults to 00:00:00. The current date is the default. day—Specifies the day of the week. Values are today, monday, tuesday, wednesday, thursday, friday, saturday, and sunday. hh:mm:ss [am | pm]—Specifies the time of day in hours (hh), minutes (mm), and seconds (ss). You can specify the hour in either 12- or 24-hour format. If you use 12-hour format, then you must specify am or pm. The default is the 24-hour format. The default value is 00:00:00, which indicates midnight. If you specify only the day value, the time defaults to 00:00:00. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
submitter | Locate the statistics records to select by the node specification (the Connect:Direct node name) and user ID of the Process owner. The character length of the parameter is unlimited. | (node specification, userid) | generic | (list) node specification, userid—Specifies the node specification (the Connect:Direct node name) and user ID. generic—Specifies a nonspecific value for node specification and user ID. This generic value, containing pattern-matching characters, evaluates to a list of zero or more node specifications and user IDs. list—Specifies a list of node specification and user ID pairs. Enclose the list in parentheses, and separate each value with a comma. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
detail | Specifies the type of report (short or detailed) that Connect:Direct generates for the selected Processes. | yes | no yes—Generates a detailed report. no—Generates a short report. This is the default. |