Sirius Satellite Radio SirFile 204 User Manual
  1. Manuals
  2. Brands
  3. Sirius Satellite Radio Manuals
  4. Software
  5. SirFile 204
  6. User manual
Sirius Satellite Radio SirFile 204 User Manual

Sirius Satellite Radio SirFile 204 User Manual

File monitor
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
———————————————————
SirFile User's Guide
(Model 204 File Monitor)
———————————————————
Sirius Software, Inc.
875 Massachusetts Avenue, Suite 21
Cambridge, MA 02139
Telephone: (617) 876-6677
FAX: (617) 234-1200
E-mail: support@sirius-software.com
World Wide Web: http://sirius-software.com
March 14, 2006
© 2006 Sirius Software, Inc.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SirFile 204 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Sirius Satellite Radio SirFile 204

  • Page 1 ——————————————————— SirFile User's Guide (Model 204 File Monitor) ——————————————————— Sirius Software, Inc. 875 Massachusetts Avenue, Suite 21 Cambridge, MA 02139 Telephone: (617) 876-6677 FAX: (617) 234-1200 E-mail: support@sirius-software.com World Wide Web: http://sirius-software.com March 14, 2006 © 2006 Sirius Software, Inc.
  • Page 2 —————————————————————————————————————————— —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...
  • Page 3 Sirius Software, Inc.: Sirius Software, Inc. 875 Massachusetts Avenue, Suite 21 Cambridge, Massachusetts 02139 1.617.876.6677 http://sirius-software.com Model 204™ is a proprietary product of Computer Corporation of America: Computer Corporation of America 500 Old Connecticut Path Framingham, Massachusetts 01701 1.508.270.6666 http://www.cca-int.com ——————————————————————————————————————————...
  • Page 4 —————————————————————————————————————————— Proprietary Notices —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 5: Table Of Contents

    —————————————————————————————————————————— —————————————————————————————————————————— ——————— Contents Proprietary Notices ....... . . Contents ........v Chapter 1: Introduction to UL/SPF UL/SPF Packaging and Installation Requirements...
  • Page 6 —————————————————————————————————————————— Contents —————————————————————————————————————————— Index ......... ——————————————————————————————————————————...

  • Page 7: Introduction To Ul/Spf

    UL/SPF is a family of products implemented as User Language application subsystems and designed to function together in a Model 204 online. Each product in the family can be installed and run independently, or each can be installed and run as a component of the integrated UL/SPF (User Language / System Productivity Facilities) framework.

  • Page 8: Ul/Spf Packaging And Installation Requirements

    All of the UL/SPF products are Model 204 application subsystems written in User Language. UL/SPF is distributed as a set of Model 204 files in a backup format produced by the Model 204 DUMP command. As of UL/SPF Version 6.8, all User Language based products are distributed in a single Model 204 procedure file called SIRIUS.

  • Page 9: Integrating Ul/Spf With Other Subsystems

    Sirius Mods Installation Guide Sirius Functions Reference Manual ● ● Sirius Messages Manual The following manuals are part of the Model 204 documentation set available from the Computer Corporation of America: —————————————————————————————————————————— SirFile User's Guide Integrating UL/SPF with Other Subsystems SIRIUS.COMM...
  • Page 10 —————————————————————————————————————————— Introduction to UL/SPF —————————————————————————————————————————— ● Model 204 Command Reference Manual ● Model 204 File Manager's Guide Model 204 System Manager's Guide ● ● Model 204 User Language Manual —————————————————————————————————————————— SirFile User's Guide...

  • Page 11: Overview And Setup For Sirfile

    CHAPTER 2 SirFile is a comprehensive facility for monitoring the physical storage utilization of Model 204 database files and warning users of the need for file reorganizations. SirFile requires only a single screen of setup information to determine “thresholds,” after which it automatically performs a pass through the online database files, checking to see if any file has exceeded a threshold.

  • Page 12: Files Available For Sirfile Monitoring

    —————————————————————————————————————————— Overview and Setup for SirFile —————————————————————————————————————————— ● “Running SirFile under BATCH204” on page calculating CFULLP The SirFile refresh process is always in “learn” mode. Any file that is open when a SirFile refresh is run is automatically added to the SirFile database, using the default thresholds for comparison.

  • Page 13: Getting Started

    Table A page to store field information. Table A is usually the smallest table in a Model 204 database file, but it is accessed every time a field name is referred to in User Language or IFAM code, so it is important that Table A operate as efficiently as possible.
  • Page 14 —————————————————————————————————————————— Overview and Setup for SirFile —————————————————————————————————————————— placement of new pointers in the table must run repeatedly in order to find an empty slot. There is no fixed measure of how many retries indicate a critical condition for Table C. CFULLP Percentage of Table C full.
  • Page 15 SirFile records are fairly small and you shouldn't be too concerned about minimizing the amount of stored data: A year's worth of data for a single file will occupy only about 1 Model 204 page if a record is kept per week. The following commands are allowed:...
  • Page 16 —————————————————————————————————————————— Overview and Setup for SirFile —————————————————————————————————————————— PF keys: Accesses full-screen help. Return to command level or previous screen. Repeats the last command-line command. PF12 Saves the file specific thresholds and invokes the SirFile database refresh operation. —————————————————————————————————————————— SirFile User's Guide...

  • Page 17: The Refresh Process

    Running a refresh once always runs in the Model 204 thread of the user requesting the refresh, and can be specified either for a single file or for all files that SirFile can access.
  • Page 18 —————————————————————————————————————————— The Refresh Process —————————————————————————————————————————— Messages to users and the audit trail are only sent during a periodic refresh. The Refresh process makes a list of all files already in its database, then adds to the list any files that are currently open in the online. Then it runs through the following process for each file on the list: It checks to see if a file-specific threshold exists.

  • Page 19: Main File Menu

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Main File Menu CHAPTER 4 The Main File menu is presented on entering SirFile any time but the first; it is also presented when PF3 is pressed from most SirFile screens. The first time entering SirFile, the System Default thresholds screen is presented, an initial database load is performed, then the Main File menu is presented.
  • Page 20 —————————————————————————————————————————— Main File Menu —————————————————————————————————————————— Bottom ADD xxxxxxxx REFRESH xxxxxxxx OPEN xxxxxxxx CLOSE xxxxxxxx DELETE xxxxxxxx TIME xxxx yy —————————————————————————————————————————— Moves the display to the top of the file list. Moves the display to the bottom of the file list. When using PF7 or PF8 , scroll up or down to the top or bottom of the list of files.
  • Page 21 —————————————————————————————————————————— —————————————————————————————————————————— PF keys: Accesses full-screen help. Accesses the Background Monitor specification screen. This screen controls background monitoring, and specifies actions taken when the monitor notices file-full-pending conditions. Return to command level or the UL/SPF main menu. Accesses a scrollable list that displays the table-full status of files currently open by any user or subsystem.
  • Page 22 —————————————————————————————————————————— Main File Menu —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 23: File Thresholds Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— File Thresholds Screen CHAPTER 5 The user may specify a set of thresholds that apply to only a single file, by placing the cursor on the filename and pressing PF11 , from either the Main File menu or from the File Tables screen.
  • Page 24 —————————————————————————————————————————— File Thresholds Screen —————————————————————————————————————————— Current Table Settings The column to the right of the threshold settings contains the current file status for ARETRIES, BFULLP, CRETRIES, DFULLP, EXTNADD, OVFLADD, EOVFLADD, and SPILLADD. CFULLP is not calculated in this column because of resource considerations. If however CFULLP was collected on any sample after the first, the latest CFULLP is presented and is used in the calculation of the value in the next column.
  • Page 25 —————————————————————————————————————————— —————————————————————————————————————————— Repeats the last command-line command. PF12 Saves the file specific thresholds and, for this file only, invokes the SirFile database refresh operation. —————————————————————————————————————————— SirFile User's Guide File Thresholds Screen...
  • Page 26 —————————————————————————————————————————— File Thresholds Screen —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 27: File Open Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— File Open Screen CHAPTER 6 When SirFile needs to open a file, it first tries to do it without a password. If that fails the user is prompted for a password with the following screen: ------------------------- * * * Enter Password * * * ------------------------- ---------------------------------------------------------------------------- SirFile requires only read privileges in files being monitored.
  • Page 28 —————————————————————————————————————————— File Open Screen —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 29: File Detail Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— File Detail Screen CHAPTER 7 The File Detail screen may be accessed from the Main File menu or the File Tables screen, by placing the cursor on a file name and pressing PF10 . -------------------ULSPF500 / 4.1.1E / CMS ---------------- INTERVAL: * SEC---- ===>...
  • Page 30 —————————————————————————————————————————— File Detail Screen —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 31: File Tables Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— File Tables Screen CHAPTER 8 PF4 from the Main File menu presents a scrollable list of the table-full status of files currently open by any user or subsystem. ------------------FILE 1/22 ----- ULSPF500/4.1.1E/CMS ------------------------- ===> _ FILENAME NRECMAS NRECEXT DATALINK METADATA SIRLIBD...
  • Page 32 —————————————————————————————————————————— File Tables Screen —————————————————————————————————————————— F xxxxxxxx or /xxxxxxxx -F xxxxxxxx or -/xxxxxxxx Bottom SORT stat x OPEN xxxxxxxx CLOSE xxxxxxxx PF keys for this screen are: Accesses full screen help. Return to previous screen. Accesses table-full prediction messages for files that have them posted. Scrolls the display up.
  • Page 33 —————————————————————————————————————————— —————————————————————————————————————————— PF10 Accesses the File Detail screen, if the cursor is positioned over a file statistic line when the PF key is pressed. PF11 Accesses the threshold screen for a selected file. PF12 Performs the Refresh process, either for all files, or for a single file if the cursor is placed over a file statistic line when the PF key is pressed.
  • Page 34 —————————————————————————————————————————— File Tables Screen —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 35: Messages Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Messages Screen CHAPTER 9 Placing the cursor on a file name in the Main File menu or the File Tables screen, and pressing PF6 , allows the user to view messages posted to the file. --------------- * * * Messages and warnings posted to file * * * ------------- ===>...
  • Page 36 —————————————————————————————————————————— Messages Screen —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 37: Background Monitor Specification Screen

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Background Monitor Specification Screen CHAPTER 10 PF2 from the Main File menu presents the Background Monitor specification screen. --------------------- * * * Background File Monitor * * * -------------------- ==> _ Default monitoring increment (minutes) ------------------------ Warnings --------------------------- Send warnings to the journal? (Y/N) Warn: 0 = Never, 1 = First time only, 2 = Every time Other users to receive warning messages (separate by blanks):...
  • Page 38 —————————————————————————————————————————— Background Monitor Specification Screen —————————————————————————————————————————— Predictions to Journal Predict frequency Predict List The following commands work on this screen: OPEN xxxxxxxx CLOSE xxxxxxxx PF keys: Accesses full-screen help. Return to previous screen. Save the new background task specifications, and initialize the background task.

  • Page 39: Invocation Techniques For Background Monitoring

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Invocation Techniques for Background CHAPTER 11 Monitoring SirFile's background monitor runs as a special user in the SIRFILE APSY; this performs the periodic refresh operation. Messages to users and the audit trail are only sent during a periodic refresh (that is, by the background task). Any user ID can be the background monitor, and any SirFile user can initiate the background task.
  • Page 40 —————————————————————————————————————————— Invocation Techniques for Background Monitoring —————————————————————————————————————————— a terminal will cause that session to become the background SirFile task: that is, it will enter a “sleep” state that is not interruptable unless it is bumped. You can also use the SIRFILE BATCH command to invoke a refresh once; see “Running SirFile under BATCH204”...

  • Page 41: Running Sirfile Under Batch204

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Running SirFile under BATCH204 CHAPTER 12 Running SirFile's database refresh in batch has two advantages over running it in the online: It allows the database refresh to be scheduled on a regular basis by a job scheduling system. It allows the most expensive processing in SirFile to be run in off hours.
  • Page 42 —————————————————————————————————————————— Running SirFile under BATCH204 —————————————————————————————————————————— The job is simply a BATCH204 job that contains CCASYS and CCAGRP, and it has a DD card for any file SirFile is going to monitor. The IODEV=15 statement is required; change it to IODEV=nn if you reset the SDAEMDEV parameter to nn. SYSOPT for the job must allow for use of Groups and Application Subsystems.

  • Page 43: File Statistics Definitions

    —————————————————————————————————————————— —————————————————————————————————————————— —————— File statistics definitions APPENDIX A File statistics provide information about each file open in the Online system. Each file has a specific value for each statistic based on the file's current activity and state within the Online region. Many of these statistics are viewable on the File Tables screen and the File Detail screen in SirFile.
  • Page 44 —————————————————————————————————————————— File statistics definitions —————————————————————————————————————————— BREUSED The number of records added to the file that reused the record number of a previously deleted record. Same as the Model204 BREUSED parameter. BSIZE Size of table B in number of pages. BUFPAGA Total number of pages in the disk buffer pool currently occupied by table A pages from the database file.
  • Page 45 —————————————————————————————————————————— —————————————————————————————————————————— CFRCDEX Conflicts on the "DIRECT" and "EXISTS" critical file resources (rate or total). Equal to CFRCDIR+CFRCEXS. CFRCDIR Conflicts on the "DIRECT" critical file resource (rate or total). This resource protects the integrity of Table B. CFRCEXS Conflicts on the "EXISTS" critical file resource (rate or total). This resource protects the integrity of the existence bit map.
  • Page 46 —————————————————————————————————————————— File statistics definitions —————————————————————————————————————————— DKIO Physical page reads/writes to/from the Model204 database file (rate or total). This value is equal to DKRD + DKWR. DKRD Physical pages reads from the Model204 database file (rate or total). DKUPTIME Number of milliseconds spent writing a file's pages to disk, and marking it "physically consistent".
  • Page 47 —————————————————————————————————————————— —————————————————————————————————————————— FCTB Total number of pages in the disk buffer pool currently occupied by FCT pages from the database file. FCTM Total number of pages in the disk buffer pool currently occupied by modified FCT pages from the database file. These pages must be written to disk before they can be flushed from the buffer pool.
  • Page 48 —————————————————————————————————————————— File statistics definitions —————————————————————————————————————————— FRCVOPT Summed hex value indicating file recovery options, as follows: X'80' - Updates not allowed without roll forward X'40' - Updates not allowed unless checkpointing X'20' - File does not participate in X'10' - Discontinuities not allowed. X'08' - Transaction backout disabled.
  • Page 49 —————————————————————————————————————————— —————————————————————————————————————————— MODPAGF Total number of pages in the disk buffer pool currently occupied by modified FCT pages from the database file. These pages must be written to disk before they can be flushed from the buffer pool. MODPAGL Total number of pages in the disk buffer pool currently occupied by modified table E pages from the database file.
  • Page 50 —————————————————————————————————————————— File statistics definitions —————————————————————————————————————————— value, the better. After a reorg, this value will generally be close to 100 - LRESERV. A value close to 50 or lower is a sign of relatively low ordered index density and suggests a reorg. OILEAVS The number of Ordered Index B-tree leaf-level nodes.
  • Page 51 SirMon in seconds. UPDTIME Date and time file was last updated. UPDTTIME is formatted "YYYYJJJHHMMSSTH", for year, Julian date, hours, minutes, seconds and tenths of seconds. This stat is the same as Model 204's file statistic DTSLUPDT. —————————————————————————————————————————— SirFile User's Guide...
  • Page 52 —————————————————————————————————————————— File statistics definitions —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

  • Page 53: Date Processing

    —————————————————————————————————————————— —————————————————————————————————————————— —————— Date Processing APPENDIX B SirFile uses dates in the following ways: ● To examine the CPU clock (as returned by the STCK hardware instruction) to determine the current date, in case SirFile is under a rental or trial agreement ●...
  • Page 54 —————————————————————————————————————————— Date Processing —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...
  • Page 55 —————————————————————————————————————————— —————————————————————————————————————————— —————— Index Background monitor ... 31-33 Invocation techniques ... 33 Predict frequency ... 32 Predictions to journal ... 31 time interval setting ... 31 User list for predictions ... 32 User list for warnings ... 31 Warning frequency ... 31 Warnings to journal ...
  • Page 56 —————————————————————————————————————————— Index —————————————————————————————————————————— —————————————————————————————————————————— SirFile User's Guide...

Table of Contents