Message handlers
What is the message handler?
You can handle specified errors while you are running a parallel job by using message handlers. You can use the message handler library to control what error messages your parallel jobs can generate. For example, you can use one to specify that certain types of message cannot be written to the log. You can view, edit, or delete message handlers from the message handler library.
Message handlers do not deal with unrecoverable error messages. They are always written to the job log.
Creating the message handler asset
For creating a message handler, go through the following instruction:
- Create or open a project.
- Click New asset. Choose Create a DataStage component > Message handler library. Click Next.
- Define the name of your message handler and click Create or import a message handler from the *.msh file.
- Click Add message ID+. A new row appears.
- Define the rule of a message handler. Specify the Message ID, Actions and optionally add a description. In Message ID you can provide entire ID or with type-ahead, you can choose available options.
- On the upper left side of the page, click Save to persist changes and your message handler library.
Message handlers as a default option
If you are a project administrator, you can use message handlers in your projects as a default. You can set certain rules and apply them to the project without the need for open up each flow and add the rule separately.
- Create or open a project.
- Click Manage tab. On the left sidebar, click DataStage. Go at the end of this page and under Message handlers section choose the Project default message handler.
- Go back to the top of this page and click Save.
Message handlers in DataStage canvas
You can set message handlers while you are working on your DataStage canvas.
- Create or open a project.
- Create (Add asset > Transform and integrate data) or open the DataStage flow.
- Click Settings icon.
- On the left sidebar, click Message handlers.
- Click Add message ID+. A new row appears.
- Define the rule of a message handler. Specify the Message ID, Actions and optionally add a description. In Message ID you can provide entire ID or with type-ahead, you can choose available options.
- Click Save.