Description

The HANDLER_ID option specifies a value that uniquely identifies an event handler record.

If an attempt is made to add an event handler record with a HANDLER_ID value that matches the ID of an existing event handler record, the request will fail. All other operations will fail if the HANDLER_ID value does NOT match the ID of an existing event handler record.

Usage

Specification Method	Parameter / Value	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	n/a
Command Line, Long Form	-handler_id id
Definition File Keyword	handler_id id

Value

id is the ID of an event handler record.

The length of id must not exceed 32 characters.

id is case-insensitive. When an event handler is added, id is stored within the record exactly as specified. However, when that record later is referenced by handler ID, case is ignored.

For example, if a record is added with a handler ID of Handler001, the mixed case of the ID is preserved within the record. To access the record after it's been added, a handler ID of any case (for example: handler001, hANDLEr001, or HANDler001) can be specified.

If id contains spaces, it must be enclosed in double ( " ) quotation marks.

Wildcards

If a -list, -export, or -delete operation is being used for UEMLoad, wildcards can be used in id to select multiple event handler records:

• Asterisk ( * ) will match 0 or more characters.
• Question mark ( ? ) can be used to match any single character.