mus62_updates.txt ----------------- Last updated: Jan 23, 2008 This location contains updates that can be applied to the 6.2 MUSIC/SP Demo system (see download file musdemo_b.zip). For each update xxxx, there is an xxxx.mfarc archive file, and usually a corresponding description file xxxx.txt and a file xxxx_nams.txt which lists the MUSIC/SP file names contained in the archive. The description file xxxx.txt briefly summarizes the update or package, gives any additional instructions for applying it, and gives the specifications of the archive file, including size, MD5 and SHA1 digests, 8-digit CHECKSUM, etc. It also lists the prerequisites, if any, for the update or package. If the update is available as a .zip file, for example xxxx.zip, the .zip file contains the other files (xxxx.mfarc, etc.) Use WinZip (or an equivalent utility) to unzip the files. The .mfarc files here are binary MUSIC/SP archive files, which can be restored (unpacked) to individual MUSIC/SP files by running the MFREST utility on a MUSIC/SP system. (These .mfarc files are not compatible with PC utilities such as WinZip.) In most cases, the MFREST option REPL=T (replace existing files) should be used when restoring an archive. Updates should be applied in the same order as listed below, i.e. in chronological order. Before running MFREST, it's a good idea to check the .mfarc file by using both the MFCHEK utility and the CHECKSUM command. For details on how to get the .mfarc file to MUSIC/SP and restore the files it contains, see the instructions later in this file. NOTE: Previous updates to the 6.1 Demo system must not be applied to a MUSIC/SP 6.2 system, since the 6.2 system already contains all those updates, and applying any of them to 6.2 may down-date some files and cause compatibility problems. 6.2 Update Date Contents ---------- -------- ------------------------------- fort2pl1 Sep 17, 2006 Fortran-to-PL/1 converter. ssppli Sep 17, 2006 360-era SSP (Scientific Subroutine Package), single-precision PL/1. watbol Oct 24, 2006 Watbol (University of Waterloo Cobol compiler) for MUSIC/SP. Please read the Conditions of Use in file watbol.txt. upd1 Nov 17, 2006 FTPD port range, SENDMAIL, MOVEPDS, etc. assist Dec 15, 2006 ASSIST 4.0/A (1975) by Penn State University. S/360 assembler and execution environment. upd2 Jan 15, 2007 Updates to HTTPD, FTPD, WEB, MFCHEK. stpascal Feb 3, 2007 Stanford Pascal compiler, MUSIC/SP Script. fortg Jul 15, 2007 Fortran G compiler and library, LOADPDS, DLINK, DELINK, and other utilities. upd3 Aug 14, 2007 Fortran G fixes, nucleus update (including file creation times), miscel. programs, documentation, and Help files. gccmu11 Oct 16, 2007 GCCMU 1.1 - GCCMVS C compiler for MUSIC/SP. upd4 Jan 23, 2008 Nucleus update for XRegion high-memory areas and 31-bit address mode. Updates to MVS emulation, help and documentation files. How to apply an update file to MUSIC/SP --------------------------------------- The .mfarc files here are binary files in MUSIC/SP archive format. (They are not compatible with PC utilities such as WinZip.) Some earlier updates use the extension .arc instead of .mfarc. Once you have transferred a .mfarc file to MUSIC/SP, you run the MFREST utility program under MUSIC/SP to restore (unpack) the individual files it contains to the MUSIC/SP Save Library. In most cases, if a file being restored already exists, it should be REPLACED. The options that should be used in the MFREST job are: ALL=T,REPL=T,SETUI=T,SETBUP=T,LIST=T See the sample MFREST job below. LIST=F can be used if you wish to omit the detailed listing output (which you probably should do for updates which contains a very large number of files). **** Some update files start with a Rexx program that makes the .mfarc file an executable (self-restoring) file. For these files, all you have to do is execute the .mfarc file: type the name of the file (for example xxxx.mfarc) at the *Go command line after logging in to the administrator id $000 on MUSIC/SP (press F3 to exit from the Admin menu first). Whether an update file is executable is indicated in the description file (xxxx.txt) for it. Another way to apply an update is to run the APPLYUPD interactive utility. Just type applyupd at the *Go command line and answer the prompts. Both the self-restoring archive method and APPLYUPD have the advantage that they automatically check the archive file before restoring it, they check for enough free disk space, they add a record to the log file $gen:upd.log, to record the fact that the update was applied, and they construct the required MFREST job for you. **** It is also important to apply the update files in the order they are listed (that is, in order of increasing date), since a file in one .mfarc may be updated by a later .mfarc file. For the same reason, the Replace option (REPL=T) must be used in each restore job. Before restoring files to MUSIC/SP, make sure you have enough free unfragmented space in the MUSIC/SP Save Library. You can run the LIBSPACE utility on MUSIC to check the free space. Type on the command line: fv libspace That runs LIBSPACE, captures the output to a temp file, and edits the temp file. Use PgUp (F7), PgDn (F8) to navigate up and down in the file. The Sim390 web site (Tech Info page), MUSIC/SP file $pgm:addspace.txt, and Jan/2004 postings to the H390-music discussion group detail how to add space to the Save Library. Basically, you need to either extend the existing MUSICX volume, or add a new FBA-512 volume to the system (e.g. call it MUSICY). Then allocate a new Save Library data set (SYS1.MUSIC.ULnn where nn is the next number), format it (FORMAT utility), initialize it (ULINIT), add it to the system catalog, and re-IPL. Note that you need enough free space for the .mfarc file AND the unpacked files from it, unless the .mfarc file is in another location (such as a UDS file, which is outside the Save Library). After restoring the files from a .mfarc file, you can delete it if you like. Be sure to read the description and instructions in the .txt file for the update. In some cases, you must execute some files after restoring the files from the .mfarc file, and then re-IPL MUSIC/SP. This may be needed, for example, if members need to be updated in the Load Library. (This is automatic if you execute the .mfarc file or use APPLYUPD - just answer yes when the restore asks for permission to execute the required file.) Please note that after updating members in the Load Library, you MUST RE-IPL MUSIC/SP FOR THE CHANGES TO TAKE EFFECT. The Windows command-line program md5file.exe (available in winprogs.zip from the Sim390 download page) can be used to check the MD5 digest of a file on the PC. Use it to verify that a file has been downloaded correctly, and is authentic. The CHECKSUM command on MUSIC performs a similar function (but is less secure, since it does not use a cryptographic check sum). The program sha1file.exe can be used to check the SHA1 digest of a file. The following instructions use file xxxx.mfarc as an example. Replace xxxx by the actual update name. These instructions assume you are using the Sim390 emulator. For Hercules, see below. More details on MUSIC/SP's FTP client and server can be found in MUSIC/SP file $tcp:ftphelp.txt. 1. Download the xxxx.zip file to your PC or Linux/Unix machine. Use WinZip or equivalent to unzip the files to a directory. You should see xxxx.mfarc (or perhaps xxxx.arc) and associated text files such as xxxx.txt. Check the MD5 or SHA1 digest of the .zip and/or .mfarc files. 2. Use the FTP client on PC or Unix to upload xxxx.mfarc to your MUSIC/SP system. You must allow for the large file size and specify the record format (RECFM) as FC (fixed compressed) and the record length (LRECL) as 80. For example, using Windows ftp.exe and assuming FTPD listening port 621 on MUSIC/SP: ftp open localhost 621 (enter userid $000 and its password) type binary quote allo 4000000 quote recfm fc quote lrecl 80 put xxxx.mfarc bye 3. Run CHECKSUM on MUSIC/SP to verify the $000:xxxx.mfarc file. The CHECKSUM value is listed in the xxxx.txt. This verifies that the file was transferred correctly. 4. If you want to get a list of file names contained in the archive, before restoring them, use the Editor to type the following lines into a file, then execute the file: /file 1 n($000:xxxx.mfarc) /inc *com:mfchek units=1,names=t,info=f 5. For updates that are executable, just run the .mfarc file by typing its name in the *Go command area of userid $000 (press F3 to exit from the Admin menu first). This automatically checks the archive file, checks for enough free space, and runs the required MFREST restore job. This is the recommended way to apply executable updates. -OR- If your MUSIC/SP system has the APPLYUPD utility, you can use the interactive command APPLYUPD to apply a .mfarc or .arc file. Type applyupd in the command area and answer the questions. -OR- Enter the following lines into a MUSIC/SP file, via the Editor, and execute the resulting file (i.e. type its name in the command area at the *Go prompt): /file 1 n($000:xxxx.mfarc) /inc *com:mfrest input=1,list=t,all=t,repl=t,setui=t,setbup=t The option repl=t tells MFREST to replace existing files. The option setbup=t is normally not used, but can be used when a large number of files are being restored; it causes the restored files to be marked as backed up; this facilitates future runs of the MFARCH archive/backup maintenance utility. You can use list=f if you do not want a listing of the restored file names. The option setui=t causes the original file attributes (dates, etc.) to be restored, which is strongly recommended. 6. If any additional steps are required for the particular update file, do them. This would be indicated in the description (xxxx.txt). For example, you may have to update some members in the system Load Library. The instructions may tell you to execute 1 or more files that were restored from the .mfarc file; to execute a file, just type its name at the *Go command prompt. After executing the file(s), you may have to re-IPL MUSIC for the changes to take effect. A re-IPL is normally required after updating or adding any Load Library members. NOTE: For a .mfarc file that is executable, this step (if required) is automatic if you execute the .mfarc file at the command line or use APPLYUPD. Just answer yes when you are asked for permission to execute the required job. (But the re-IPL of MUSIC/SP, if required, is still your responsibility.) Notes for MUSIC/SP under the Hercules emulator ---------------------------------------------- The above procedure assumes that TCP/IP (FTP) can be used to transfer the .mfarc file into MUSIC/SP. This is fine for Sim390, but Hercules normally does not provide TCP/IP socket support for MUSIC/SP. For the Hercules case, get the .mfarc (or .arc) file to your PC or Unix/Linux system, then use ONE of the following methods: - You can use the VOL2FILE MUSIC/SP utility program to read the .mfarc file as a volume file and copy it to a MUSIC/SP file. For details, see messages # 262 (Sep 30, 2005) and # 272 (Oct 12, 2005) on the H390-music discussion group, or see the file on the TechInfo page of the Sim390 web site. (I find that this is the easiest way to transfer an archive file to Hercules MUSIC/SP.) Define the .mfarc file as device 305. For example: "attach 305 3370 c:\temp1\xxx.mfarc" (as a command to Hercules). IPL MUSIC/SP and run VOL2FILE. Use RC to check that the return code is 0. Rename the resulting MUSIC/SP file temp.arc to xxx.mfarc. Do "checksum xxx.mfarc" to verify the result (compare the checksum with the web page). -OR- - Include the .mfarc data in a MUSIC/SP batch job (MFREST with input=5) which is read on the emulated card reader device 00C, device type 3505. You must include the required JCL before and after the data, and you must specify the options ebcdic and eof in the Hercules config file for device 00C. NOTE: This method does not work for .mfarc files larger than about 1.8 MB, unless you increase the size of MUSIC/SP's system data set SYS1.MUSIC.BATCHIN. For details, see file text_to_herc.txt on the TechInfo page of the Sim390 web site. -OR- - Instead of a .mfarc file, use a UDS volume file, if available. The MUSIC/SP command APPLYUPD can apply an update that is contained in a UDS file. Basically, the MFREST input data is contained in a UDS file on the volume, rather than in a Save Library file xxxx.mfarc. -OR- - Create your own temporary UDS volume, from the .mfarc file. (Details to follow.) -OR- - Shut down your Hercules MUSIC/SP system, and bring it up under Sim390, with the same FBA volume(s) (e.g. musicxd.vol). Apply the update under Sim390. Then shut down Sim390 MUSIC/SP and bring it up under Hercules. This method works because Sim390 and Hercules use the same format for FBA (3370) volumes. You cannot use this method if your MUSIC/SP volumes are CKD or CCKD.