catxcr

Purpose

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.

Prerequisites

If 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.

Syntax

catxcr::=

catx•cr [ --level/-l msglevel ] [ --noinput/-N ] [ --msgno/-m ]
[ --start/-s msgno | --head/-h nlines | --tail/-t nlines ]
[ --follow/-f ] job-id ...

Semantics

--level /-l msglevel

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.

Table 2-1 Message Levels

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)

--noinput/-N

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.

--msgno/-m

Prefixes each line with its message number.

--start/-S msgno

Starts displaying at the line whose message number is msgno.

--head/-h nlines

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.

--tail nlines

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.

--follow/-f

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.

job-id ...

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

Example 2-10 displays the transcript for a job whose ID is sbt/1.1.

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.

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.

ob> catxcr --noinput --follow --level 0 sbt/1.1

Example 2-13 displays all errors and warnings for jobs admin/1.1 and admin/2.

ob> catxcr --level warning admin/1.1 admin/2