Use the catxcr
command to display one or more job transcripts. Oracle Secure Backup maintains a running transcript for each job. The transcript describes the details of the job's operation. Oracle Secure Backup creates this transcript when dispatching the job for the first time and updates it as the job progresses. When a job requires operator assistance, Oracle Secure Backup prompts for assistance by using the transcript.
See Also:
"Job Commands" for related commandsIf you are attempting to list another user's jobs, you must have the right to list any job, regardless of its owner. If you are attempting to list your own jobs, you must have the right to list any jobs owned by user.
If you are attempting to respond to another user's jobs, you must have the right to modify any job, regardless of its owner. If you are attempting to respond to your own jobs, you must have the right to modify any jobs owned by user.
catx•cr [ --level/-l msglevel ] [ --noinput/-N ] [ --msgno/-m ] [ --start/-s msgno | --head/-h nlines | --tail/-t nlines ] [ --follow/-f ] job-id ...
Displays only lines with msglevel or higher message levels. You can specify msglevel either numerically or by name. The default level is 4 (request), which are the normal messages generated by Oracle Secure Backup.
Each message that Oracle Secure Backup writes to a transcript is tagged with a message number and a message level. The message number indicates the position of the message in the transcript.
Note:
The message number may not correspond to the physical line number because a given message can span multiple physical lines.The message level identifies the content of the message as being in one of the ordered categories shown in Table 2-1.
Msg Number | Msg Name | Msg Description |
---|---|---|
0 |
debug2 |
debug (extra output) message |
1 |
debug1 |
debug message |
2 |
verbose |
verbose mode output |
3 |
info |
informational message |
4 |
request |
messaged requested by user |
5 |
summary |
operational summary message |
6 |
warning |
warning message |
7 |
error |
error message (operation continues) |
8 |
abort |
error message (operational is canceled) |
9 |
fatal |
error message (program terminates) |
Suppresses input requests. By default, when a request for input is recognized, catxcr
pauses and enables you to respond to the prompt. Specifying this option suppresses this action.
Prefixes each line with its message number.
Starts displaying at the line whose message number is msgno.
Displays the first nlines of the transcript. If --level
is not specified, then obtool
uses --level 4
as a default, which means that nlines is a count of the default level (or higher). If --level
is specified, then nlines is a count of lines of the specified level or higher.
Displays the last nlines of the transcript. If --level
is not specified, then obtool
uses --level 4
as a default, which means that nlines is a count of the default level (or higher). If --level
is specified, then nlines is a count of lines of the specified level or higher.
Monitors the transcript for growth continually and displays new lines as they appear. By default, the catxcr
command displays the requested number of lines and terminates. You can exit from --follow
mode by pressing Ctrl-C.
Specifies job identifiers of jobs whose transcripts are to be displayed. If a job-id refers to a job that has dependent jobs, then obtool
displays transcripts of all dependent jobs. When catxcr
displays multiple transcripts, it prefixes each line with its job-id. Execute the lsjob command to display job identifiers.
Example 2-10 displays the transcript for a job whose ID is sbt/1.1
.
Example 2-10 Displaying a Job Transcript
ob> catxcr sbt/1.1 2005/03/21.10:19:39 ______________________________________________________________________ 2005/03/21.10:19:39 2005/03/21.10:19:39 Transcript for job sbt/1.1 running on stadv07 2005/03/21.10:19:39 Volume label: Volume tag: ADE202 Volume ID: RMAN-DEFAULT-000001 Volume sequence: 1 Volume set owner: root Volume set created: Mon Mar 21 10:19:39 2005 Media family: RMAN-DEFAULT Volume set expires: never; content manages reuse
In Example 2-5, backup job admin/6
is not proceeding. In Example 2-11, executing catxcr
reveals that Oracle Secure Backup cannot find a usable tape for the backup. The most common cause of this problem is lack of eligible tapes in the library.
You can respond to this situation by pressing the Enter key to return to the obtool
prompt or opening a new window. Use the borrowdev command to gain control of the drive. After making a tape available with the unlabelvol or insertvol command, complete the job by executing catxcr
and then go
.
Example 2-11 Displaying the Transcript for a Hanging Backup
End of tape has been reached. Please wait while I rewind and unload the tape. The Volume ID of the next tape to be written is VOL000007. The tape has been unloaded. obtar: couldn't perform auto-swap - can't find usable volume in library (OB device mgr) Enter a command from the following list: load <n> .. load the tape from element <n> into the drive unload <n> .. unload the tape from the drive into element <n> help .. display other commands to modify drive's database go .. to use the tape you selected quit .. to give up and abort this backup or restore :
Example 2-12 continually displays the transcript for job sbt/1.1
. The example disables input requests and displays all message levels.
Example 2-13 displays all errors and warnings for jobs admin/1.1
and admin/2
.