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.

Record ID Category Description
CMOT Event Client manager comm termination
CSPA Process Secure+
CSPE Event Strong Password Encryption
CTRC Process Copy Termination Record
FMSD, FMRV Process FMH sent / received
IFED, RJED, RTED, SBED, PSED Process Step ended for IF / RUN TASK / RUN JOB / SUBMIT / other
LSMG Process Session Manager
LSST, RSST Process Local / remote step started
NUIC, NUIS Event Server Startup
NUTR, NUT1, NUT2, NUTC, NUIS Event Server Shutdown
PMIP, PMST, PMED Event Process manager initializing / started / ended
PMMX Event TCQ max age processing
PSTR, PRED, PERR, PRIN, PFLS, PSAV Event Process started / ended / error / interrupted / flushed / saved
QCxx Event TCQ change (xx typically identifies the new queue)
SCNT Event Concurrent session count
SLFA, CHFA, DLFA, AUPR Event Select / change / delete functional authorities
SLIP, IPPR, RFIP Event Select / update initparms
SLNM, CHNM, NMPR Event Select / change netmap
SLPX, CHPX, DLPX Event Select / change/ delete proxy
SMIN, SMED Event Session manager initialized / ended
SRSP, STRS Event Select process / statistics response
SSTR, SEND, SERR Event Session started / ended / error
STOP Event Shutdown command
SUBP, CHCG, DELP Process Submit / change / delete process
TRON, TROFF Event Trace on / off
USEC Process User security
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.