MVT for APL Version 2.00 User`s Manual
Contents
1. 11 Open Additional 1052 7 Terminal Emulation Windows 12 Terminate the APL 360 12 Reference Infortmalibfl ents 13 1052 7 Keyboard Map for Use with the APL Printing Element 13 IBM 1052 7 Terminal Emulation 4 41 2 13 Telnet ConnecliVily 14 PuTTY Font Rendering Quality on OS 08 244444000 14 2741 Keyboard Map for Use with the 4 Terminal Window 15 2741 Terminal Emulation 444 4 16 Telnet Connectivity 17 Recording Terminal Notes tei eas 17 Unlocking and Locking the Keyboard of the Recording Terminal 18 Automated Recording Terminal 19 Date and Time in APL360 Een peine ra rp 20 Sample APL 360 SES SIO e 20 Operating System 26 System Consoles 27 IPE m eo C 27 TSO ACC S E 28 Important 302. Page 15 The above image shows the keyboard layout used with an emulated 2741 terminal running in an rxvt4apl window Note that this layout is not identical to the keyboard of the original IBM 2741 terminal when used with an APL printing element It comprises most of the glyphs used in APL 360 and some additional ones that will return a CHARACTER ERROR when used The APL version of the IBM 2741 terminal emulation has been created by Max H Parke as an adaption of his original Hercules driver for correspondence or papertape encoded 2741s to the needs of APL 360 The device is emulated as being attached through an asynchronous line to an IBM 2703 transmission control unit The IBM 2741 emulation is accessed using the Linux or OS X native telnet client from an 4 this is an rxvt version adapted to the needs openAPL terminal window It is protocol wise fully functioning while functionality wise relying on the telnet client to present keystrokes and display characters using openAPL encoding and to handle any APL 360 specific features namely visual fidelity The combination of the openAPL font the rxvt4apl terminal window and the native Linux or OS X telnet client provides enough functionality to use the emulated 2741 terminal with APLN360 However the APL 360 character set isn t fully supported and the look and feel differs greatly from the original IBM 2741 typewriter terminal Nonetheless the
3. 34 Appendix A Ackhnowledgtmehls d 35 Appendix B About the MVT for APL 35 About the APL 360 35 About the Public Library 2 4444 4 421 2 36 About the 1 hh 36 About the Operating 36 About the MVT for APL 36 Page 4 APL 360 Resurrection In October 2012 IBM licensed the source code of the APL 360 OS Version 1 Modification Level 1 program product Program Number 5734 XM6 to the Computer History Museum Mountain View CA The license authorizes the Museum to make that source available to the general public which it did by providing it as a download from its website at http www computerhistory org atchm apl360 software license agreement Once the license agreement is accepted the APL 360 source be downloaded It is a single IEBUPDTE format file that restores to 50 source members and 38 macros making up to a total of 37404 statements in basic assembler language The source comes without any documentation On bitsavers and other internet resources many manuals APL 360 can be found But most of them rely to the 1968 Type Contributed Program or to the DOS versions of the Program Product 5736 1 or 5736 XM6 w
4. If you are not using a US English keyboard natively switch the IBM 1052 terminal emulation windows to a US English keyboard layout now except for OS X systems where this has to be done before starting the X11 system i e before starting APL 360 see MacOS and OS X Systems on page 8 for details If this is your first use of APL A360 it is recommended to have a look at the 1052 7 Keyboard Map for Use with the APL Printing Element on page 13 and read Recording Terminal Notes on page 17 now Continue with Initialize the Recording Terminal below to enable user sign on Page 10 Before users can sign on to APL 360 the recording terminal must be initialized The recording terminal is the terminal being signed on as user 314159 which is the operator OPR user So enter in one of the IBM 1052 7 terminal emulation windows 1314159 APL 360 will respond with OPR HH MM SS MM DD YY OPR Finally load the workspace by pressing ctrl a followed by entering LOAD OPFNS APL 360 will respond with SAVED 14 32 54 02 17 13 APL 360 is now ready to use and user sign on will be enabled 90 seconds after the OPR sign on message was displayed In the era of large production APL 360 systems the purpose of the 90 seconds delay was allowing the operator to set a message of the day or to perform other initial actions defined for the system You probably noticed that the value of YY in the above sign on message of the OPR user lies
5. The installer builds the executable APL 360 system from source Thus it is required to obtain the APL 360 source code before starting the system for the first time Point your browser to http Avww computerhistory org atchm apl360 software license agreement and accept the license agreement This will start the download depending on your browser settings you might have to confirm the download Open the downloaded ZIP archive and extract the source file APL36 _source_code txt to folder mvt4ap1 source Windows systems mvt4apl source Linux or OS X systems That s it You re ready to start APL 360 now Page 9 On a Windows system open the mvt4ap1 folder and click or double click depending on your settings the ap1360 bat file Note message stating that MSVCR100 dll is missing might pop up after clicking the ap1360 bat file This means that a Microsoft runtime library is missing In this case download and install http www microsoft com download en details aspx id 5555 for 32 bit systems http www microsoft com download en details aspx id 14632 for 64 bit systems On a Linux or OS X system open a shell window change directory to the mvt4ap1 folder and enter the command 1360 the shell prompt Note On OS X it is strongly recommended to manually start the X11 windowing system before issuing the apl360 command see MacOS and OS X Systems on page 8 for details If this is the first use of the system
6. 0 JUERGEN 333552 004905 01 00 13 03 08 13 03 08 09 30 00 204 204 0 JUERGEN END 004A04 1985 03 10 MVTRES 9510 IBMOS 360 HASPMOD modifies the HASP printer initialization allowing OS to own its hardcopy log and STC TSO printers Additionally it starts an OS writer to print off all STC TSO output STAGE1 is the stage 1 system generation deck the system configuration STAGE2 is the stage 2 system generation deck the output of the STAGE1 job TCxxxxS1 is a TCAM stage 1 deck representing a specific TCAM configuration TCxxxxS2 is a TCAM stage 2 deck the output of the corresponding TCxxxxS1 job edited to use compliant assembler language and comprehensive parameters and fitted with matching JCL Three different TCAM configurations have been generated matching the xxxx in the above jobnames 3270 This is the default configuration generated as load module IEDQTCAM and executed by starting the TCAM cataloged procedure It enables eight local IBM 3270 model 2 devices at addresses 0 0 0 7 XXxx 2 3335 This configuration is generated as load module TCAM3335 and executed by starting the TCAM3335 cataloged procedure In addition to the default procedure s eight local IBM 3270 terminals it enables eight dial up 3335 TWX terminals at addresses 420 423 and 440 443 attached through an 2703 transmission control unit 2741 This configuration is generated as load module TCAM2741 and executed by star
7. 28 years in the past This comes from the fact that Hercules is configured to use an epoch starting at 1960 with the system date offset to be 28 years behind the current date accommodating for the date range supported by OS 360 MVT while still having day of week day of month and month correctly set APL 360 reads the current date once at startup and from that point on keeps it as a character constant in memory Changing that constant allows setting any arbitrary date without affecting APL 360 operations The SETDATE function has been added to the OPFNS workspace for that purpose So if you like APL 360 to use the correct year in date stamps and in the date function I 25 press ctrl a and enter SETDATE MM DD YY where MM DD YY is the current date There will be no response from APL 360 to this command Enter ctrl a followed by DESCRIBE at the recording terminal for more information on the functionality provided by the OPENS workspace and read Date and Time in APL 360 on page 20 for background information on how date and time are presented in APL 360 If this is your first use of APL 360 it is recommended to conduct the Sample APL 360 Session on page 20 now Page 11 for APL system is configured to support up to 8 48 IBM 1052 7 terminal emulation windows depending on the size of the installed system being connected concurrently two of them being opened automatically at startup Additional windows can be open
8. APL system operating the recording terminal manually as described above is no problem at all Thus there is only very little incentive to automate it On the other hand recording terminal automation is for sure beneficial when operating APL 360 as AaaS APL as a Service as it was designed to be used back in the 60s and 70s That would mean running it on a server type system with telnet access enabled for remote clients The MVT for APL system comes with a very basic sample implementation of such a recording terminal automation which currently is available for Linux or OS X based APL 360 systems only Prerequisite for using that implementation is the ncat utility being installed on your Linux or OS X system ncat comes with the nmap package on most Linux distributions On OS X systems in addition a setsid command needs to be installed as OS X doesn t natively come with an equivalent to the Linux setsid command Usage of the recording terminal automation is easy Instead of initializing the recording terminal after APL 360 has started manually perform the following steps e Logon to aconsole tty on your Linux system alternatively a shell window on your Linux desktop or on OS X will work also but it is assumed that on a server system there will not necessarily be a desktop logged on all the time e Include mvt4ap1 aplopr Linux mvt4apl aplopr osx OS X or in your shell s path Enter aplopr hostname port where hostname is the
9. The PuTTY implementation that comes with the MVT for APL system requires the X11 windowing system to run If you don t have X11 installed on your Mac refer to your system s documentation on how to get it on older systems it can be installed from the installation DvD while newer ones have a stub implementation pointing to the free of charge XQuartz X11 implementation upon calling a program requiring X11 support If your OS X system doesn t use a US English keyboard natively add a US English keyboard through the Keyboard Preferences tab in the Languages amp Regions section of the System Preferences application Make sure to activate the US English keyboard before starting the X11 windowing system X11 uses the keyboard being active at X11 startup time for all windows it creates i e it ignores the keyboard setting being in effect at window creation time This in particular means that you can revert to your regular keyboard once X11 has started All native windows will then use the regular layout while the APL 360 PuTTY X11 windows continue to use the US English layout The X11 system must be set up such that it either starts automatically once an X11 application gets called or it must be started manually before running APL 360 It is generally recommended to run an X11 application for example xterm to ensure that X11 is operational before starting APL 360 Page 8 e Create folder putty sessions your home directory if it doesn t
10. at the TSO READY prompt or simply help from the PDS command line for details The MVT for APL base OS 360 MVT system has been generated using Jay Maynards cookbook style instructions as found on http www conmicro com hercos360 The resulting system has been enhanced by installing programs and usermods provided by Kevin Leonard on http Avww j76 org mvt The system and TCAM generation decks as well as any modifications and additions making up the final MVT for APL system have been stored on the system itself with the exception of Kevin s program and usermods which can be found in distribution folder software os360mvt Page 30 The system generation decks as well as small HASP modification be found in SYS1 SYSGEN CNTL as follows SYS1 SYSGEN CNTL 9 MEMBERS ON MVTRES Command gt Scroll gt CS NAME TTR VV MM CREATED CHANGED INIT SIZE MOD ID HASPMOD 000004 01 00 13 03 09 13 03 09 16 45 00 42 42 0 JUERGEN STAGE1 000006 01 00 13 03 06 13 03 06 20 38 00 254 254 0 JUERGEN STAGE2 000204 01 00 13 03 06 13 03 06 20 38 00 8505 8505 0 JUERGEN 274151 004505 01 00 13 03 08 13 03 08 09 30 00 36 36 0 JUERGEN 274152 004601 01 00 13 03 08 13 03 08 09 30 00 251 251 0 JUERGEN TC3270S1 004705 01 00 13 03 08 13 03 08 09 30 00 28 28 0 JUERGEN 327052 004801 01 00 13 03 08 13 03 08 09 30 00 158 158 0 JUERGEN TC3335S1 004903 01 00 13 03 08 13 03 08 09 30 00 32 32
11. emulation 2 Setthe time zone 3 Obtain the APL 360 source code from the Computer History Museum 4 Start the APL 360 system No Hercules or OS 360 MVT skills are required to follow the instructions given in this chapter To be as straightforward as possible technical information is kept to a minimum For technical details refer to the Reference Information chapters starting at page 13 Page 6 Before you begin download mvt4apl 2 00 current zip for the small system or mvt4apl 2 00 large current zip for the large system from http wotho ethz ch mvt4apl 2 00 and unzip it to an arbitrary folder This folder will be referred to as the mvt4ap1 folder from now on Note To update an existing MVT for APL APL 360 system to the latest level download the updates from the above website and install them in sequence following the instructions found in the README xxxx txt file that come with these updates Don t use the current systems to perform an update installation as those will create a new and consequently empty system The automated APL 360 installation and operation procedures are designed for use with emulated IBM 1052 7 terminals using a US English keyboard layout The terminal emulation uses the PuTTY telnet client to connect to the APL 360 system and the apl360i font which is the APLPLUS semi italic font encoded to the specific needs of APL 360 to display the APL character set The PuTTY telnet client comes ready to ru
12. exist already Then install the PuTTY session parameters by entering the following command in a shell window from the home directory cp mvt4apl PuTTY 0 62 for Hercules sessions APL360 OSX GTK 1 putty sessions APL360 Adapt the pathname of the mvt4ap1 folder the above command if necessary The MVT for APL system comes with a time zone setting of UTC 2 MEST Middle European Summer Time It is recommended to set the time zone in the Hercules configuration files to your current time zone such that APL 360 creates meaningful time stamps on saved workspaces and returns the correct time when the time of day function 20 is called This is done by editing the two files mvt4apl conf mvt extcons cnf and mvt4apl conf mvt intcons cnf Linux and OS X systems mvt4aplNconfNmvt extcons cnf and mvt4aplNconfNnvt intcons cnf Windows systems Open these files with your editor of choice and change the time zone offset TZOFFSET statement in line 16 or 18 respectively to the setting your Host Linux OS X or Windows system uses currently for example If your system currently uses PDT Pacific Daylight Time change it to 7 Because the license conditions don t allow redistribution of any APL 360 licensed code or derivative works MVT for APL comes without any APL 360 licensed materials installed The automated operations procedure of the APL 360 system checks upon startup whether it is installed already and kicks off an automated installer if not
13. input has been accepted the keyboard is locked and the hardcopy log printer function is resumed e When the input has been processed the cursor will not be moved to column seven and the keyboard will remain locked until the next attention signal is received That scheme works well on real terminals with a keyboard lock feature because it is simply impossible to enter anything while the keyboard is locked Today s telnet based emulation however accepts input from the keyboard at any time and generates an attention signal automatically when the user presses return Consequently APL 360 sends out the six blanks to move the cursor to column seven only after it already has received the input resulting in the output being indented instead of the input Besides being visually disturbing unpredictable side effects hangs to crashes can happen in timing sensitive situations when the recording terminal is operated in this send attention and data at once mode To get around this behavior a special send attention only function has been assigned to the ctrl a keyboard sequence of the IBM 1052 7 emulation the IBM 2741 emulation uses the ctrl c sequence for the same function So the recommended operating scheme of the recording terminal when using the IBM 1052 7 emulation is to always press ctrl a before entering system commands or APL 360 statements Page 18 For single user APL 360 systems which presumably is the most common use case of the MVT for
14. name or IP address of the system APL 360 is running on hostname typically is localhost and port is a port at which 2741 terminal defined in the Hercules configuration is listening 57424 would be a recommended port candidate when APL 360 is running on an MVT for APL system The automated operator will now do the following e Sign on the OPR account e Load the OPFNS workspace e Setthe date e Wait for the following events to occur o User PILATUS 2132 signs on In this case it will privilege the terminal which was used for the sign on The user name and number can be changed by editing the action_opr script TOD passes midnight In this case the time and date of the APL 360 system are adapted to match the new day While the automated operator is running APL 360 statements and system commands be entered at the recording terminal opposed to manual operation however an attention interrupt should _not_ be raised before making a recording terminal entry Note that entries are shown in lower case letters as opposed to manual operations on an IBM 1052 7 where they are shown in uppercase Page 19 A shutdown the APL 360 system is initiated the same way as with manual operations Just enter shutdown followed by off To prevent the automated operator from re signing on the OPR user ctrl c should be pressed as soon as a message comes up advising to do so If no ctrl c comes in within two seconds the OPR wil
15. questions It can be found at http bitsavers org pdt ibm 360 os Important Note Each run of the APL 360 system is good for one IPL of MVT only After APL 360 termination it is mandatory to shut down the MVT system When operating in automatic mode this is ensured by the fact that after an APL 360 shutdown the autopilot automatically brings the system down and terminates Hercules When operating in manual mode however you must make sure to always comply with that rule Failing to re IPL MVT after an APL 360 shutdown may cause data integrity issues particularly in the APL 360 library structure and unexpected hang or race conditions Page 26 MVT for APL system comes with two Hercules configurations e mvt4apl conf mvt_intcons cnf has an integrated IBM 3215 console defined at 009 MVT console output gets displayed at the Hercules console MVT console commands are issued from the Hercules console by prefixing them with a slash Thus to IPL this configuration only the Hercules console is required This configuration is used for automated operations e mvt4apl conf mvt extcons cnf has three external consoles defined IBM 3270s at 010 and 011 an IBM 3215 at 009 To IPL MVT using this configuration the desired consoles need to be connected to console group CONS at port 3600 using a tn3270 client for the IBM 3270s and a regular telnet client for the IBM 3215 Unused console ports must be detached before IPL to avoid MVT
16. these two modes of operation APL 360 uses the convention that the recording terminal is the hardcopy log when its keyboard is locked while it is the master console when its keyboard is unlocked This does in particular mean that the recording terminal cannot print log messages while its keyboard is unlocked and for this reason no user sign on can run to completion while the recording terminal s keyboard is unlocked APL 360 simply waits until it is able to log the sign on which it can do when the recording terminal is in hardcopy log mode only So remember A hanging user sign on almost always is caused by the recording terminal not being signed on or not having its keyboard locked The exact operating scheme defined by APL A360 for the recording terminal is as follows e Once the OPR user has signed on APL 360 locks the keyboard of the recording terminal and visualizes this by not moving the cursor to column seven as would be done after sign on of a regular user e In locked state APL 360 is not expecting input from the terminal and operates it as the hardcopy log printer e f APL 360 receives an attention signal from the recording terminal it is switched to input mode by moving the cursor to column 7 and unlocking the keyboard e unlocked state APL X360 statement or system command particularly OPENS functions and privileged system commands can be entered and the hardcopy log printer function is temporarily suspended e Once
17. 2 at the second terminal 010181 0 0441 COMM client 127 0 0 1 devtype 1052 connected 2132 006 10 28 26 04 09 13 PILATUS 6 0 Now open a third terminal following the procedure explained Open Additional IBM 1052 7 Terminal Emulation Windows on page 12 and enter 1798 at that terminal HHC01018I 0 0442 COMM client 127 0 0 1 devtype 1052 connected 1798 007 10 35 45 04 09 13 APL 3 6 0 Each user sign on will be reported on the recording terminal which should look like this now HHC01018I 0 0440 COMM client 127 0 0 1 devtype 1052 connected 314159 10 11 34 04 09 85 LOAD OPFNS SAVED 14 32 54 02 17 13 SETDATE 04 09 13 ADD 2132 PILATUS 50 ADD 1798 RIGI 50 006 10 28 26 04 09 13 PILATUS 2132 007 10 35 45 04 09 13 RIGI 1798 This demonstrates that the recording terminal now is in hardcopy log mode Page 21 Continue the sample session as follows e Start with the user display an array sign off The RIGI terminal should look like this now 010181 0 0442 COMM client 127 0 0 1 devtype 1052 11938 007 10 35 45 04 09 13 APIL 3 6 0 3 15801315 1 2 3 4 5 6 7 16 17 18 19 20 21 22 31 32 33 34 35 36 37 lt 11 lt 2 5 110 21 y 7 7 14 21 28 35 42 49 56 63 70 24 39 create and test a trivial times tables function DESCRIBE variable save the workspace under the name TIMEST
18. 40 00 51 51 0 JUERGEN BALLOON 00000A 01 00 13 01 07 13 01 07 10 47 00 23 23 0 JUERGEN END 00000B 1985 03 17 MVTRES 74 IBMOS 360 See the comment headers of the respective members for details Page 32 The following datasets are used by APL 360 APLOS ASM The assembler source members are placed in this PDS during installation APLOS MACLIB The assembler macros are placed in this PDS during installation APLOS LINKLIB assembled source members are linked into this library during installation APLOS LOAD APL 360 runtime and utility load modules are linked into this loadlib during installation APL SWAP Inactive workspaces are swapped out to this dataset when more than three users including the recording terminal are signed on APL LIB ZERO APL 360 library extend APL LIB ONE APL 360 library extend APL LIB TWO APL 360 library extend APL LIB THREE APL 360 library extend APL LIB FOUR APL 360 library extend APL LIB FIVE APL 360 library extend large system only APL LIB SIX APL 360 library extend large system only APL LIB SEVEN XA APL 360 library extend large system only ASM Local assembler source MVT for APL comes with APLSCONF member describing the APL 360 configuration in this PDS APMAINT LINKLIB Local module library APLSCONF will be assembled and linked into this library during installation APMAINT CNTL This PDS contains all jobs needed to install APL 360 and
19. 7424 as port these ports take one session each It should be noted that the rxvt4ap1 telnet 2741 combination doesn t always default to an 8 bit data path When using a 7 bit data path many APL glyphs cannot be accessed from the keyboard using the mode switch key defined in modeswitch xmap which makes working with APL 360 extremely difficult Should your system happen to default to a 7 bit data path use the following sequence of commands to start the telnet session instead of the standard telnet command shown above telnet toggle binary open hostname port The terminal being signed on as user 314159 the operator user OPR is also called the recording terminal It is crucial to APL A360 that the recording terminal is signed on and has its keyboard locked most of the time In particular APL 360 doesn t allow users to sign on when the recording terminal isn t signed on and any user sign on requested while the recording terminal s keyboard is unlocked will not complete until the keyboard has been locked As is suggested by its name the recording terminal is the hardcopy log of an APL 360 system Its primary purpose is to log user sign on and sign off times and ports In addition the recording terminal is authorized to issue privileged commands and use privileged r Page 17 Beam APL 360 functions So in total the recording terminal is a combination of being the master console and the hardcopy log of an APL 360 system To distinguish
20. ABLES clear the workspace and check the library contents connected 10 11 12 13 14 15 25 26 27 28 29 30 40 41 42 43 44 45 DESCRIBE WELCOME TIMESTABLES ENTER NUMBER SAVE TIMESTABLES 12 09 37 04 09 13 CLEAR CLEAR WS LIB TIMESTABLES OFF 007 12 10 26 04 09 13 RIG CONNECTED 1 34 41 CPU TIME 0 00 00 Page 22 TO DATE TO DATE 1 34 41 0 00 00 Continue with the PILATUS user load the TIMESTABLES workspace saved by RIGI display its contents and the DESCRIBE variable compute a times table clear the workspace 010181 0 0441 COMM client 127 0 0 1 devtype 1052 connected 2132 006 10 28 26 04 09 13 PILATUS APL 360 LOAD 1798 TIMESTABLES SAVED 12 09 37 04 09 13 VARS DESCRIBE FNS M DESCRIBE WELCOME TO TIMESTABLES ENTER M NUMBER 77 77 154 231 308 385 452 539 616 693 770 CLEAR WS Explore the public library still using the PILATUS user load the NEWS workspace from library 1 display the DESCRIBE variable display the LIBRARY variable and anything else mentioned in DESCRIBE you are interested in load the PLOTFORMAT workspace from library 1 create the plot depicted on the title page of this manual Note The PLOT function call used to create the plot isn t exactly trivial to type in if you are not used to the APL notation Because copy and paste from the manual PDF to the APL 360 session isn t possi
21. APL 360 needs to be installed from source before it can be started This is indicated by the prompt starting 360 installation Continue Y n Press return to confirm the installation which will take a few minutes to complete During this process OS 360 MVT will be four times After the fourth IPL APL 360 will come up So get yourself a coffee sit back relax and wait for the console log window to display the MVT for APL logo and the APL 360 terminal windows to open Note Fortechnical reasons the automated installation process waits at some stages for several seconds so be patient if the installation seems to have stalled It will continue shortly For enhanced robustness of the automated process several crucial commands particularly monitoring settings and replies to system requests are issued multiple times resulting in occasional IEE7011 messages These can safely be ignored On OS X the two PuTTY APL 360 terminal windows are started asynchronously from the APL 360 system itself Thus those windows will typically come up before the APL 360 system is ready to accept a sign on Do try to sign on before the console log window displays the MVT 4 APL logo Subsequent starts of the system will of course bring up APL 360 directly without performing the installation again APL 360 is now up and running It will however not accept any user sign on before the recording terminal has been initialized
22. ER LOGON READY logoff HERC 1 LOGGED OFF TSO AT 22 20 21 ON APRIL 9 1985 Message 254012 will always be displayed at the top row of the screen regardless at which row the cursor was positioned at logoff It is mandatory to press the 3270 Clear key before attempting to logon again Given the very limited native functionality of the OS 360 MVT TSO component its usability greatly depends on the third party tools available Kevin Leonard did a great job in retrofitting some well known tools from the MVS CBT tape to MVT The following tools are installed on the MVT for APL system to enhance TSO usability e COMPARE Comprehensive utility to compare sequential datasets and PDS members Enter help compare for details e REVIEW 3270 full screen browser for sequential datasets and PDS members Only basic browsing functionality is implemented the edit functionality of today s versions is not available Given that MVT s TSO doesn t natively provide an easy method to browse files REVIEW is an important enhancement There is TSO HELP member for REVIEW but basic usage help can be obtained by pressing PF1 once a dataset or member has been opened e PDS The Swiss Army Knife for PDS handling Although as compared to today s versions basic functionality is implemented only its concept of calling external functions including REVIEW and COMPARE from a command line makes it a veritable shell for working with PDS members Enter help pds
23. ERGEN END 000506 1984 11 11 1 681 IBMOS 360 Page 33 The jobs named 1APLSRC to 8CREATE perform the APL 360 installation from source when run in ascending numeric sequence To run 1APLSRC the complete source deck as downloaded from the Computer History Museum must be placed in the card reader at to run 8CREATE a valid APL 360 utility full dump tape must be mounted on 280 upon request Except for 1APLSRC these jobs are restartable to allow partial APL 360 generation For example to create a new configuration just edit APLSCONF APMAINT ASM then run DUMP it s always good to have a backup 4CONFIG 5 7 and in that sequence and mount the tape created by DUMP when 8 requests it All nxxxxxx jobs TYPRUN HOLD coded on their job cards to prevent system destruction when submitting them inadvertently All other jobs execute the APL 360 utility program s subcommand matching their member name Except for the ACCTG SELDUMP and TVERIFY jobs APL 360 must not be running when executing these jobs It is recommended to stop APL X360 and re IPL OS 360 MVT without bringing APL 360 up before executing any of these jobs except ACCTG SELDUMP and TVERIFY There isn t much documentation on the APL 360 Version 1 Modification Level 1 versions of the utility subcommandas available any more The APL 360 General Information Manual GH20 0850 1 has a complete li
24. HHC010271 Hercules version 4 00 built on Dec 31 2012 17 30 45 HHC010311 Running 210 Linux 2 6 18 194 17 4 e15 81 SMP Wed Oct 20 13 03 01018 0 0440 COMM client 127 0 0 1 devtype 1052 connected 2132 005 10 12 25 04 05 13 PILATUS 360 LOAD 1 PLOTFORMAT SAVED 7 07 27 07 21 68 80 PLOT 83 71 0 0 lt 81 5 lt 2 10 lt 2 01 714164 lt 63 1 001 XX ooo 0 751 0000 0 501 71 000 0 1 2 3 4 5 6 MVT for APL Version 2 00 OS 360 MVT 21 8F customized for use with APL 360 Version 1 Modification Level 1 User s Manual March 2013 Updated June 2014 This User s Manual applies to MVT for APL Version 2 00 See Appendix B for copyright information KK K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K The MVT for APL Version 2 00 distribution mvt4apl 2 00 features e 05 360 MVT 21 8F system designed for use with APL 360 e An automated procedure to build APL 360 and the MVT supervisor calls it relies on from source e An automated M
25. IBM 2741 implementation is structurally cleaner than what has been done for the IBM 1052 7 full implementation in the Hercules console driver without requiring more than standard telnet functionality from the client but the drawback clearly is the requirements to the telnet client it imposes For convenience openAPL openapl 0 14 tar gz and rxvt4apl rxvt4ap1 2 4 5 tar gz have been included in folder commadpt 1360 of this distribution As both openAPL and rxvt4apl are available on Linux Unix systems using X11 based desktops only using the IBM 2741 emulation on Windows currently isn t feasible e tis not necessary to install the whole openAPL system the fonts and encodings need to be extracted only To install the fonts on a Linux or OS X system perform these steps o Untar the openAPL distribution o Copy the pcf files from folder openAPL terminal XFree86 fonts to your systems folder for bitmap fonts Locations are for example usr share X11 fonts misc RHEL5 or usr share fonts X11 misc Ubuntu 12 and gzip them to end in pcf gz Then issue from this folder mkfontdir to rebuild the directory information Note the misc fonts folder might be at a different location depending on your operating system s setup of the X11 environment o The font apl8x13 will typically work out of the box while the aplox xxx fonts may raise problems getting recognized by xfs due to the dot in their names Should this be the case just alias them to
26. LIST THE COMPLETE FILE ONE MAY USE APLNOW 1 1 1 PRINT TAKES AS ITS SINGLE ARGUMENT THE INDEX AS INDICATED BY THE INDEX FUNCTION OF A NOTE FROM APLNOW AND PRINTS THE NOTE LIBRARY 1 ADVANCEDEX 2 CATALOG 3 BRFNS 5 ALGFORM 6 KINGDOM 100 BEER 1 APLCOURSE 2 STP1 3 CLASS 5 EDIT 100 CHARSET 1 NEWS 2 STP2 3 COMPLEX 5 COGO 100 SINPLT 1 PLOTFORMAT 2 STP3 3 EIGENVALUES 5 COMPCENT 100 TIMESTABLES 1 TYPEDRILL 2 STP4 3 INDEX 5 CW 100 UTILITIES 1 WSFNS 2 STP5 3 UTIL 5 MATRIXALG 2 STP6 5 SNOBOL 999 NEWSAPLMTS 2 STP7 5 SRADEMO 999 TESTS 2 STP8 LIBRARIES 1 TO 6 CONTAIN WORKSPACES THAT HAVE BEEN TAKEN FROM APL MTS WHICH IS A PORT OF A VERY EARLY APL 360 IMPLEMENTATION TO THE MTS OPERATING SYSTEM WHERE NECESSARY THESE WORKSPACES HAVE BEEN ADAPTED TO MATCH THE LANGUAGE LEVEL OF APL 360 THE WORKSPACES IN LIBRARY 1 ARE PART OF THE APL 360 DISTRIBUTION WHICH ISN T AVAILABLE ANYMORE TODAY THEY HAVE BEEN ADDITIONALLY ADAPTED TO BEHAVE AS CLOSE AS POSSIBLE AS DESCRIBED IN PART 4 AND APPENDIX B OF THE APL 360 USER S MANUAL IN PARTICULAR WORKSPACES ADVANCEDEX PLOTFORMAT AND WSFNS CAN BE ASSUMED TO BE FULLY IDENTICAL TO THE ONES PROVIDED WITH THE ORIGINAL APL 360 DISTRIBUTION LIBRARY 939 CONTAINS WORKSPACES THAT ARE RELEVANT TO APL MTS ONLY AND AS SUCH ARE MORE OF HISTORICAL THAN OF PRACTICAL INTEREST 999 TESTS HAS A FUNCTION TO DISPLAY THE FULL CHARACTERSET WHICH PROBABLY WAS USED TO SUPPORT PORTING APL 360 TO MTS AND TO CREATE THE TRANSLI
27. Page 25 This concludes the sample session The recording terminal will report the and PILATUS sign off times To terminate APL 360 press ctrl a at the recording terminal enter SHUTDOWN press ctrl a once again then enter OFF as shown below 010181 0 0440 COMM client 127 0 0 1 devtype 1052 connected 314159 OPR 10 11 34 04 09 85 OPR LOAD OPFNS SAVED 14 32 54 02 17 13 SETDATE 04 09 13 ADD 2132 PILATUS 50 ADD 1798 50 006 10 28 26 04 09 13 PILATUS 2132 007 10 35 45 04 09 13 1798 007 12 10 26 04 09 13 006 14 14 37 04 09 13 SHUTDOWN SYSTEM SHUTDOWN INITIATED PLEASE SIGN OFF NOW OFF OPR 15 42 51 04 09 13 OPR OPR 15 42 51 04 09 13 OPR CONNECTED 5 31 17 DATE 957 27 26 CPU TIME 0 00 01 TO DATE 0 01 34 This chapter provides information specific to the OS 360 MVT 21 8F operating system implementation being the base of the MVT for APL system None of this information is needed to use and operate APL 360 Maintenance Tasks like dumping APL 360 workspaces to or restore them from tape modifying the system configuration etc will however require interaction with the operating system Basic MVT or similar for example MVS and Hercules knowledge will be needed to use the information provided in this chapter which is by no means intended to be an tutorial Bitsavers have a very comprehensive collection of MVT documentation which should be consulted for general operating system
28. SP followed by nn noreq to warm start and r nn uto get the STCWTR OS writer up S TCAM to initialize TCAM alternatively procedure names TCAM3335 or TCAM2744 can be used see System TCAM and HASP on page 31 for details 5 TSO to start TSO requires TCAM to be started first To shut down a system brought up using auto none it is recommended to manually stop all services that were started in reverse order and enter z eod once everything except the master scheduler has been brought down Regardless how the system was brought up and shut down there will be no automatic Hercules power off in manual mode After having shut down the system enter at the Hercules console stopall then sysclear and finally quit to terminate Hercules The most convenient way to work with the MVT operating system is through TSO terminal sessions using IBM 3270 terminals emulated by a tn3270 client Most of the many free and commercial tn3270 clients being available will work with TSO on OS 360 MVT 21 8F The author recommends Tom Brennan s Vista 3270 Windows only commercial or the C3270 x3270 wc3270 family of clients free Windows Linux OS X The following TSO users are defined on the MVT for APL system APMAINT APL 360 maintenance user All APL 360 related work should be done using the APMAINT user 1 HERC 2 HERC03 and HERC 4 General purpose users Page 28 IBMUSER IBM default user These users are def
29. TERATION SCHEME THAT SUPPORTED OUTPUT TO NON APL CAPABLE PRINTERS WHICH HAPPENED TO BE THE ENABLER FOR BACKPORTING THE WORKSPACES TO THE PRESENT APL 360 SYSTEM 999 NEWSAPLMTS IS THE ORIGINAL WORKSPACE 1 NEWS OF APL MTS IT CONTAINS MUCH INFORMATION ABOUT THE STATUS OF THE IMPLEMENTATION AND ITS OPERATION FROM 1969 UNTIL 1980 LIBRARY 100 CONTAINS WORKSPACES THAT WERE USED PRIMARILY FOR BASIC FUNCTIONALITY AND TERMINAL BEHAVIOR VERIFICATION DURING THE IMPLEMENTATION OF THE PRESENT APL 360 SYSTEM MOST WORKSPACES ARE DOCUMENTED INTERNALLY THEIR FUNCTION CAN BE LEARNED BY LOADING THE WORKSPACE AND TYPING DESCRIBE OR IN SOME CASES HOW THOSE NOT DOCUMENTED CONTAIN VARIED FUNCTIONS WHOSE DEFINITIONS MAY BE DISPLAYED TO DISCLOSE THEIR PURPOSE AND PROPERTIES Page 24 LOAD 1 PLOTFORMAT SAVED 7 07 27 07 21 68 80 PLOT 83 4 71 0 0 lt 1 6 2 10 lt 2 01 714164 lt 63 1 00 000000 0 75 0000 0 50 0 25 0 00x 70 25 70 50 70 7510 71 000 0 1 2 3 4 5 6 7 OFF 006 14 14 37 04 09 13 PIL CONNECTED 3 39 55 TO DATE 3 46 03 CPU TIME 0 00 00 TO DATE 0 00 00
30. VT operator APLPILOT e IBM 1052 7 and IBM 2741 terminal support through an adapted version of the Hercules System 370 ESA 390 and z Architecture Emulator e An OPFNS workspace supporting APL 360 operations e A comprehensive public workspace library e Scripts and related software combining all components e The MVT for APL Version 2 00 User s Manual X X X X X X X X X FK K E CE K CK CE CK K CE CK CK CE K CK CE CE CE CE CE CE K CE CK CE CE CE CE CE CE CE CE CE CE CE CE CE CE CE CE CE CE CE OK CE CE CK CE CE CK CE CE CE CE CE CE CE CE OK CE CE OK OK CE K K K J rgen Winkelmann winkelmann id ethz ch March 29 2013 June 23 2014 X KK K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K Page 2 Table of Contents lucri reis E 5 Installation Use of 6 Prepare the Terminal 44444 21 7 OWS Sy SUTIN SNNT ATTE 7 Linux SUING 8 OS X SySIBITIS 8 Set the Time Zone 9 Obtain the APL 360 Source Code 9 Start the AP annann anaana asiaan 10 Initialize the Recording
31. all putty This will give you a perfectly working GTk 2 based PuTTY implementation on your Mac However the Hercules compatibility patch is installed temporarily only i e it gets removed once a new PuTTY version is uploaded to Macport and port upgrade is run Symptom of the patch removal is that your PuTTY sessions don t connect to Hercules any more Should this happen run port uninstall putty followed by the final three steps above make APL 360 use this implementation perform the following steps e Install mvt4apl Fonts apl360i semi italic ISO 8859 1 ttf using Fontbook System wide installation might be considered but user only will do also e Edit file mvt4apl conf ap1360 parm to contain the line export USE SYSTEM PUTTY 1 the line is already in the file but without the parameter value being set to 1 e Copy mvt4apl PuTTY 0 62 for Hercules sessions APL360 Linux to your putty sessions folder using new name of APL360 i e remove the Linux suffix Note that Linux suffix isn t a typo from copy paste here Once using GTk 2 the PuTTY session parameters for OS X and Linux are identical Your APL 360 system will now use the newly installed GTk 2 based PuTTY and you ll see a notable improvement in APL glyph display quality FREE Ceo gt gt m JE JEJESIC m JL e openAPL X11 Keyboard Overlay PC 101 Key
32. ap1360 client Linux or OS X manual open mvt4aplNapl360 client bat Windows manual mvt4apl scripts client linux Linux automatic open after APL 360 startup and mvt4aplNscriptsNclient windows Windows automatic open after APL 360 startup to call it with appropriate connection parameters In addition to the connection parameter settings used for the preconfigured PuTTY sessions a sample HyperTerminal parameter file is also provided mvt4ap1 HyperTerminal Configuration APL ht allowing you to get up and running with HyperTerminal if you prefer HyperTerminal over PuTTY If you intend to use any other telnet client it is recommended to carefully compare the sample session parameters provided for PuTTY or HyperTerminal and adopt them to your preferred client Being a Hercules console device the telnet client connects to the regular Hercules console port As to not affect the functionality of regular Hercules IBM 3270 IBM 3215 or IBM 1052 consoles the APL 360 specific functionality is activated for an 1052 device if it is member of a console group named APL only The MVT for APL system comes preconfigured with this setting When running the MVT for APL system you will typically connect your telnet client to localhost port 3600 using a terminal type of 1052 APL to select the appropriate console terminal type and group X11 isn t the native windowing system on Macintosh systems Consequently even after having installed the X11 applica
33. be a fully functional APL 360 system at the latest service level of the MVT for APL distribution in one of the following flavours Smallsize system o The workspace size is 36000 bytes which is the APL 360 default o Amaximum of 16 terminal sessions 8 IBM 1052 and 8 IBM 2741 can connect and sign on concurrently o Amaximum of 4 sessions is held in main storage concurrently e Large size system o The workspace size is 432000 bytes which is the maximum APL 360 supports o Amaximum of 56 terminal sessions 48 IBM 1052 and 8 IBM 2741 can connect and sign on concurrently o Amaximum of 10 sessions is held in main storage concurrently The APL 360 system will come up with two IBM 1052 7 terminal emulation windows using the PuTTY telnet client additional ones up to a total of 8 or 48 depending on the size of the system installed can be opened as needed As mentioned above the present APL 360 implementation also features 2741 terminal emulation Both the IBM 1052 7 and the IBM 2741 emulations work with a variety of telnet clients as long as certain protocol font and character set encoding requirements are met Modifying the terminal configuration to use the IBM 2741 emulation is outside the scope of this chapter See the Telnet Connectivity sections on pages 14 and 17 for details if you want to change the terminal configuration Four easy steps need to be performed to get APL 360 up and running 1 Prepare the terminal
34. ble due to encoding differences file mvtapl doc plotformat sample txt is provided It contains the PLOT call encoded for the apl360i font and can be pasted into the PuTTY session the PuTTY paste function is assigned to the right mouse button on Windows and the middle mouse button on Linux or OS X Open the file in an 8 bit clean viewer then copy the whole line and paste it into the APL 360 window sign off LOAD 1 NEWS SAVED 21 52 22 03 29 13 DESCRIBE WORKSPACE 1 NEWS PROVIDES INFORMATION ABOUT THIS APL 360 SYSTEM WHICH WAS RESURRECTED IN AN EFFORT TO PRESERVE AS CLOSE AS POSSIBLE THE ORIGINAL DISTRIBUTION APL 360 IS A MULTIUSER SYSTEM RUNNING ON IBM MAINFRAME HARDWARE OF THE 60 S AND 70 S ENTER ABOUT CREDITS LIBRARY TERMINALS INDEX APLNOW M D Y OR PRINT I FOR SPECIFIC INFORMATION OR ALL Page 23 DISPLAY ALL INFORMATION AVAILABLE ABOUT PRINTS VERSION AND COPYRIGHT INFORMATION CREDITS PRINTS A LIST OF ACKNOWLEDGEMENTS LIBRARY PRINTS A TABLE OF CURRENT PUBLIC WORKSPACES TERMINALS SUMMARIZES THE TERMINALS SUPPORTED CURRENTLY AND THEIR CAPABILITIES INDEX PRINTS INDICES DATES AND THE FIRST FEW WORDS OF EACH NOTE IN APLNOW APLNOW TAKES AS ITS SINGLE ARGUMENT A THREE ELEMENT VECTOR REPRESENTING A DATE AS MONTH DAY YEAR APLNOW PRINTS NOTES ON THE RESURRECTION HISTORY AND THE PRESENT SYSTEM ONLY THOSE NOTES ENTERED INTO APLNOW ON OR AFTER THE DATE GIVEN AS ARGUMENT ARE PRINTED TO
35. e APL 360 on emulated hardware Acomprehensive public workspace library which has been imported from APL MTS port of the Type III version of APL 360 to the MTS operating system Amongst many others the public library includes the 1 workspaces carefully adapted to be as close as possible to those delivered originally using information found in the APL 360 User s Manual e The Hercules System 370 ESA 390 and z Architecture Emulator with 1052 7 and IBM 2741 terminal support adapted to the communication and character set requirements of APL 360 No OS 360 MVT or Hercules skills are required to install and operate the system To use APL 360 however basic knowledge of the APL language is advantageous Although Page 5 minimal APL 360 session is provided as a sample this documentation is not meant to be APL 360 tutorial Having original APL 360 documentation at hand is required to get acquainted with the APL 360 system and language Bitsavers have a vast amount of documentation available that can be downloaded from http bitsavers org pdf iom apl To start using APL 360 download at least e GH20 0906 1 APL 360 OS DOS Users Manual Jan73 pdf e 5210 0007 0 APL 360 Reference Card pdf e GH20 0850 1 APL 360 OS DOS General Information Manual Dec70 pdf Installation and Use of APL 360 This chapter presents automated procedures to install and operate a new APL 360 system a Windows Linux or OS X host The result will
36. ed as follows a Windows system open the mvt4ap1 folder and click or double click depending on your settings the ap1360 client bat file On a Linux or OS X system open a shell window change directory to the mvt4ap1 folder and enter the command 1360 client at the shell prompt If you are not using a US English keyboard natively switch the newly opened IBM 1052 terminal emulation window to a US English keyboard layout now except for OS X systems where this has to be done before starting the X11 system i e before starting APL 360 see MacOS and OS X Systems on page 8 for details To terminate APL 360 press at the recording terminal and enter SHUTDOWN APL 360 will respond with SYSTEM SHUTDOWN INITIATED PLEASE SIGN OFF NOW Now press and enter OFF APL 360 will respond with OPR HH MM SS MM DD YY OPR OPR HH MM SS MM DD YY OPR CONNECTED HHHH MM SS TO DATE HHHH MM SS CPU TIME 55 TO DATE 55 and terminate shortly The automated operator APLPILOT will detect the APL 360 termination and bring OS 360 MVT to an orderly halt which in turn will be detected by Hercules automated operator HAO and cause it to terminate Hercules Page 12 Reference Information 4 7 Ahlan fr enn seat rha AD Drint Claman IVI 052 M A for Use with the Printing Element The above image shows the original keyboard layout used on IBM 1052 a
37. eld of the Hercules System Log window This method gives full control over IPL operations and shut down e Runthe mvt4aplXstart herc bat Windows or the mvt4apl start Linux or OS X script to start Hercules which will present the Hercules console window Page 27 Create the desired MVT console configuration as described in System Consoles page 27 for the mvt4apl conf mvt extcons cnf Hercules configuration Enter 350 the Hercules command prompt and press return When message IEA101A SPECIFY SYSTEM PARAMETERS FOR RELEASE 21 8F MVT is displayed on the master console press enter If you have defined IBM 3270 consoles switch them to roll mode Enter K S on each one and accept the proposed set of parameters by pressing enter a second time Now reply to message 00 IEE114A DATE yy ddd CLOCK hh mm ss REPLY WITH SET PARAMETERS OR U as follows o 00 uto complete IPL and start APL 360 This is equivalent to Fully Automated APL 360 Operations and consequently when shutting down APL 360 the APLPILOT will perform an orderly MVT shutdown o 00 auto ny to complete IPL without starting APL 360 This is equivalent to Automated OS 360 MVT Operations without APL 360 starting TCAM TSO and HASP but not APL 360 To shut down enter c3po shutdown at an MVT console o 00 auto none to just complete IPL Neither the APLPILOT nor any tasks will be started You may manually enter S HASP to start HA
38. hich were designed to run under DOS or standalone but not under OS 360 As functionality is very close the primers user guides and reference manuals suffice perfectly when it comes to working with APL 360 but the installation and system generation manuals aren t very useful To make things worse there is also none of the original installation materials available any more neither the sample jobs used to assemble link and execute APL 360 nor the distribution tape which is needed to initialize the library DASDs and load the OPFNS and the famous LIB 1 workspaces that were delivered with the Program Product The purpose of the MVT for APL distribution mvt4apl is to close the gap and provide the information and tools necessary to get APL 360 OS Version 1 Modification Level 1 up and running on OS 360 MVT 21 8F in accordance with the given license conditions It comprises A ready to run OS 360 MVT 21 8F system configured to accommodate APL 360 but not containing any copyrighted code e An automated procedure to build APL 360 and the MVT supervisor calls it relies on from source An automated operator APLPILOT for the OS 360 MVT system e Aminimal automated operator for the recording terminal which is intended for server type Linux or OS X systems to enable deployment of AaaS APL as a Service The MVT for APL Version 2 00 User s Manual A partial reimplementation of the OPFNS workspace with sufficient functionality to operat
39. ined without passwords all have the OPER ACCT and JCL attributes assigned Connect a tn3270 client to port 3600 of the system running MVT for APL which usually will be localhost The following logo will be displayed Hercules Version 4 00 Host name HPM9180 Host OS Windows 6 1 7601 7 Enterprise Edition 64 bit Host Architecture Intel R x64 Processors LP 4 Cores 4 CPUs 1 LPAR Name HERCULES Device number 0 00CO Subchannel 0015 E WX ay wh jd 4 4X7 EF T fy fau Fu Version 1 IAr g Modification Level 1 _ 5734 XM6 c Copyright IBM Corp 05 360 21 8F f eu 1969 1970 1972 _ S 1 5 277 S 370 ESA 390 z Architecture IJ is Emulator Press the 3270 Clear key then message 254012 ENTER LOGON with logon user where user is one of the users listed above Press the 3270 Erase EOF key to delete the rest of the 254012 message then press enter After a successful logon the screen will look like this logon 01 HERC 1 LOGON IN PROGRESS AT 21 50 35 ON APRIL 9 1985 NO BROADCAST MESSAGES READY The colors will of course vary according to the mapping defined in your tn3270 client for the 3270 protection and highlighting attributes Page 29 Enter logoff at the TSO READY prompt to logoff the session After a successful logoff the screen will look like this IKJ54012A ENT
40. l get signed on again inhibiting shutdown completion Read the comment headers of the scripts in mvt4ap1 aplopr Linux or mvt4apl aplopr osx OS X for details on the automated APL 360 operator APL 360 handles date and time in a somewhat special way when compared with computer systems being in use today e The current date is fetched once at APL 360 startup only This date is used throughout that whole execution of the system i e it is never updated regardless how long APL 360 is up e The TOD clock is not reset to zero at midnight It just continues to count For example If it is now 10am and APL 360 was started three days ago then it will report the date of three days ago as the current date and 82 00 00 10 plus three times 24 as the current time From today s perspective that is really weird But from the perspective of the APL 360 developers it had the advantage that generating usage and performance histograms was much easier as when permanently having to convert hours and days forward and backward At least they definitely looked at it more as being a feature than as being a bug Over the many years of existence of APL 360 one can see in every version of the various manuals time stamps of saved workspaces in the above weird format and they never bothered to fix this Looking at the APL 360 source reveals that it would need less than 100 lines of code to change that behavior to what one would expect to see today Being a
41. menting emulations of complex communications equipment and topologies With the availability of APL 360 running on OS 360 MVT under Hercules he added the functionality and features required by APL 360 to the 2741 device support to provide a true generic implementation of the most commonly used APL terminal back in the APL A360 era Tony Harminc made information about APL internal structures workspaces libraries control blocks available that was very helpful in creating the initial library setup Jay Maynard s cookbook style MVT system generation instructions enabled getting up to speed with OS 360 MVT quickly Kevin Leonard provides a lot of tools namely PDS COMPARE and REVIEW and usability enhancements for OS 360 MVT on his website that helped transforming the MVT system initially meant as a runtime only environment into a veritable development system Phil Roberts extracted the public library workspaces from APL MTS This was a major effort including installation of MTS and APL MTS exploring how to execute APL MTS and how to print output unlocking hidden functions putting together some 4 000 APL statements to extract and finally print the full contents of the workspaces APL 360 Version 1 Modification Level 1 is Program Number 5734 XM6 Copyright IBM Corp 1969 1970 1972 The APL 360 source code has been licensed to the general public by the Computer History Museum 1401 N Shoreline Blvd Mountain View CA 94043 See http www co
42. mputerhistory org atchm apl360 software license agreement for license APL 360 is written in Basic Assembler Language for System 360 mainframes running under an OS 360 MFT or MVT operating system It comprises 37404 lines of code Page 35 The license doesn t allow redistribution of the source code or of any derived works executables etc For that reason the MVT for APL distribution doesn t contain any APL 360 licensed source or executables To use APL 360 the source must be downloaded using the above link therby accepting the license terms prior to the first execution of the MVT for APL system Upon first execution a fully automated procedure assembles the source and generates the executable APL 360 system Workspaces in libraries 1 2 3 5 6 and 999 have been created by adapting workspaces from APL MTS to the APL 360 language level APL MTS is IBM s APL 360 on volumes 5 0T1 5 0T2 of the MTS distribution archive which is Copyright 2011 by the Regents of the University of Michigan acting as agent for the MTS Consortium and licensed under the Creative Commons Attribution 3 0 Unported License CC BY 3 0 See http creativecommons org licenses by 3 0 for license details The present APL 360 implementation runs on an IBM System 370 model 158 mainframe emulated by the Hercules System 370 ESA 390 and z Architecture emulator which is Copyrighted c by Roger Bowler and others Hercules is licensed and dist
43. n authentic resurrection a great deal of effort has been put into implementing APL 360 without changing a single byte of code Thus a correction of the weird date and time behavior clearly is out of scope of the given implementation should be noted however that the CORRDATE function provided with the OPFNS workspace allows for correction of date and time on the fly when called once per day after midnight followed by a sign off and sign back on of the OPR user This method is used by the automated recording terminal operator mentioned in the previous chapter After having initialized the recording terminal the APL 360 adventure begins Conduct the following sample session to create your first user accounts and verify some basic functionality The system comes empty the OPR user is the only one defined as it is needed to get started Thus the first step is to define regular users Signal attention and enter ADD NUMBER NAME QUOTA at the recording terminal to define any user you like For the sample session user 2132 named PILATUS and user 1798 named are defined with a quota of 51 saved workspaces each Page 20 010181 0 0440 COMM client 127 0 0 1 devtype 1052 connected 314159 OPR 10 11 34 04 09 85 OPR LOAD OPFNS SAVED 14 32 54 02 17 13 SETDATE 04 09 13 ADD 2132 PILATUS 50 ADD 1798 RIGI 50 Note that both ADD commands don t yield a reply Now you re ready to sign on the newly created users Enter 213
44. n with MVT for APL There are however a few configuration steps required to install the apl360i font and the telnet parameter settings on your system and to make a US English keyboard mapping available if your system isn t setup with a US English keyboard natively e Open folder mvt4aplNFonts and install the apl360i semi italic SYMBOL ttf true type font using the procedure recommended for your Windows version On Windows XP or older this means drag and drop the file into the C NWindowsNFonts folder on newer systems it s right clicking the file and selecting Install from the context menu e Open folder mvt4aplNPuTTY 0 62 for HerculesNsessions and click or double click depending on your settings the file APL360 Windows reg to merge the PuTTY session parameters into the registry Allow any permission requests Windows might present until it confirms successful registry insertion e f your Windows system doesn t use a US English keyboard natively add the US English input scheme with a US English keyboard to your list of input schemes and activate the display of the language bar in the taskbar using the Region and Language menu of the control panel This allows setting the keyboard layout of the IBM 1052 7 terminal emulation windows to US English without affecting your native keyboard settings Page 7 Open folder mvt4ap1 Fonts and install the apl360i semi italic ISO 8859 1 ttf true type font using the procedure recommended for
45. nd IBM 2741 terminals when equipped with the APL printing element The keyboard layout of an IBM 1052 7 terminal emulation window is exactly the same thus providing a fully authentic APL 360 experience IBM 1052 7 Terminal Emulation Notes The 1052 7 emulation is implemented as a modification of Hercules console c driver which emulates 1052 3215 and 3270 terminals Thus APL 360 sees it as a 1052 model 7 not as a full function remote 1052 1052 7s typically were used as integrated console printer on smaller System 360 models and in an APL 360 environment probably were used primarily as the recording terminal and not so much for real APL work These console printers often didn t even have attention or backspace keys as those were separately orderable features which lead the APL 360 developers to use Shift Z for backspace and Shift X for linefeed On the one hand this yields ugly results on paper printing a c APL symbol instead of backspacing and a APL symbol instead of performing a line feed while of course still executing the requested line editing functions On the other hand it preempts the and gt symbols from being used within APL which fortunately isn t a problem as no function is assigned to these symbols at the APL X360 language level To overcome the ugly behavior of backspace and line feed the 1052 emulation has been implemented such that it behaves as a local 1052 7 towards APL 360 only while it behave
46. no third party copyrights are affected Page 36
47. ributed under the terms of the Q Public License Version 1 0 See http www hercules 390 eu herclic html for license details According to the terms of the license an unmodified copy of the license text has placed in folder doc and all patches applied to Hercules to adapt it to the communication and character set needs of APL 360 have been placed in folder software Hercules of the MVT for APL distribution APL 360 Program Number 5734 XM6 was designed to run under an OS 360 operating system For the present implementation the final version 21 8F of IBM s OS 360 MVT operating system was chosen which is in the public domain The MVT for APL distribution is the glue that combines the many components making up an APL 360 system while fully adhering to the restrictive license conditions of the source code The OS 360 MVT setup the automated procedure to build the APL 360 executables and the MVT supervisor calls from source the automated MVT operator APLPILOT the IBM 1052 7 terminal support the handcrafted initial library structure on DASD the APL MTS public workspace import and adaption the minimal OPFNS workspace the automated recording terminal operator and the present User s Manual have been created by Juergen Winkelmann who also put together the MVT for APL distribution The MVT for APL distribution itself and the components named in the above paragraph are put into the public domain without claiming any copyright by the author as far as
48. running out of WTO buffers This configuration is used for manual operations Both Hercules configurations have an HTTP server listening at port 8360 allowing Hercules console communications even when running in daemon mode Any IPL method valid for OS 360 MVT system running on real iron is of course working with the MVT for APL system too But for the specific use cases three methods are recommended This is the method described in Start the APL 360 System on page 10 It is meant to enable a user to just work with APL 360 without even needing to know that there is Hercules and OS 360 MVT under the hood There is no console input required neither at the Hercules nor at the MVT level Console interaction is nonetheless possible using the HTTP server listening at port 8360 This method provides a fully automated IPL of the MVT system in the same way as the Fully Automated APL 360 Operations does but it does not bring up APL 360 It is meant to be used for APL 360 maintenance and to run APL 360 utility subcommands that are not usable while APL 360 is running To use this method simply run the mvt4ap1 os360 mvt bat Windows or the mvt4apl 0os360 mvt Linux or OS X script This brings the system up to the point where TSO logons are enabled and HASP is ready to process batch jobs Console interaction is possible using the HTTP server listening at port 8360 To shut down the system enter f c3po shutdown in the Command fi
49. s as a full function remote 1052 towards the user s telnet session So Shift Z doesn t print a c but backspaces instead and Shift X doesn t print a gt but performs a linefeed while printing a v down caret instead Additionally the keyboard s backspace key is assigned the same function as Shift Z So from the user side all keyboard functions work exactly as described in the APL User s Manual for 1052 terminals with the only exception that Shift X has to be used for linefeed and that c and 5 cannot be used as APL symbols Shift Y of course may still be used for backspace but one typically will tend to use the real backspace key for that Notable is in particular the seamless visual fidelity simulation and the printing of input using the red ribbon as is described in the manual Removing the ambiguity between the c and gt symbols and the backspace and linefeed functions would require 2 byte change to the original APL 360 code which isn t done in this Page 13 implementation for reasons of authenticity It eventually might be done a later modernized version The IBM 1052 7 emulation should work with any telnet client that negotiates successfully with the Hercules console telnet server and is able to use the apl360 or apl360i font Tested are HyperTerminal Windows only and PuTTY Windows Linux and OS X The MVT for APL system comes preconfigured with PuTTY but any other compatible one be used by adapting mvt4apl
50. something else by manually editing the fonts alias file o Arebootis recommended to be sure the new fonts got picked up by xfs Page 16 o Copy files ap12741 xmap modeswitch xmap from openAPL terminal XFree86 keymap to a convenient location home directory for example they will be needed at execution time e Install 4 using the usual configure make make install approach Review Max Parke s readme rxvt4apl txt and readme txt files for further instructions Once the fonts encodings and rxvt4apl are installed the following command sequence can be used to open an rxvt4apl window for use with the IBM 2741 emulation replace fontname with the name of one of the openAPL fonts installed above xmodmap 12741 xmodmap modeswitch xmap rxvt4apl meta8 fn fontname ls 8 The two xmodmap commands need to be issued once per Linux desktop or OS X XQuartz session only To open multiple rxvt4ap1 windows just repeat the 4 command as often as needed To start an APL X360 session in an rxvt4apl window issue the native Linux or OS X telnet command in that window telnet hostname port where hostname is to be replaced with the hostname or IP address of system running the Hercules emulator and port with the port at which the desired 2741 device is listening When running the MVT for APL system you will typically use localhost as the hostname and one of 57411 to 57414 or 57421 to 5
51. st of the subcommands without specific usage information The documentation of the older Type contributed APL 360 program 360D 03 3 007 has a more detailed description of the then available subcommands Both manuals can be found on bitsavers Provide an authentic look and feel visual fidelity on 2741 terminals low priority Consolidate 1052 and 2741 behavior to provide a more seamless user experience low priority Optimize 1052 coding to use tables instead of nested if else constructs very low priority Page 34 Shustek Chairman the Board of Trustees Computer History Museum Mountain View went through 10 years of persistent negotiations with IBM to make the impossible happen Obtain a license to make the APL 360 source code available to the public for non commercial use Brian and Barry Silverman shared many insights they gained during their 1998 APL 360 resurrection project especially on how to handcraft a library structure DASD This greatly helped overcome the chicken egg problem of how to create an initial library setup without having the original distribution tape available Catherine Lathwell spread the word when the APL 360 source became available and provided the connection to Len Shustek Max H Parke provided the IBM 2741 terminal support Having created the Hercules device driver for the 2741 and other asynchronous terminals attached to an IBM 2703 TCU Max is most knowledgeable when it comes to imple
52. ting the TCAM2741 cataloged procedure In addition to the eight local IBM 3270 terminals and eight dial up 3335 TWX terminals supported by the TCAM3335 configuration it enables eight IBM 2741 dial up terminals at addresses 400 403 and 480 483 attached through an IBM 2703 transmission control unit It should be noted that the TCAM2741 procedure allocates the same IBM 2741 terminal addresses as does APL 360 So the TCAM2741 procedure must not be started while APL 360 is running Page 31 source for the autopilot APLPILOT and the balloon memory placeholder to enforce the APL 360 region being loaded at a compatible location can be found in SYS1 SETUP ASM as follows SYS1 SETUP ASM 4 MEMBERS ON MVTRES Command gt Scroll gt CS NAME TTR VV MM CREATED CHANGED INIT SIZE MOD ID APLPILOT 000007 01 00 13 03 19 13 03 19 21 40 00 131 131 0 JUERGEN BALLOON 000103 01 00 13 01 07 13 01 07 09 22 00 45 45 0 JUERGEN R2D2 000106 01 00 13 03 19 13 03 19 21 40 00 318 318 0 JUERGEN WAITAAPL 000305 01 00 13 03 19 13 03 19 21 40 00 69 69 0 JUERGEN END 000402 1985 03 17 MVTRES 563 5 360 jobs to generate the above tools be found SYS1 SETUP ASM as follows SYS1 SETUP CNTL 2 MEMBERS ON MVTRES Command gt Scroll gt CS NAME TTR VV MM CREATED CHANGED INIT SIZE MOD ID APLPILOT 000007 01 00 13 03 19 13 03 19 21
53. tion as outlined in MacOS and OS X Systems on page 8 it by far isn t as feature complete as on current Linux or Unix systems The PuTTY terminal emulation uses the Gnome Toolkit to interface with the X11 system As doesn t come with the XQuartz X11 application a minimal GTk 1 implementation has been included with MVT for APL While GTk 1 fully supports all functionality PuTTY needs it doesn t interface with the X11 freetype rendering system for TrueType fonts To circumvent this problem the xfstt font server is used to provide the APL 360 TrueType fonts to the X11 system through its classic font rendering interface resulting in quite a vintage display of the APL glyphs to say the least For a better font rendering quality GTk 2 is needed which is able to use the freetype library Unfortunately distributing GTk 2 with MVT for APL isn t feasible due to the huge amount of prerequisites GTk 2 has and the many installation variants possible But it is easy to install GTk 2 and PuTTY using the Macports system So the following approach can be used for a more contemporary font rendering experience Page 14 e Install Xcode Macports e Run port install gtk1 e Run port install gtk2 e Run port install pkgconfig Run port patch putty e Now apply the patch found mvt4apl PuTTY 0 62 for Hercules source putty 0 63 hercules patch to the PuTTY source found in the Macports source tree e Run port s inst
54. to operate the APL 360 utility program See below for a member list The jobs to install APL 360 and to operate the APL 360 utility program can be found in APMAINT CNTL as follows APMAINT CNTL 17 MEMBERS ON 1 Command gt Scroll gt CS NAME TTR VV MM CREATED CHANGED INIT SIZE MOD ID 1 000007 01 00 13 03 22 13 03 22 14 09 00 65 65 0 JUERGEN 2MKLINK 000101 01 00 12 11 11 12 11 11 17 09 00 87 87 0 JUERGEN 3MKLOAD 000104 01 00 12 11 11 12 11 11 17 09 00 25 25 0 JUERGEN 4CONFIG 000106 01 00 13 03 22 13 03 22 14 09 00 15 15 0 JUERGEN BAPLGEN 000201 01 00 12 11 11 12 11 11 17 09 00 95 95 0 JUERGEN 6LNKSVC 000204 01 00 12 11 09 12 11 09 21 45 00 33 33 0 JUERGEN 7MKLIB 000301 01 00 13 03 22 13 03 22 14 09 00 54 54 0 JUERGEN 8CREATE 000303 01 00 13 03 22 13 03 22 15 10 00 33 33 0 JUERGEN ACCTG 000305 01 00 13 03 22 13 03 22 12 16 00 29 29 0 JUERGEN CREATE 000307 01 00 13 03 22 13 03 22 12 16 00 31 31 0 JUERGEN DUMP 000401 01 00 13 03 22 13 03 22 12 16 00 30 30 0 JUERGEN INCDUMP 000403 01 00 13 03 22 13 03 22 12 16 00 30 30 0 JUERGEN RESTORE 000405 01 00 13 03 22 13 03 22 12 16 00 30 30 0 JUERGEN RETRIEVE 000407 01 00 13 03 22 13 03 22 12 16 00 32 32 0 JUERGEN SELDUMP 000501 01 00 13 03 22 13 03 22 12 16 00 32 32 0 JUERGEN SELREST 000503 01 00 13 03 22 13 03 22 12 16 00 30 30 0 JUERGEN TVERIFY 000505 01 00 13 03 22 13 03 22 12 16 00 30 30 0 JU
55. your Linux system Procedures may vary greatly depending on the Linux distribution and version Besides performing a system wide installation by copying the font into a designated true type font folder and updating some caches see Reference Information on page 13 for examples on many Linux distributions a local installation font is usable by the current user only can be done by simply clicking or double clicking the font to view it and pressing some Install button on the font viewer panel Create folder putty sessions in your home directory if it doesn t exist already Then install the PuTTY session parameters by entering the following command in a shell window from the home directory cp p mvt4apl PuTTY 0 62 for Hercules sessions APL360 Linux putty sessions APL360 Adapt the pathname of the mvt4ap1 folder in the above command if necessary If your Linux system doesn t use a US English keyboard natively add a US English keyboard to the list of keyboards available and activate the keyboard applet on your desktop How keyboards are added how the keyboard applet is named and how it is activated varies greatly amongst Linux distributions and versions so refer to your system s documentation for that Once done verify that you can change the keyboard layout on a window by window basis which is required to set the keyboard layout of the IBM 1052 7 terminal emulation windows to US English without affecting your native keyboard settings
Download Pdf Manuals
Related Search