A useful summary of the functions can be found lower down the page.
cmdcon is an acronym for command line capture control functions. These functions provide capabilities not present in xcapcon in addition to duplicating many of their functions. Command line capture control functions may be used from a dumb terminal, over the net or on a dial-in or other serial line.
There is a convenient categorization of command line, capture-control functions. The first category consists of the daemons that control capture and are never invoked by the user, but the user should be aware thier existence. Most remaining functions can be categorized by the principal files they operate on. A few of these functions can only be categorized as utilities, but this includes such important functions as archive, that every site will have some occasion to use.
At the heart of the capture control process are several programs: tsched, the scheduler daemon; autosched2, the automatic scheduler program; autoarchive, the automatic archival program; and various capture programs not germane to this discussion. tsched is started at boot time and runs continually. autosched2 and autoarchive are invoked when needed by tsched. In addition to launching the the other programs, tsched also launches post-processing jobs (automatically invoked post-capture pass processing, e.g. ingest), but only as part of the capture process and not separately managed like the automatic archive process is. Related to these programs are a number of important files. Status information about the capture process, along with any postprocessing and archiving, is maintained in the schedlog and schedjobs. Scheduling information is kept in the schedlist and parameters for automatic scheduling are maintained in the autosched. Information about the passes available online is found in the onlinecat. A record of passes archived to tape is maintained in the passcat. These files form the basis for categorizing most remaining functions. A separate file, devtable, contains information about the characteristics of devices available for archive operations.
Online catalog (onlinecat) related functions are addpass, lspass, llpass, passinfo and rmpass. llpass is also useful for displaying data about the status of ongoing capture/autoarchive processes. passinfo is most useful for writing postprocessing scripts.
Pass catalog (passcat) related functions are addcat, catcover, delcat, fixcatzero, listcat and packcat.
Automatic scheduler parameters (autosched) related functions are autoproc, autosched, clearauto, delauto, and listauto.
Scheduled passes (schedlist) related functions are clearsched, delsched, listsched, llsched, mansched and schedproc.
The remaining functions are not conveniently categorized except as utility functions. These are: archive, fixpass, gmt and tapestuff.
addcat - call a record to the pass catalog
addpass - add an entry to the online catalog.
archive - perform archive tape related operations
autoarchive - automatic archival program
autoproc - change the autoarchive or postprocessing parameters for an autosched record
autosched add to or replace autoscheduler records
autosched2 - autoscheduler program called by the scheduler daemon
catcover - display a report on contents of pass catalog
clearauto - deletes all entries from the autosched parameters file
clearsched - delete all scheduled passes
delauto - delete entries from autosched parameters file
delcat - delete entries from the pass catalog
delsched - delete scheduled passes
fixcatzero - fix zero duration records in pass catalog
fixcatsat - change satellite field in pass catalog records
fixpass clear memory locks on the passdisk
gmt - display the Greenwich Mean Time
listauto - display contents of autosched parameters file
listcat - display selected contents of the pass catalog
listsched -display scheduled passes
llpass - displays data about passes on the passdisk including capturing and archiving status
llsched - display scheduled passes, including archiving and capturing parameters
lspass - displays data about passes on the passdisk
mansched - manually schedule a pass
packcat - eliminate unused space in the pass catalog
passinfo - return info about most recent or other online pass
rmpass - remove pass entries form the online catalog
schedproc - change the autoarchive or postprocessing parameters for a scheduled pass.
schedrule - Activate or deactivate user specified autosched records
tapestuff - reserved use utility function
tsched - scheduler daemon started up at boot time
See individual functions.
See individual functions.
autosched, devtable, onlinecat, passcat, schedjob, schedlist, schedlog
Capabilities are available in the command line versions of the capture functions that are not available in xcapcon. The reverse is also true. There are instances when both are useful and the user is urged to become familiar with both sets of capabilities.
Last Update: $Date: 2002/01/28 20:05:21 $