ADDPRBSLTE Command syntax diagram
The Add Problem Selection Entry (ADDPRBSLTE) command defines selection criteria that categorize a group of problem log entries. You can add a problem log selection entry to a problem log filter that was created using the Create Filter (CRTFTR) command.
The name of the filter can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
problem-log-filter-name: Specify the name of the filter.
You can specify a single value (*ANY) or all four elements that define a relationship. When you specify the four elements, the attribute and attribute value are compared for the relationship specified by the relational operator.
*ANY: Any problem log entry is selected.
Element 1: Logical Operator
*IF: The specified relationship must be satisfied for a problem log entry to be selected.
*AND: The specified relationship must be satisfied in addition to the *IF relationship for a problem log entry to be selected.
*OR: The specified relationship must be satisfied in addition to or instead of the *IF relationship for a problem log entry to be selected.
Element 2: Attribute
*EVENT: The filter is applied when the problem log entry is created (a value of 1), changed (a value of 2), or deleted (a value of 3). If the entry has been created and is changed before being committed, use the value of 1.
*ORIGIN: The problem log entry was locally generated (a value of L) or was received from another system (a value of R).
*ORGNETID: The network identifier (ID) of the system in which the problem log entry originated is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value in the following form:
'nnnnnnnnnn'
*ORGCPNAM: The control point name of the system in which the problem log entry originated is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value in the following form:
'cccccccccc'
*RCVNETID: The network identifier of the remote system from which the problem log entry was received is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value on the following form:
'nnnnnnnnnn'
*RCVCPNAM: This attribute specifies the Remote System Control Point name in which the problem log entry received from. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. The value specified for this attribute should be of the following form:
'cccccccccc'
*PROBTYPE: The type of problem entry created. Possible problems are machine-detected (a value of 1), user-detected (a value of 2), PTF order (a value of 3), application-detected (a value of 4), PC machine-detected (a value of 5), or PC user-detected (a value of 6).
| Note: | User-Detected Remote Hardware problems are grouped with number 2 User-Detected problems. |
*SEV: The severity of the problem log entry created. Possible choices are high (a value of 1), medium (a value of 2), low (a value of 3), none (a value of 4), or not assigned (a value of 5).
| Note: | Problems do not have a severity level when locally created. |
*MSGID: The message ID found in the problem log entry. This is usually an iSeries 400 message ID from an iSeries 400.
*ORGHDW: The origin hardware resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
'tttt mmm ss-sssssss' 'tttt mmm ss-sssss' 'tttt mmm sssssss' 'tttt mmm sssss'
where tttt is the machine type, mmm is the model number and sssssssss is the serial number. Use this exact format to match a particular hardware resource exactly, or use a part of the hardware value with the Contains (*CT) relation to provide a partial match.
*RSCHDW: The failing hardware resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
'tttt mmm ss-sssssss' 'tttt mmm ss-sssss' 'tttt mmm sssssss' 'tttt mmm sssss'
where tttt is the machine type, mmm is the model number and sssssssss is the serial number. Use this exact format to match a particular hardware resource exactly, or use a part of the hardware value with the Contains (*CT) relation to provide a partial match.
*RSCSFW: The failing software resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
'ppppppp vv rr mm'
where ppppppp is the licensed program ID, vv is the version number, rr is the release number, and mm is the modification level. Use this exact format to match a particular software resource exactly, or use a part of the software value with the Contains (*CT) relation to provide a partial match.
Element 3: Relational Operator
The value specified for Element 2 must have the following relationship to Element 4:
Element 4: Attribute Value
attribute-value: Specify a value to compare with the contents of the attribute specified for Element 2. A maximum of 30 characters can be specified. The value must be specified in character format and must be enclosed in apostrophes if it contains blanks or special characters. If a CL variable is specified for the value, it must be a character variable.
generic*-attribute-value: Specify the generic attribute value.
*GEN: The system generates the sequence number.
sequence-number: Specify a number from 1 through 9999.
*DEFAULT: The problem log entry is assigned to the default group.
group-name: Specify a group name.
Examples for ADDPRBSLTE
Example 1: Adding a Selection Entry
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *EVENT *EQ 1) (*AND *SEV *EQ 1)) SEQNBR(*GEN) GROUP(HIGHPROB)
This command adds an entry to the filter PROBFILTER in library PROBLIB. Any problems that have been created and are of severity 1 are assigned to group HIGHPROB.
Example 2: Assigning Entries by Origin System Network ID
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *ORGNETID *EQ 'IOWA')) SEQNBR(*GEN) GROUP(IOWA)
This command assigns any problems with a origin system network ID of IOWA to group IOWA.
Example 3: Assigning Entries by Problems for Messages
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *MSGID *EQ 'CPF89*')) SEQNBR(*GEN) GROUP(MSGCPF89)
This command assigns any problems for message CPF8901, CPF8902, and so on, to group MSGCPF89.
Example 4: Assigning Entries by Hardware Problems
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *RSCHDW *CT 9404) (*OR *RSCHDW *CT 9406) (*OR *RSCHDW *CT 9402)) SEQNBR(*GEN) GROUP(AS400USER)
All problems for iSeries 400 hardware (the hardware resource information containing machine type 9402, 9404 or 9406) are assigned to group AS400USER.
Caution must be taken when using the contains operation. In this example if the sending machine had a serial number containing 9402, 9404, or 9406 it would also match this selection entry even if the machine type was not 9402, 9404, or 9406. A better example follows.
Example 5: Assigning Entries by Hardware Problems
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *RSCHDW *EQ 9404*) (*OR *RSCHDW *EQ 9406*) (*OR *RSCHDW *EQ 9402*)) SEQNBR(*GEN) GROUP(AS400USER)
This command assigns all problems for iSeries 400 hardware (the hardware resource information equals machine type 9402, 9404 or 9406) to group AS400USER.
This is a better way to select on the sending hardware machine type. Only those machines with types of 9402, 9404, or 9406 will result in a match.
Example 6: Assigning Entries by Machine-detected Problems
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *PROBTYPE *EQ 1)) SEQNBR(*GEN) GROUP(MACHDETECT)
This command assigns any problems that are machine-detected to group MACHDETECT.
Example 7: Assigning Entries by Product-specific Problems
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *RSCSFW *EQ '5716SS1 03 06 00')) SEQNBR(15) GROUP(OS400V3R6)
This command assigns any problems that are specifically for OS/400 Version 3 Release 6 Modification 0 to group OS400V3R6. Notice that this entry is placed after entry number 10 in the filter, since 15 is specified as the sequence number.
Example 8: Assigning Entries by Matching Products
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER) SELECT((*IF *RSCSFW *EQ '5716SS1*')) SEQNBR(25) GROUP(OS400)
This selection entry matches Version 3 Release 6 of the OS/400 licensed program.
((*IF *PROBTYPE *EQ 1) (*AND *SEV *EQ 1) (*OR *PROBTYPE *EQ 2) (*AND *SEV *EQ 1))is equivalent to the following Boolean expression:
if ((*PROBTYPE = 1) and (*SEV = 1)) or ((*PROBTYPE = 2) and (*SEV = 1))
Error messages for ADDPRBSLTE
*ESCAPE Messages