JSI Tip 5487. Windows XP includes the EventCreate utility for creating custom events.

Jerold Schulman

July 8, 2002

2 Min Read
ITPro Today logo in a gray background | ITPro Today

You can create custom events, to aid in debugging, or to provide informational messages, my using the EventCreate utility in your batch script.

When you open a CMD prompt and type EventCreate /?, you receive:

EVENTCREATE [/S system [/U username [/P [password]]]] /ID eventid            [/L logname] [/SO srcname] /T type /D descriptionDescription:    This command line tool enables an administrator to create    a custom event ID and message in a specified event log.Parameter List:    /S    system           Specifies the remote system to connect to.    /U    [domain\]user    Specifies the user context under which                           the command should execute.    /P    [password]       Specifies the password for the given                           user context. Prompts for input if omitted.    /L    logname          Specifies the event log to create                           an event in.    /T    type             Specifies the type of event to create.                           Valid types: ERROR, WARNING, INFORMATION.    /SO   source           Specifies the source to use for the                           event. A valid source can be any string                           and should represent the application or                           component that is generating the event.    /ID   id               Specifies the event ID for the event. A                           valid custom message ID is in the range of 1 - 1000.    /D    description      Specifies the description to be set for                           the newly creating event.    /?                     Displays this help/usage.Examples:    EVENTCREATE /T ERROR /ID 100 /L APPLICATION /D "Create an event in application log"    EVENTCREATE /T ERROR /ID 999 /L APPLICATION /SO WinWord /D "new source Winword in application log"    EVENTCREATE /S system /T ERROR /ID 100 /L APPLICATION /D "Remote system without user credentials"    EVENTCREATE /S system /U user /P password /ID 100 /T ERROR /L APPLICATION /D "Remote machine with user credentials"    EVENTCREATE /S system /U domainuser /ID 100 /T WARNING /SO MyBatchFile.cmd /D "Maintenance script user logon failed"

NOTES:

You must include the the /T, /ID, and /D switches, as well as the /L or /SO switches.

The system parameter used with the /S switch  can be a computer name or an IP address.If you omit /S, the local computer is used.

The description parameter of the /D switch should be quoted (") if spaces are included.



Sign up for the ITPro Today newsletter
Stay on top of the IT universe with commentary, news analysis, how-to's, and tips delivered to your inbox daily.

You May Also Like