B Installing Event Detail Text

Event Text makes Oracle GoldenGate detailed text available to operators using the Viewpoint event detail screen. This appendix provides instructions for installing and working with Event Text.

This appendix includes the following sections:

B.1 Standard Installation

To install event text (assuming a default configuration of Viewpoint), issue the following commands.

TACL> VOLUME installation_volume_subvolume
TACL> RUN EMSINST

The EMSINST macro performs the steps described in the following section.

B.2 Custom Installation

If your installation of Viewpoint differs from the default configuration, perform the following steps (Substitute appropriately for PATHMON process names, and so on.)

  1. From TACL, enter the following:

    TACL> VOLUME GGS
    TACL> FUP /IN EVCXFUP/
    TACL> RUN EVCXLDO /IN EMSDTL/
    
  2. Bring down the Viewpoint event detail server, as shown in these commands:

    TACL> PATHCOM $ZVPT
    =FREEZE SERVER ZVPT-EVNT-DETL
    =STOP SERVER ZVPT-EVNT-DETL
    =STOP SERVER ZVPT-EVNT-DETL
    

    If this is the first time that custom messages will be used on your system also perform the following assignment.

    =ALTER SERVER ZVPT-EVNT-DETL, ASSIGN CUSTOM-DETAIL, \SYS.$SYSTEM.SYSTEM.EVENTCX
    =EXIT
    
  3. If $SYSTEM.SYSTEM.EVENTCX already exists, enter:

    TACL> FUP COPY EVENTCX, $SYSTEM.SYSTEM.EVENTCX, SHARE
    

    Otherwise, enter:

    TACL> FUP DUP EVENTCX, $SYSTEM.SYSTEM.EVENTCX
    
  4. Bring up the Viewpoint event detail server, as follows:

    TACL> PATHCOM $ZVPT
    =THAW SERVER ZVPT-EVNT-DETL
    =START SERVER ZVPT-EVNT-DETL
    =EXIT
    

B.3 Customizing Error Messages

You can customize message text by altering the event text within the EMSDTL file before running the EVCXLDO or EMSINST programs.