Appendix B.

Tools and Sample Programs

A library of tools and sample programs to use with Remote Software Facility is available from Bug Busters. Among other things, the RSFTOOLS library contains:

• Sample pre-processing programs.
   
• Sample post-processing programs.
   
• Sample automatic-installation programs.
   
• A sample DDM access program.
   
• Commands Retrieve Object Using RSF (RTVOBJRSF), Retrieve Library Using RSF (RTVLIBRSF) and Retrieve Documents Using RSF (RTVDOCRSF). These commands let you retrieve objects, libraries, documents and folders from another machine without having to create a new RSF package each time. The objects you specify are automatically saved on the remote machine, downloaded to your machine via RSF, and then restored on your machine—all with a single command.
   
• Commands Send Object Using RSF (SNDOBJRSF), Send Library Using RSF (SNDLIBRSF) and Send Documents Using RSF (SNDDOCRSF). These commands let you send objects, libraries, documents and folders to another machine without having to create a new RSF package each time. The objects you specify are automatically saved on your machine, sent to the remote machine via RSF, and then restored on the remote machine—all with a single command.
   
• Commands Start Monitoring Output Queue (STRMONOUTQ) and End Monitoring Output Queue (ENDMONOUTQ). These commands let you submit a batch job to monitor an output queue on your system, and automatically forward spooled files to another system.
   
• Command Copy Spooled File Using RSF (CPYSPLFRSF). You can use this command to copy a spooled file or to split the file into multiple parts for more efficient printing.
   
• Commands Start Data Queue Link (STRDTAQLNK) and End Data Queue Link (ENDDTAQLNK). These commands let you link data queues on your machine to data queues on remote machines. When linked with this command, any entries that are sent to one data queue are automatically forwarded to the remote data queue. This function illustrates one use of the RSFLINK API.
   
• Command Send Message Using RSF (SNDMSGRSF). This command lets you send informational and inquiry messages to users on remote machines. This function illustrates another use of the RSFLINK API.

Source code is included for all of the commands and programs in RSFTOOLS.

If you followed the recommended installation procedure, library RSFTOOLS has already been installed for you. If you do not yet have RSFTOOLS or you do not have the latest version of the library, you can download RSFTOOLS from our web site: www.bugbusters.net/download.htm#rsf .