Change Alert Table (CHGALRTBL)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Change Alert Table (CHGALRTBL) command is used to change one of the values defined by the Create Alert Table (CRTALRTBL) command. Alert tables define alerts, which are problem notifications in a network. The CHGALRTBL command can be used to change the product identification, product text, or object text for an alert table. The typical user of the CHGALRTBL command is the system or network programmer or operator responsible for network management. More information on alerts is in the Alerts Support book, SC41-5413.

Note: The user must have CHANGE authority for the alert table.

Top

Parameters

Keyword Description Choices Notes
ALRTBL Alert table Qualified object name Required, Key, Positional 1
Qualifier 1: Alert table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
LICPGM Product Character value, *SAME, *NONE Optional
LICPGMTXT Licensed program text Character value, *SAME, *BLANK Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional
Top

Alert table (ALRTBL)

Specifies the qualified name of the alert table that is changed. Each alert table contains alert descriptions that are used to create alerts.

This is a required parameter.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the alert table. If no current library entry exists in the library list, QGPL is used.
library-name
Specify the library where the alert table is located. Only the library named is searched. The user must have READ authority for the specified library.
Top

Product (LICPGM)

Specifies the licensed program associated with this alert table. This program is included in the alert as software product identification for the alert sender.

*SAME
The LICPGM value does not change.
*NONE
A licensed program is not specified.
licensed-program
Specify a seven character product identifier for the licensed program. The Alert Manager uses this identifier to access the software resource management database for release and level information.

Note: This parameter does not have to be an IBM Licensed Program. Any 7-character ID that is meaningful to the use of the Work with Alerts command can be specified. If the value given for the LICPGM parameter is defined to the system, the ID and release and level information are included in the alert.

Top

Licensed program text (LICPGMTXT)

Specifies descriptive text for the alert table licensed program parameter (for example, 'OS/400'). The text is included in the alert as product identification for the alert sender.

*SAME
The text does not change.
*NONE
No text is specified.
'licensed-program-text'
Specify up to 30 characters of text describing the licensed program.
Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text does not change.
*BLANK
No text is specified.
'description'
Specify no more than 50 characters enclosed in apostrophes.
Top

Examples 

CHGALRTBL   ALRTBL(ALRTBLLIB/ALRTBLNBR1)
            LICPGMTXT('OS/400--customer defined')

This command changes the licensed program for the alert table in library ALRTBLLIB called ALRTBLNBR1.

Top

Error messages

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9810
Library &1 not found.
CPF9820
Not authorized to use library &1.
Top