ADDPRBACNE (Add Problem Action Entry)

ADDPRBACNE Command syntax diagram

 

Purpose

The Add Problem Action Entry (ADDPRBACNE) command adds an entry to the specified problem filter. This entry describes the actions to take for a problem entry. A problem entry is assigned to the specified group by a selection entry in the specified problem filter.

 

Required Parameters

FILTER
Specifies the name of the filter.

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-filter-name: Specify the name of the filter.

GROUP
Specifies the group for which the actions are applied. The group name is assigned from selection criteria from a selection entry in the filter. Selection entries are added to the filter with the ADDPRBSLTE command.

 

Optional Parameters

ASNUSER
Specifies the user assigned to the problem log entry.

*NOCHG: No new value is assigned to the problem log entry.

*NONE: No user is assigned to the problem log entry.

assigned-user: Specify a user name.

SNDDTAQ
Specifies the data queue for the problem notification record. Keyed data queues are supported.

*NONE: No data queue is used.

Element 1: Data Queue Name

The name of the data queue 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.

data-queue-name: Specify the name of the data queue.

Element 2: Data Queue Key

*NONE: No key is used on the data queue.

data-queue-key: Specify the data queue key.

 

Notes

  1. If an exact match is not found for the group name when a filter is applied, then the default action entry is used to assign actions. The default action entry is automatically added to the filter when it is created. The default values are ASNUSER(*NONE) and SNDDTAQ(*NONE).

  2. A keyed data queue is a queue with a key assigned to each entry on the queue. When retrieving entries, a key can be specified and the entries with that key are retrieved on a FIFO order. The key that is specified on the *SNDDTAQ parameter is assigned to the problem notification record when placed on a keyed data queue.

An 80-byte record is enqueued on the data queue specified by the user. This record is received when the QRCVDTAQ program is called. The data queue does not have to be used solely for problems; alerts and problems can share the same data queue.

If a key is specified, it is used when enqueueing the record on the queue. If the data queue is non-keyed, the record is enqueued without a key.

Note: The time stamp used is the system standard time stamp. This time is already stored in the problem record.

The following table describes the record format.

Table 1. Record Format

Position Type Value Description
1-10 CHAR *PRBFTR Problem filtering notification
11-11 CHAR Function Function performed

1 - Problem created

2 - Problem changed

3 - Problem deleted

12-19 CHAR Function TOD TOD time stamp for function
20-29 CHAR Group Group problem was filtered into
30-39 CHAR Problem ID Problem ID number
40-59 CHAR Origin System System where problem originated
60-60 CHAR Last Event Last event committed into the history log (see note)
61-68 CHAR Event TOD TOD time stamp for Last Event
69-80 CHAR Reserved Reserved for future use
Note: Valid Last Event values are the following:
'01'X
Problem entry opened
'02'X
Request received
'03'X
Opened by Alert
'10'X
Problem analyzed
'11'X
Verification test ran
'12'X
Recovery procedure ran
'20'X
Prepared to report
'21'X
Service request sent
'22'X
Problem answered
'23'X
Response sent
'24'X
Reported by voice
'25'X
Fixes transmitted
'30'X
Fix verified
'41'X
Analyzed remotely
'42'X
Remote verification ran
'43'X
Remote recovery ran
'50'X
Alert created
'51'X
APAR created
'52'X
APAR data saved
'54'X
APAR data restored
'55'X
APAR data deleted
'60'X
Problem changed by Change Problem (CHGPRB) command
'61'X
Problem deleted by Delete Problem (DLTPRB) command
'99'X
Problem entry closed

Example for ADDPRBACNE 

ADDPRBACNE   FILTER(MYLIB/MYFILTER)  GROUP(IOWA)                                
  ASNUSER(SYSOPR))   SNDDTAQ(*LIBL/PROBDTAQ)

The actions defined for group IOWA are: enqueue the problem on data queue PROBDTAQ; and assign the problem to user SYSOPR.

Error messages for ADDPRBACNE

*ESCAPE Messages

CPF2150
Object information function failed.
CPF2151
Operation failed for &2 in &1 type *&3.
CPF7A82
Error occurred while applying the problem filter.
CPF812F
Filter damaged.
CPF91DB
Group &4 already exists.
CPF91DE
Filter &1/&2 at maximum size.
CPF91EB
Filter type &3 not correct for this operation.
CPF91EC
Internal processing error occurred.
CPF91E8
Internal processing error occurred.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9807
One or more libraries in library list deleted.
CPF9808
Cannot allocate one or more libraries on library list.