1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records ========================================== -->
5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
11 <!-- (C) IBM Corporation 2000. All Rights Reserved -->
12 <BODY bgcolor="ffffff">
13 <!-- End Header Records ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Administration Reference</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf043.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf045.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
18 <H2><A NAME="HDRFMSLOG" HREF="auarf002.htm#ToC_42">fms.log</A></H2>
19 <P><STRONG>Purpose</STRONG>
20 <P>Records output from the <B>fms</B> command
21 <P><STRONG>Description</STRONG>
22 <P>The <B>fms.log</B> file records the output generated by the
23 <B>fms</B> command. The output includes two numbers that can appear
24 in a tape device's entry in the <B>/usr/afs/backup/tapeconfig</B>
25 file on the Tape Coordinator machine to which the tape device is
28 <P><LI>The capacity in bytes of the tape in the device
29 <P><LI>The size in bytes of the end-of-file (EOF) marks (often referred to simply
30 as <I>filemarks</I>) that the tape device writes
32 <P>When transferring the numbers recorded in this file to the
33 <B>tapeconfig</B> file, adjust them as specified on the reference page for
34 the <B>tapeconfig</B> file, to improve Tape Coordinator performance during
36 <P>If the <B>fms.log</B> file does not already exist in the current
37 working directory, the <B>fms</B> command interpreter creates it.
38 In this case, the directory's mode bits must grant the <B>rwx</B>
39 (<B>read</B>, <B>write</B>, and <B>execute</B>) permissions to the
40 issuer of the command. If there is an existing file, the command
41 interpreter overwrites it, so the file's mode bits need to grant only the
42 <B>w</B> permission to the issuer of the <B>fms</B> command.
43 The <B>fms</B> command interpreter also writes similar information to the
44 standard output stream as it runs.
45 <P>The file is in ASCII format. To display its contents, log onto the
46 client machine and use a text editor or a file display command such as the
47 UNIX <B>cat</B> command. By default, the mode bits on the
48 <B>fms.log</B> file grant the required <B>r</B> permission only
49 to the owner (which is the local superuser <B>root</B> by default).
50 <P><STRONG>Output</STRONG>
51 <P>The first few lines of the file provide a simple trace of the
52 <B>fms</B> command interpreter's actions, specifying (for example)
53 how many blocks it wrote on the tape. The final two lines in the file
54 specify tape capacity and filemark size in bytes, using the following
56 <PRE> Tape capacity is <VAR>tape_size</VAR> bytes
57 File marks are <VAR>filemark_size</VAR> bytes
60 <P><STRONG>Examples</STRONG>
61 <P>The following example of the <B>fms.log</B> file specifies that
62 the tape used during the execution of the <B>fms</B> command had a
63 capacity of 2,136,604,672 bytes, and that the tape device writes filemarks of
65 <PRE> fms test started
67 Tape capacity is 2136604672 bytes
68 File marks are 1910220 bytes
71 <P><STRONG>Related Information</STRONG>
72 <P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
73 <P><A HREF="auarf130.htm#HDRFMS">fms</A>
75 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf043.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf045.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
76 <!-- Begin Footer Records ========================================== -->
78 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
80 <!-- End Footer Records ============================================ -->
81 <A NAME="Bot_Of_Page"></A>