This process polls a directory on a remote machine, and
creates OSFs for any files matching a particular filemask, after first checking
that an OSF does not already exist with the same rootname. In this case,
the files it is searching for are CDBS release catalogs.
This process periodically (at DELTA_TIME interval) polls a remote directory (REMOTE_MACHINE, REMOTE_FILESPEC) for files matching a certain filemask (REMOTE_FILEMASK). For each matching file found on the remote host, a search of the OSF blackboard is made using the rootname of the file. If an OSF already exists for the file, no action is taken. If an OSF is not found, then a new OSF is created according to the OSF_PROCESSING, OSF_DATA_ID, and OSF_DCF_NUM resource values.
This process takes no action to avoid picking up the same files in the remote directory over and over again, however it will only create an OSF the first time it finds a file. Use this process in a pipeline with other processes that take care of eventually removing the registered files from the remote polling directory (e.g. CDBCPY does this in the CDBS pipeline).
If the process fails to login to the remote system the very first time it tries, it will exit. After the first time, failed login attempts for subsequent events will instead be reported and counted, and up to MAX_LOGIN_ERRORS will be allowed before the task exits.
rempol -p $PATH_FILE -r cdbpol
FIREWALL
The name of the firewall if the task
is invoked on a machine behind a firewall. Different FTP syntax is used for
these copies.
MAX_LOGIN_ERRORS
The maximum number of login errors allowed after the first login attempt before the process exits.
REMOTE_MACHINE
The machine name for the remote
UNIX host (e.g. ajuga)
REMOTE_FILESPEC
The directory where files will be
looked for on the remote UNIX host (e.g. /home/mswam/lookhere)
REMOTE_FILEMASK
The filemask used to search for
remote files (e.g. opus*.cat)
REMOTE_LOGIN (optional)
The login name for the remote UNIX
machine, if different from the login name that starts the CDBCOPY command.
REMOTE_TYPE
The operating system type of the remote system. Possible choices are VMS or UNIX, but CDBS currently always serves files from a UNIX system.
TEMP_DIR
Directory name or logical where temporary files can be created. CDBCOPY will normally clean up all temporary files it creates, unless there is an unexpected problem.
PASSWORD_PROMPT
Supplies the password prompt for the
PMG to use (reminds the user which password is being request of them).
OSF_PROCESSING
These values are used to set the initial OSF status fields (e.g. CP = w).
OSF_DATA_ID
Used to fill the
DATA_ID field of any OSFs created.
OSF_DCF_NUM
Used to fill the DCF_NUMBER field of any OSFs created.
This process is meant to be run as a pipeline process. The command arguments are needed for running an internal-polling pipeline process.
-p path name that the process is running in
-r process name used to construct
the name of a process resource file