Command Directory

log

The log command can be used to log the contents of the Log window to a data set.

Lo{g}

	Format 1: `log` file [FILENAME]
	Format 2: `log` append FILENAME
	Format 3: `log` start\|stop\|capture

DESCRIPTION

Format 1:

The file keyword specifies the file to which logged output is to be written. The log command writes over the file. If the log file command is issued without any arguments, the name of the current log file is displayed.

The FILENAME argument is specified as a tso: style filename under OS/390, and a cms: style filename under CMS. Do not, however, specify the tso: or cms: prefix in the command; it is assumed.

Format 2:

The append keyword specifies the file to which logged output is appended.

Format 3:

Logging of the contents is started by issuing a log start command. Logging is turned off by issuing a log stop command. The log stop command does not close the file; it flushes the file to disk. Logging may be resumed at anytime by another log start command.

Issuing a subsequent log file filename or log append filename command closes the current log file and opens the file specified for logging.

The log capture command is used to log everything in the debugger's Log window buffers since the last log stop . Some log output may be lost if the Log window buffer is not large enough.

Issuing the log command with either a file or an append keyword and a FILENAME argument specifies the file to be used for logging. However, it does not start the logging process.

EXAMPLES

log file debugger.log: use the tso data set debugger.log specification for log output.
log file debugger log a: use the cms file debugger log a specification for log output
log file: display the current log file name specification.
log append debugger.log: append output logging to the tso data set debugger.log
log start: start the logging process
log stop: stop the logging process

SYSTEM DEPENDENCIES

The filename argument is specified as a tso: style filename under OS/390, and a cms: filename under CMS. However, do not specify the tso: or cms: prefix in the command. It is assumed.

COMMAND CAN BE ISSUED FROM

PROFILE no

configuration file no

Source command prefix no

SCOPE

The log command is not affected by changes in scope.

RETURN CODES SET

Successful: 0
Unsuccessful: 1

Chapter Contents
Previous
Next
Top of Page