General information about messages

Information about message locations, formats, redirection, codes, and prefixes.

Message locations

The Gateway daemon writes log messages to standard output (stdout, referred to as the information log), or to standard error (stderr, referred to as the error log). If Gateway daemon tracing is enabled, the Gateway daemon also writes log messages to the trace output file.

Message format

Messages have the following format:

CTGnnnnt: <JOBNAME> <message text>

where <JOBNAME> is the Gateway daemon job name, nnnn is a number, and t is one of the following:

Identifier	Purpose of message	Written to
I	information	stdout
E	error	stderr
W	warning	stderr

Message redirection

Standard output and standard error can optionally be redirected to the same file. For more information, see Starting in batch mode.

All CICS Transaction Gateway messages can be optionally redirected to standard error, and standard error can be written to a file called outputfile. To do this, use the following command:

ctgstart 2>outputfile >&2

For more information about redirecting messages, see the documentation for your operating system.

Message prefixes

CICS Transaction Gateway messages have the prefix CTG.

For an explanation of all CICS Transaction Gateway messages, see Messages.

API errors

Error codes resulting from incorrect use of the APIs are returned to the associated applications. Applications must notify the user about such errors, and must provide information on the required user response.