PROPERTY OF APPLICON INC. 1/31/78 JACK LIEBSCHUTZ MAGTAPE INTERCHANGE PROGRAM--VERSION A (MIP) 1.1 INTRODUCTION TO MIP THE MAGTAPE INTERCHANGE PROGRAM (MIP) IS AN RSX-11M FILE UTILITY PROGRAM THAT TRANSFERS FILES BETWEEN A FILES-11 DEVICE AND MAGNETIC TAPE. THE MIP UTILITY CAN BE INVOKED BY ANY OF THE METHODS FOR INVOKING A UTILITY DESCRIBED IN CHAPTER 1 OF THE RSX-11M UTILITIES MANUAL. THERE ARE A COUPLE SWITCHES WHICH WILL BE DESCRIBED LATER IN THIS DOCUMENT. 1.2 MIP COMMAND STRING MIP FUNCTIONS ARE REQUESTED BY ENTERING MIP COMMANDS THROUGH THE INITIATING TERMINAL. THE FORMAT OF THE MIP STRINGS DIFFERS FOR EACH FUNCTION AND WILL BE DESCRIBED INDIVIDUALLY. 1.2.1 MIP DEFAULTS FOR FILE SPECIFICATION ELEMENTS ELEMENT DEFAULT VALUE DEV: SY0: -- THE SYSTEM DISK IS ALWAYS DEFAULTED FOR AN UNSPECIFIED DEVICE [ UFD ] THE DEFAULT VALUE FOR UIC IS THE UIC SPECIFIED WHEN LOGGING ON OR BY THE MCR SET COMMAND. FILENAME NO DEFAULT .FILETYPE NO DEFAULT ;VERSION THE DEFAULT WHEN INPUTTING FROM DISK IS THE MOST RECENT VERSION WHEN INPUTTING FROM MAGTAPE THE FIRST VERSION OF THE FILE FOUND ON TAPE WILL BE USED AND A NEW VERSION WILL BE CREATED ON DISK. WHEN INPUTTING FROM MAGTAPE WITH A WILDCARD IN THE INPUT STRING ALL VERSIONS OF THE FILE ON TAPE WILL BE TRANSFERRED TO DISK. THE LAST SEQUENCIAL VERSION OF THIS FILE ON TAPE WILL BECOME THE NEWEST VERSION ON DISK. THIS CAN BE A VERY UNDESIRABLE EFFECT IF THE LAST VERSION OF TAPE IS NOT THE NEWEST VERSION, BECAUSE IT WILL BECOME THE NEWEST VERSION ON DISK!!!!! OUTPUT THE OUTPUT FILE SPECIFIER IS ALWAYS THE SAME AS THE INPUT FILE SPECIFIER. 1.2.2 MIP SWITCHES A SWITCH SPECIFICATION CONSISTS OF A SLASH (/) FOLLOWED BY A TWO CHARACTER SWITCH NAME. SWITCH SUBSWITCH FUNCTION /ZE INITIALIZES A MAGTAPE FOR WRITING /LI /SP GET A DIRECTORY OF THE MAGTAPE AND SPOOL THE DIRECTORY TO THE PRINTER (THIS SWITCH IS DEFAULTED) /-SP DO NOT SPOOL DIRECTORY (SEE LATER DESCRIPTION OF /LI FOR MORE INFORMATION 1.3 ASTERISK CONVENTIONS -- WILDCARDS MIP ALLOWS THE USE OF WILDCARDS WHEN INPUTTING FROM MAGTAPE BY MEANS OF AN ASTERISK CHARACTER * IN THE FILE SPECIFIER. THE * CHARACTER IN ONE OR MORE FIELDS OF A FILE SPECIFIER STANDS FOR "ALL". + *.*;* MEANS ALL VERSIONS OF ALL FILES + *.* MEANS ALL VERSIONS OF ALL FILES (SAME AS *.*;*) + *.DAT;* MEANS ALL VERSIONS OF ALL FILES OF FILETYPE DAT + *.DAT SAME AS *.DAT;* + TEST.*;* MEANS ALL VERSIONS AND ALL TYPES OF FILES NAMES TEST TEST.* SAME AS TEST.*;* + TEST.DAT;* MEANS ALL VERSIONS OF FILE TEST.DAT + TEST.DAT MEANS THE FIRST VERSION OF TEST.DAT IT FINDS ON TAPE IF THERE ARE NO WILDCARDS IN THE UIC IF THERE ARE WILDCARDS IN THE UIC THEN THE COMMAND IS THE SAME AS TEST.DAT;* + [*,*] MEANS ALL "GROUP,MEMBER" NUMBER COMBINATIONS + [N1,*] MEANS ALL "MEMBER" NUMBERS WITH GROUP N1 + [*,N2] MEANS ALL "GROUP" NUMBERS WITH MEMBER N2 1.4 MIP COMMAND FUNCTIONS DEPENDING ON HOW YOU ENTER A COMMAND LINE, MIP EITHER COPIES BETWEEN FILES-11 FILES AND MAGTAPE OR PERFORMS A CONTROL FUNCTION. 1.4.1 COPYING FILES BETWEEN FILES-11 FILES AND MAGNETIC TAPE TO COPY FILES ENTER A COMMAND LINE WITH NO SWITCHES. THE FORMAT OF THE MIP COMMAND LINE IS: DEV:=INFILE1 (ONLY ONE FILE ALLOWED!!) WHERE: DEV IS THE OUTPUT DEVICE SPECIFIER. INFILE IS THE INPUT FILE SPECIFIER EXAMPLES: 1. MT>MT0:=TEST.DAT COPY THE LATEST VERSION OF THE FILE TEST.DAT FROM DISK TO MAGTAPE. 2. MT>MT0:=TEST.DAT;7 COPY FILE TEST.DAT;7 FROM THE SYSTEM DEVICE TO MAGTAPE 3. MT>SY:=MT:TEST.DAT COPY THE FIRST FILE WITH NAME TEST.DAT FROM TAPE TO DISK. 4. MT>SY:=MT:TEST.DAT;7 COPY FILE TEST.DAT;7 TO DISK. IF THIS FILE ALREADY EXISTS ON DISK SUPERSEDE THE DISK VERSION 5. MIP>SY:=MT:[*,*]*.*;* COPY ALL THE FILES ON TAPE TO DISK. SUPERSEDE ANY FILES ALREADY EXISTING ON DISK. 6. MIP>SY:=MT:[*,*]*.* SAME COMMAND AS [*,*]*.*;* 7. MIP>SY:=MT:*.DAT;* COPY ALL FILETYPE DAT TO DISK. SUPERSEDE WHERE NECCESSARY 8. MIP>SY:=MT:*.DAT SAME COMMAND AS *.DAT;* NOTE: THE OUTPUT SIDE OF THE STRING CAN ONLY HAVE A DEVICE SPECIFIED. THE INPUT FILE SPECIFIER DEFINES THE OUTPUT FILE. 1.4.2 USING MIP CONTROL SWITCHES THERE ARE TWO SWITCHES THAT CAN BE USED. /ZE CREATES A BLANK TAPE AND SETS UP THE TAPE HEADER /LI CREATES A DIRECTORY OF THE TAPE IN A FILES-11 FILE. A TAPE DIRECTORY COMMAND HAS ONLY AN INPUT SIDE AND IS A FULL RSX FILE SPECIFIER WITH THE DEFAULTS DESCRIBED PREVIOUSLY. DIRECTORIES CANNOT BE SENT TO NON-FILE STRUCTURE DEVICES, LIKE TTY. WHEN A DIRECTORY IS CREATED IT IS SPOOLED TO THE LISTING DEVICE UNLESS THE /-SP SUBSWITCH HAS BEEN USED. EXAMPLES: MIP>/LI CREATES A DIRECTORY OF THE TAPE ON THE DISK WITH NAME (BLANK).(BLANK);1 AND THEN SPOOLS THAT FILE TO THE PRINTER MIP>DIRECT.DIR/LI/-SP CREATES A DIRECTORY OF THE TAPE IN DISK FILE "DIRECT.DIR;NEW VERSION" AND DOES NOT SPOOL IT TO THE LINE PRINTER. 1.5 APPLICATIONS OF MIP MIP WAS DEVELOPED AS A METHOD TO DO AN INCREMENTAL BACKUP TO MAGTAPE. FILES-11 FORMAT MAGTAPE DOES NOT HAVE UIC'S AS THE DISK DOES, ONE MAGTAPE HAS ONE UIC UNDER FILES-11 FORMAT. THIS MAKES IT IMPOSSIBLE TO BE USED TO DO AN INCREMENTAL BACKUP WITHOUT SOME SORT OF UIC ENCODING. INSTEAD OF TRYING TO ENCODE THE UIC INTO THE FILES-11 NAME, MIP USES A COMPLETELY DIFFERENT FORMAT. MIP HAS A HEADER FOR EACH FILE WHICH HAS ITS UIC AND FILENAME. TO DO AN INCREMENTAL BACKUP USING MIP YOU MUST FIRST DEVELOP A COMMAND FILE OF ALL THE FILES YOU WANT TRANSFERRED TO MAGTAPE. THE CURRENT TECHNIQUE FOR CREATING COMMAND FILES IS TO RUN "SRD" TO CREATE A LIST OF THE FILES WHICH YOU WANT BACKED UP. "SRD" DOES NOT HAVE AN OUTPUT FORMAT THAT CAN BE READ BY THE RSX COMMAND SYNTAX ANALYZER SO THE "SRD" OUTPUT IS REFORMATED BY A PROGRAM CALLED "MTRANS" WHICH CRACKS THE "SRD" OUTPUT INTO RSX COMMAND STRING FORMAT. THE OUTPUT OF "MTRANS" IS AN INDIRECT COMMAND FILE TO DRIVE MIP. RUNNING THIS INDIRECT COMMAND FILE OVER A ZEROED TAPE CREATES A TAPE WITH THE FILES IN THE INDIRECT COMMAND FILE. EXAMPLE: RUN $SRD SRD>BACKUP.LST=[*,*]*.*;*/AF:DATE-MONTH-YEAR RUN $MTRANS FRT>BACKUP.CMD=BACKUP.LST/-SP RUN $MIP MIP>/ZE MIP>@BACKUP MIP>/LI THIS EXAMPLE DID THE FOLLING THINGS: 1. IT CREATED A LIST OF ALL FILES CREATED AFTER SOME DATE AND PUT THIS LIST IN FILE BACKUP.LST 2. MTRANS TOOK THE FILE BACKUP.LST AND REFORMATTED IT INTO RSX COMMAND SYNTAX, AND OUTPUT THIS COMMAND FILE INTO BACKUP.CMD 3. MIP WAS RUN AND FIRST IT ZEROED THE TAPE. THEN ALL THE FILES PICKED UP BY SRD WERE PUT ON MAGTAPE. THEN A DIRECTORY OF THE TAPE WAS CREATED AND SPOOLED OUT TO THE PRINTER. NOTES: TO EXIT MIP TYPE CONTROL Z. FOR MORE INFORMATION ON THE TAPE FORMAT SEE LISTING OF THE PROGRAM POSSIBLE ERRORS: INVALID INPUT DEVICE DISK ERROR ON FILE TAPE ERROR FILE NOT FOUND ON MAGTAPE ERROR ON SPOOLING TAPE NOT ZEROED