Prime IDR 4130 User Manual Download Page 203

Page: 203 / 223

Summary of Contents for IDR 4130

Page 1: ...THE PRIME USER S GUIDE PRlME Computer IDR 4130...

Page 2: ...3 This guide docunents the operation of the Prime Canputer and its supporting systems and utilities as implemented at Master Disk Revision Level 17 Rev 17 PR1ME PRl 1EO mputer Inc 500 Old Connecticut...

Page 3: ...omputer oorporet Ion assunes no resp msibility for any errors that may appear in this docunent he software descr ibed in this docunent is furnished under a license and may be used or copied only in ac...

Page 4: ...1 Setting Tenninal Characteristics 2 12 3 ACCESSING PRIMCE IntrodLCtion 3 1 Accessing the Systan 3 2 Directory operations 3 2 Systan Information 3 5 File Operations 3 8 Completing a W lrkSession 3 10...

Page 5: ...rror Messages 7 3 8 CCMMAND FILES ANDFHANTCMS CommandFile Operations 8 1 CommandFile Iequi renents 8 2 The COMINPUT Command 8 2 The COMOurPl1l Command 8 6 phantom Users 8 1 9 BATCH JOB PROCESSING Intr...

Page 6: ...RARIES Applications Library 13 1 Sort and Search Libraries 13 9 Operating System Library 13 10 PART IV ALTERING THE CCMMAND ENVIROOMENT 14 lEING RDY AND ABBREV Chang ing the PRCNPI Message 14 1 Creati...

Page 7: ...eyboard Input C 1 ASCII Character Set Non Printing C 2 ASCII Character Set Printing C 3 D ERROR MESSAGES Introdoction D 1 SEG Loader Error Messages 0 2 Loader Error Messcges D 4 Run Time Error Message...

Page 8: ...Part I Using Prime Documentation...

Page 9: ...og in how to create manipulate list and delete files and directories am how to log out when you re done Section 4 explains how to enter files programs text files and data files using Prime s editor an...

Page 10: ...explains how to handle magnetic tapes punched cards and punched paper tapes on Prime Section 12 explains PRIMENET Prime s networking facility and tells howusers can take advantage of it Section 13 pr...

Page 11: ...y that does some task you need to do or whether you ll have to wri te your own Read Section 14 when you ve becane someYklat famil iar with the system to discover some more sophisticated conveniences P...

Page 12: ...ands and util ities explained in this guide am the Larquaqe guides will carry most appl ications progranmers throujh most of their AQrk For those mo need more detailed references each topic discussed...

Page 13: ...ssembly Language 17 IDR4130 INTRODOCTIOO SYSTEMADMIN l DEBUGGER 1 SUBROUTINES 1 LOAD SEG I PRIMOS COMMANDS __ __ _ Primos Detailed Reference PUI SUBSET G PRIMENET I DPTX J REMOTE JOB ENTRY High Level...

Page 14: ...ide AssembIy Lan J uage For assembly Larquaqe progranmers and for anyone Interest ed in learning about Prime s computer architecture there are The PMA Progranmer s Guide The System Architecture Refere...

Page 15: ...creen fonnats to facilitate data entry The guide that explains how to do it is The FORMS Guide SPSS a statistical package for the social sciences is useful to applications progr ers who need statistic...

Page 16: ...1004 GRT8 or ICL 7020 you can find out how to handle them in The Remote Job Entry Guide PR08RAMMER 8 CQ 1PANI008 Prime also provides a series of handy pocket sized reference sunmaries on many of its...

Page 17: ...Part II Writing and Running Programs...

Page 18: ...your own special characters or change the characteristics of your terminal This section explains all of them in the above order INTRODUCING PRIMOS All Prime computers from the 350 up use a common oper...

Page 19: ...Since the number of phantom users on a system is limited phantoms are not always available he Batch environment explained in Section 9 allows users to submit non interactive command files as Batch job...

Page 20: ...tems files may also be stored on magnetic tape for backup or for archiving PRIMOS maintains a separate User File Directory UFD for each user to avoid conflicts that might arise in assignment of filena...

Page 21: ...ORT I O Object Translators RPG IDAD or SEG DELETE Input to Binary FI N PMA CCBOL Binary Editor FlJrIL DELETE SEG or Ullill PL I Binary EDB Binary Editor Libraries Editor EDB Saved UlN TAP PSD DELETE R...

Page 22: ...one UFD named BEECH in all the logical disks 0 through 62 When that is the case the volume or logical disk name may be omitted and PRIMOS will search all the logical disks starting from 0 until the UF...

Page 23: ...UFD E __ Not all subdirectories and files are shown This is the subdirectory BRANCH 5 This is the subdirectory TWIG37 This is the file LEAFS This is the file souiRREL Not all the UFOs are shown I I I...

Page 24: ...directory is BEECH B H5 the commands OK SLIST BEECH BRANCH5 TWIG9 LEAF3 and OK SLIST TWIG9 LEAF3 have the same meaning he symbol as the first directory in a pathname means home directory Current Oisk...

Page 25: ...fore beginning to type the next command However since each character echoes as the user types it output from the previous commandmay appear on the terminal jumbled with the commandbeing typed ahead Ty...

Page 26: ...f an uppercase word is underlined the underlined letters indicate the minlinum legal abbreviation Wbrds in Iower case Lowercase letters identify parameters appropriate numerical or text value The user...

Page 27: ...in uppercase The rare exceptions will be specified in the commands where they occur SPECIAL TERMINAL KEYS CON rROL The key labeled COOTROL or CI RL charq es the meani rq of alphabetic keys Holding dow...

Page 28: ...different erase character Question mark Default kill character for PRIMOS and all subsystems Each question mark deletes all previous characters on the line The PRIMOS command TERM allows the user to...

Page 29: ...characteristics remain in effect until u reset them or trrt i I u log out he commonly used TERMoptions are listed below Typing TERM with no options returns the full list of TERM options available The...

Page 30: ...EFORE YOU GET STARTED Option Function NOXOFF Disables X OFF X ON feature default DISPLAY Returns list of currently set TERM characters Also displays current Duplex Break and X GN X GFF status 2 13 Jan...

Page 31: ...elves respond to subcorrmands or extensive dialogs However most users can do 99 percent of their program developnent us irq about a dozen coomands This section Int roduces the essential commandsneeded...

Page 32: ...example is the password on the login directory user nunber also 24 hour format be word NIX in this During login a misspelled UFD will cause the message Not found L0 3IN to be displayed A misspelled or...

Page 33: ...o any UFO has no working directory If a command such as LISTF is entered while in this state the message NO UFDATTACHED is returned as in To remedy this condition the user must ATTACH to a UFD A BEECH...

Page 34: ...rolling File Access The PASStID conmand replaces any existing password s on the working directory with one or two new passwords or assigns passwords to this directory if there are none The format is P...

Page 35: ...es When directories or subdirectories are no longer needed they may be removed fran the system to provide more roan for current work If the directories are empty they may be removed by the DELETE comm...

Page 36: ...ces devices are available User priorities Other user numbers Your phantom user nunber Fbr logging out your phantans Net rk information Tells if network is available Current nodename Records available...

Page 37: ...ning Ehvironnent for a printer Batch users Your active Batch jobs Batch queue status Batch queue configurations Gives parameters for printer s operations Identifies executing jobs number of jobs per q...

Page 38: ...ame old name is the pathname of the file to be renamed and new name is the new filename For example cn tools more test oldtest he file named MORE TESTin the UFD TOOLS is changed to OLDTEST Since no di...

Page 39: ...by this command They must be deleted by sm s own delete comnand explained in Section 5 or by FlJI IL s IREDELcorrunand explained in Section 10 Controlling File Access Assigning passwords to directori...

Page 40: ...rotection keys associated with any newly created file or UFDare 7 QJ The owner is given ALL rights and the non owner is given none Default values for the PROTEC corrmand oowever are 0 Thus the ccemard...

Page 41: ...to log out after every session This closes all files and releases the PRIMOS process to another user However if you forget to log out there is no serious ham done The system will automatically log ou...

Page 42: ...n that line switches the Editor from one mode to another Input r tJde The INPl1l mode is used when ent er Irq text information into a file e g creating a program The rd INPUTis displayed at the user s...

Page 43: ...e followed by a is null am a RETURN at that point will switch the alitor into the other mode In input mode the semicolon is equivalent to a CR ends a line of input In edit mode semicolons in a charact...

Page 44: ...ritten added to an ex l st irq source progran with conjunction with the TABSET command Comments may be easily the OVERL Y c and in Findin J a Line by Label or Statenent Number l1le FINDcommand may be...

Page 45: ...1 TO 10 APPEND DO 1 1 TO 10 NEXT 2 X I J A I 8 I CHAJI K EIJIJ X I J A I B I TOP PRIT PRINT 99 NULL DO 1 1 TO 10 IX J l TO 10 X I J A I B I Y I J SQRT X I J END I J LOOP I END I I LOOP I 8CJI TO v1 F...

Page 46: ...ITI IT END EDI f FILE F IN TEST OK ED Fm TEST EDIT PRINT 20 NULL A 3eJ B 40 C A B RUNT l0 C CALL EXIT END BOTTCM NE IT 3 PRINT 10 C TABSET7 45 INSERT leJ FORMAT rHE ANSWER IS 14 TOP PRINT 213 NULL A 3...

Page 47: ...s function Acceptable command abbreviations are underlined Especially useful commands are indicated with a bullet Fbr a detailed descr ipt Ion of all comnands see the Fiii tor Ieference Section of The...

Page 48: ...n l the Deletes all lines up to but not including line containing string Deletes n lines from current file and writes them into filename De faul t n l Sameas DELETE TO but writes deleted lines into fi...

Page 49: ...which may contain leading and trailing blanks Moves pointer forward occurrence of str ing poInte r s current post tion of file to each bet een and end Prints characters as real characters if rity s o...

Page 50: ...ve string or contents of buffer 2 into buffer I NEXT n Moves the point e r n lines forward or backward default n l NFIND string M ves pointer down to first 1 ine NOT beginning with string NFIND _ stri...

Page 51: ...fil ing text he current line is replaced by string Changes a symbol name to character Current defaul t values are Ncme fau1t Characters KILL ERASE WILD BLANK TAB ESCAPE SEMICO CPRCMPI DPRCJt1PT It A...

Page 52: ...low to obtain a copy of a source file on the system line printer Renaming Programs may be renaned with the PRIMa commandCNA 1E Section 3 You must have owner status in the UFDin order to use this comma...

Page 53: ...her by pathnane fbwever SPOOL will refer to bonh by their filencmes that is EXAMPLE and UPDATE Checkirg the Queue command Ib check the status of the Spool Queue give the SroOL LIST PRIMa returns a lis...

Page 54: ...the appropriate hour specify the DEFER option by SroOL pathnarne DEFERtime The format for time is HH MM WPM If AM or PMis given HH v1M the colon is optional must be in 12 hour format e g 1000 PM Other...

Page 55: ...spool requests If no destination folows AT then no default has been established and spool requests without destinations may be intercepted by any available printer EliminatiIl3 Headers To have files...

Page 56: ...mpt You can then type a QUITto em the session You can also type IIINPurll to return to input mode or u can give var ious format t irq comnards explained in the PRIMCS commands Reference Guide A sample...

Page 57: ...This section will consider features cammon to all compilers INVOKING THE Ca1PILER The compiler is invoked from PRIMOS command level by the command compiler pathname options compiler is is written the...

Page 58: ...to create an object file The default name of this file is B filename For example suppose the source file is TEKMAN EXAM TEST 11 this file were compiled the default object file Y Ould be B TEST in the...

Page 59: ...Create listirg file called pathname LISTINGTTY Print listing file at terminal LISTINGSroOL Print listing file on line printer CROSS REFEREflCE Each Lanquaqe has its particular cross reference listing...

Page 60: ...many mathematical calculations To generate 321 mode code use the 321 option in the commandline as in F77 CHEERS 321 LOODING All code generated in 64V or 32I mode is loaded with SEG This procedure is...

Page 61: ...iled by the high level language compilers may also call or be called by procedures written in Prime s assembler language FMA The fol Iowirq cautions bowever should be observed All I O routines should...

Page 62: ...programs up to 256 segments per user program 32 Megabytes Access to V mode instructions and architecture Prime 350 and up for faster execution Abil ity to install shared code a single copy of a proced...

Page 63: ...ubprocessor NORMAL LQn DING Loading is normally a simple operation with only a few straightforward cornmarrls needed SEG has many additional features to optimize runfile size or speed perform difficul...

Page 64: ...ntify the unsatisfied references and load them If the unsatisfied references are the result of having misspelled some subroutine names you may want to initialize and re do the load 6 SAVEthe runfile I...

Page 65: ...E QUIT OK THER MOOE LOADER Main program first Separately compiled subroutine next Shared COOOL library always used Non Shared library used with separately compiled subroutines MIDAS library used with...

Page 66: ...ontrol until a QUITor PAUSE subcommandreturns control to mIMOS or an EXOClITE subcomnarrl starts execution of the Loeded program Load subcommandscan be used in commandfiles but comment lines result in...

Page 67: ...o set the addressing mode if necessary The default is 32R mode 4 Use loader s LOADsubcommand to load the object file B_filename and any separately compiled subroutines 5 Use loader s LIBRARY subcomman...

Page 68: ...d level or quit from the loader and start execution throoqh the PRIMOSRESUMEconmard An example of such a load is OK FILMEM OK LOAD OC La B_BENCH9 LI LON C lvtPLETE SA BEN H9 QU OK Order of Loading The...

Page 69: ...execution SEG should be used for runfiles created by sm s loader it should not be used for pr oqr an memory imeqes created by the R mode loader Example OK SEG ff TEST THIS IS A TEST user requests pro...

Page 70: ...rogram that has returned control to PRIMOS for example because of an error a FCRTRANPAUSE or CALL EXIT statement If ST RT is typed without a value for start address the program resumes at the address...

Page 71: ...file system subroutine calls or the ope rat Irq system A list of run time error messages is given in Appendix D Error messages specific to execution of segmented programs are Label ed 64V mode Some e...

Page 72: ...d conmards from a comnard file which is a file conca iriirq PRIMa commands utility stbcanmands and dialog responses The user creates the file with the Editor r ms it under CQ 1INPIJI to verify operati...

Page 73: ...d input files can be made self docunentirg by inclLrl i n j canment lines at PiUMOS conmand level A line beq i nni rq with a slash and asterisk is interpreted as a comment and is ignored by PRIMOS If...

Page 74: ...AK interruption of execution of a canmand file The TTY END and PAUSEoptions are used only within command files The CONTINUE and START options are typed by the user The TTY or END option must be the fi...

Page 75: ...END Chaining Cbmmand Files The CONTINUE option of C JIINPur allows command files to be chained The following example illustrates the chainirg of three conmarrl files and shows how file unit confl icts...

Page 76: ...CCMINPUT CONI INUE is reached in C MAPS control returns to the statement followirg the call in C L DrEST lNhich closes the file mit used for C MAPS Wlen CCMINPUT CONTINUE is reached in C LOl DrEST co...

Page 77: ...t be used in a canmand input file as it closes all files including the commandinput file from which this commandis read he message Unit not open Caminput Input fram terminal will be printed and input...

Page 78: ...to an existing file PAlEE Stop output to commandfile leave file open CONTINUE Resumeoutput halted by PAlEE to the command output file or if at PRIMOSlevel re open an exist Irq CQ 10IJI PUT file am pos...

Page 79: ...time information for identification as an aid to program development and debuqq Irq For exanpl e the sequence of commands CCJI1 0 0 TESTl DATE DATE CCMO END creates a file 0 TESTl command the next li...

Page 80: ...m is optimized Example The command input file C BENCH07 contains the followiTB CCMO 0 BENCH07 TIMINGTEST OF BENCH07 PROGRAM DATE GET STARTTIMEVALUES TIME S FTN TEST GETS lDP TIMEVALUES TIME COVlO END...

Page 81: ...06 15 3 560 3 924 Sex FTN TEST he answer is 70 OK 10 06 18 0 287 1 051 CCMO END PHl NTCM lEERS The phantom user feature allows command file processing without tying up a terminal Once a phantom proces...

Page 82: ...are the same as the current and home directories of the user or commandfile invoking the phantom If the phantom is invoked by the command PH pathname the phantom s current am home directories are bot...

Page 83: ...ogged out only if the terminal has the sane log in UFO as that which ini tiatErl the phantom Phantom STATUS Information The STA IU3 USER command discussed in Section 3 provides a list of all the users...

Page 84: ...EST LO B FTN TEST LI MAPM LQ1 DTEST7 M n P M UNSATISFIED3 QU PHANTOMTEST COMPLETED DATE CCMO E would normally go here It has been anitted so the logout sequence could be shown in the canoutput file LO...

Page 85: ...LOADTEST7 MAP M UNSATISFIED 3 QU OK PHANTOMTEST COMPLETED DATE Friday october 5 1979 10 06 AM OK COMO E 1 o Ould normally go here It has been ani tted 00 the logout sequence could be sh wnin the canou...

Page 86: ...e t imes hus extranely long jobs such as file updat es am backups can be set up as Batch jobs during the day then run under operator control at night Each Batch queue is a separate entity defined by t...

Page 87: ...uocirq the job s job id nunber and ranirxlin J the user if he didn t use the HCJo1 E option of the home UFOfor the job For exanple OK job pnjob JOB rev 17 2 Your job 015 was sti lmitted to queue Norma...

Page 88: ...or CPl IME FUNIT number Specifies the file unit to be used for commandinput Permissible values range fran 1 to 16 to 1 to 126 depending on the limit set by the Systan Administrator Default deperrls on...

Page 89: ...ridden by givirq a different value for the same parameter in the JOB coomarrl For instance if you specified JOB RESEARCH CPI IMENOOE in your file but wanted to run the job in a queue which had a CPU t...

Page 90: ...tirguish between the RESTART YEs No option am the RESTART coomand The option always takes an argunent it signals whether or not a job may be restarted he RESTART command takes arqunentj it attanpts to...

Page 91: ...f information to be sbown while the jobname and job id options allow the user to specify the jobs on which he wants information as follows Option job id Description jobname AS digit nunber assigned to...

Page 92: ...LAY queuencme Identifies and gives full characteristics for each queue if queuename is not specified If queuename is specified gives characteristics for that queue only For excmple OK batgen display n...

Page 93: ...delta rlevels am short timeslices are best for short jobs he queue in the exanple is designed for average jobs Note If the SystemAdministrator has not read enabled the BATDEF file the BA roEN command...

Page 94: ...Part III System Facilities...

Page 95: ...ost sorts are done on ASCII files also called compressed files such as those created by the text ed ltor ED The following discussion anphasizes how to do ASCII sort s In addition SOOT can process unco...

Page 96: ...es is a straight SORT resp mds by requesting The name of the file to be sorted he nane of the output fil e to be created The mmber of keys for the sort default is 1 Simple File and Key Specifications...

Page 97: ...t brief input chaos l input chaos 2 output order keys 2 1 l I52 r BFnINNING SORT PASSES 2 ITEMS 10 SOR REV17 OK If you are sor t Irq uncanpressed or fixed Lerqth files or if UU are sorting binary file...

Page 98: ...keys Ihree canmon nuneric keys for ASCII sorts are U nunbers without plus or minus signs LS numbers preceded by plus or minus signs Numberswi tbout signs are considered p sitive TS numbers followed by...

Page 99: ...er SORI MERGE Y Ould sort am then merge insor t ed files The sort and merge process has now been taken over by SORT itself freeinJ SORI MERGEto do a true mergesort i e a merge of preso r ted files A M...

Page 100: ...LEII NUMERIC ASCII LEADING EM3EDDEDSIGN TEll NUMERIC ASCII TRAILING EMBEOOEDS I N IlPOII PACKED DOClMAL AUII ASCII UPPER LCliER CASE SCRT EQUAL D ULT IS ASCII 8 17 19 25 1 5 r INPUT THE NLMBEROF ADDIT...

Page 101: ...esynchronize file comparison Defaul t 3 lines REPORT filename Produces a file with specified filename containing the differences found between compared files in lieu of displayirg them at the terminal...

Page 102: ...ptions The first file specified is treated as the original file and it is assuned that changes have been made to this file to produce the other files Pathnanes may be used to specify files to be merge...

Page 103: ...eep tr eck of the contents of directories involved in the copy or delete processes FUl IL allows operations on files within User File Directories UFOs am segment directories Invoki n J FUl IL To invok...

Page 104: ...G I Specifies directory fran which files or are to be copi 00 Accepts a pathnane home directory directories Default is The general formats of these comands are COPY filenane new name filename new name...

Page 105: ...FurIL dialog for this particular situation is OK FUTIL FUTILrev 17 0 FROM l MARINE NAurILl 6 copy HITS MISSESZEROES QUIT OK The files HITS and ZEROES formerly MISSES are now in our home directory SEC...

Page 106: ...files are to be copied he current directory in this situation is NAtJrILlE rufIL allows you to move to other directories with the ATTACH subconmand abbreviated A It is not necessary to return to PRIM...

Page 107: ...he directory HOLIAND and its entry in MARINE Similarly to delete segment directories and MIDAS files use the TREDEL option as shown Situation 3 To delete the contents of CLASSIFIED appear Irq on the c...

Page 108: ...s fran one segment directory to another If to FOsition is ani tted copy goes to sane post tion as or ig inal lIbte that COPY from name to poai tion and COPY fr om post tion to name are also legal COPY...

Page 109: ...IFIL LISTSAVE filename level FIRST _IZE ROTEC gwUX K TYPE Q_ATE PAS9IlD Same as LISTF with the ISTFIL option specified but writes output to filename ROTECfilename owner access Inon owier ecceasl l Set...

Page 110: ...RESIW pathnane Lock rnmber Sets per file read write lock for all files in pa tbnane UFOCFY Copies entire FRQ 1 directory into TOdirectory UFDDEL Deletes entire FROM directory UFDPRO owner access non o...

Page 111: ...appropriate utility 3 Relinquish exclusive use of the device Unassigning AssigniI l3 a Device AssigniI l3 a device gives the user exclusive control over that peripheral device The FRIMOS level ASSIGN...

Page 112: ...read irq deck im e CR0 Use device CRe defaul t au Use device au Source deck header control cards are set up as follows Source deck Colunns 1 and 2 of representation deck header card BCD 6 EBCDIC 9 AS...

Page 113: ...R EDIT INPUf PTR EDIT FILE filencme OK 1 N PTR Assign tape reeder Invoke Editor Switch to EDITmode Input from tape reader Tape is be irq read File input under filename Unassign tape reader MAGNETIC TA...

Page 114: ...that particular drive If the drive is busy WAITqueues the request Assignirg a drive by log ical device number says Give me any tape dr ive and call it nunber Ldn The ALIAS option suppl ies the nunber...

Page 115: ...in subsequent mag tape operations Logical am ilysical device nunbers can be used Irrtercharqeeb ly in MAGNET MAGSAV and MAGRST dialogs bowever to avoid confusion give M1 GRST MAGSAV the logical device...

Page 116: ...ice nunber can be used to refer to the drive in question in subsequent mag tape drive operations 1ike MAGSAV he log ical device number is mapped into or associated with the physical device nunber in a...

Page 117: ...se ASSIGN ER 01 systems where all mag tape requests are monito red the request above w uld be acknowledged with the sane message but a slight delay would be observed Ihe operator has to answer each re...

Page 118: ...must be handl ed by the operator ASSIGN MTX ALIASMT4 The operator is requested to assign any available tape drive as logical device 4 A message is displayed at the user s terminal Ird Icat Inq hich ph...

Page 119: ...canplete with all the options FOr exanple OK AS MTl ALIS MT0 RINGOFF ALIS not implemented or improper use of argunent ASSIGN Usage ASSIGN MTn ALIASM nn optionS ASSIGN MTX ALIASMTn options Options TPI...

Page 120: ...y performs one or more specific functions MAGN E l for both Prime and non prime format files am tapes Readin J files fran tape to disk with optional unblockirg or character translation Writing files f...

Page 121: ...o poas ibl e dur irq these operations ANSIlevel 1 volune labels of certain labeled tapes can be read with the LABEL coomand LABEL can also be used to write a label on an mlabeled tape See the PRIMOS C...

Page 122: ...e file nunber tape file nunber is the file rumber on the tape A positive integer causes the tape to be resound and then pos itioned to the file nunber a 0 causes no reposf t Ionirq of the tape LOOICAL...

Page 123: ...nted out DONE tape records REJ ROO READ disk records DISKRECmOO OurPUT OK Use of the tape drive unit should then be relinquished by UNMTpdnor ALIAS Ldn DUPLICATING MAGNETIC PES MAGNE I can copy am rea...

Page 124: ...er position on tape where file will reside NUmEROF FILES TOCOPY Enter nunber of files to be copied If copyi entire tape enter a large nunber operation ceases when EOTis reached DONE This means the ope...

Page 125: ...V operation If selected the record size is printed after the REVstamp of the MAGSAV dialog MAG3AV Dialog Summary The MAGSAV dialog is sunmarized Suggesterl user responses are Lnd ic at ed below pranpt...

Page 126: ...on above Note A logical tape results fran single invocation of MAGSAV It is a unique entity with its own header etc It may be a portion of a physical tape or a complete physical tape or it may span on...

Page 127: ...ecifies 7 track tape defaul t 9 MAGRST dialog summary The MAGRSTutility displays a series of questions and messages which are summarized alorg with appropriate responses and descriptions below Prompt...

Page 128: ...nter one of the options following YEs Restores entire tape and returns to PRIMOS NO Causes first pranpt to be reissued 1 filename n Prints tape index to n levels at tenninal dur irq restore Index can...

Page 129: ...s read and control returns to PRIMOO Note A runaway tape condition can occur if there is only one logical tape on the currently mounted reel of tape am the user specifies a number greater than 1 in re...

Page 130: ...ed in the previous MAGSAV sanple session TAPE EX is used in this exanple al so OK MlIGRST REV 17 0 YOUARE NOT TI ACHED TO AN MFD TAPE UNIT 9 IRK 0 ENTERIDGICAL TAPE NUftBER 1 N AME MAGTAP mTE MIII DD...

Page 131: ...files in such directories File data is transmitted across the network the local CPUdoes the processil l3 Use a PATHNAME with a stbsystEm such as the El Htor to access a file on a renote disk For exan...

Page 132: ...he process breaks reconnects the terminal message to a ranote processor the comnand LOGOUT Icqs the remote connection over PRIMENET and to its local system not logged in The WAIT DIOCONN TED FROM xxx...

Page 133: ...us irq the STATlB DISKS coomard For example suppose we wantoo to attach to the UFDTekman on node ENA but had forgotten the name of the disk partition on which that UFD res ided We could accampl ish t...

Page 134: ...very low level systans routines he appl ications library is located in UFD LIB in the files APPLIB R mode proqr ansl and VAPPLB v mode prograns All routines in VAPPLBare pure procedure and may be 1000...

Page 135: ...al Routines RNDI A AAND A parsil l3 CMDL A A brief description of these routines follows in alphabetical order CASE A Converts a character st rirq frrm uppercase to lowercase or vice versa and returns...

Page 136: ...lity am returns RUE as the function value if they are equal CSUB A UX ICAL Can pares tw scostr Irqs of character str irqs for equality am returns TRUE as the function value if they are equal CTIM A RE...

Page 137: ...nane am repor ts whether the file exists or not FmT A REAL 8 Converts the date Iast modified DA lM field of a directory entry to mY MCN DDYEAR argunent returned and l 1 DD fY function value FEDr A RE...

Page 138: ...AL Locates a str irg within another str irg Ihe function value repor ts on whether the substring was found or not Locates one substrirg within another substrirg The function value reports on hether th...

Page 139: ...alue reports on the ultlinate success of the operations OPVP A LOGICAL Gets a file name from the user terminal and opens specified file unit The operations are verified use the operations are re tried...

Page 140: ...CAL Rewioos the file opened on the specified file unit The function value repor ta on the success of the operation TEMP A LOGICAL Opens a t enporary file with a mique name in the current UFD for read...

Page 141: ...character strin 1 to see whether it can be interpreted as a nunber binary octal decimal or hexadecimal or a nene lbe function value reports whether the string meets the specified criterion UNIT l LOG...

Page 142: ...s specification of both input and output file types he t lve supported key types are ASCII s irq Le prec Is ion integer single precision real double precision real double precision integer nuneric ASC...

Page 143: ...keys were 5 I 10 3 RADXEX would sort them to 5 10 3 1 The other routines f Uuldsor t them to 3 1 5 10 OPERATING SYSTEM LIBRARY These subroutines are used mainly by PRIM03 Ib ver a rnmber of them usef...

Page 144: ...ubsystem or user applications progrcms must be written to access them rnM files occur in the MIDAS am SEGsubsystems Names In the file system calls names are either ASCII packed two characters per word...

Page 145: ...erating the error text User s message to be printed following stardard error message up to 64 character text Ien Jth Lerqth of text in characters To anit text specify both text am text length as 0 nam...

Page 146: ...r uncanpressed ASCII disk file Parses the commandline token by token Restores an R mode memory image to user memory fran a disk file Restores an R modememory image fran a file sets initial values and...

Page 147: ...disk password 3 word array containing the owner or non owner password of ufd name if at tachirq to bome UFO password may be 3 reference key set key reference key K IMFO Attach to ufd name in MFO on lo...

Page 148: ...current position K RPOS Return current positions as a 32 bit integer in position value position key Indicates positioning optional K PRER KPOSR Move file pointer of file unit position value words rel...

Page 149: ...y to 05535 mode g or transferred range from 0 posi tion valoo Relative or absolute position value integer INTEX 3ER 4 If not needed long integer zero as 000000 or INTL 0 32 bit specify words transferr...

Page 150: ...unused file unit selected by PRIMCl3 he unit nunber is returned in file unit Specifies type of file to create if file name does not al ready exist K NSAM SAM file this is the default K NOAM mM file K...

Page 151: ...K EXST Check on existence of pathnane new file Specifies type of file to create if pathname does not al reedy exist K NSAM SAM file this is the defaul t K NDAM DAM file K NSGS SA M segment directory K...

Page 152: ...If call does not open file its value is uncharqed The values are integers o SAM file 1 DAMfile 2 SAM segment directory 3 DAMsegment directory 4 UFD code returns an integer valued error code Note TSRC...

Page 153: ...PartN Altering the Command Environment...

Page 154: ...e explained in the next section CHANGING THE PROMPT MESSAGE In addition to its normal OK and ER prompts PRIMesalso supplies a long form of prompt message which displays the time the amount in seconds...

Page 155: ...le expands all abbreviations to their full defined form then passes on the commands to the st andardcommand processor You can modify your abbreviation file at any time but u can use it only for intera...

Page 156: ...tion File ABBREV pathname ON activates an existing abbreviation file PR MOS loads the abbreviation table from the specifiErl file and checks each word typed at the tenninal against the abbreviations i...

Page 157: ...re Comnaoo Function ABBREV OFF Deactivates abbreviation file ABBREV pathname ON Reactivates file If pathname is not suppl ied previous pathname is used ABBREV pathname DELETE abbrev l abbrev n Deletes...

Page 158: ...otted space etc External occurrences situations not directly controlled by the executing process such as the use of the break key from the user s terminal More than 30 PRIMOO defined conditions exist...

Page 159: ...the following message at the user s terminal then returns the user to RUMOS conmard level Error condition cord It ton raised at address extra information be user may then take anyone of the following...

Page 160: ...control back to the cord It Ion mechanisnand telling it to hunt for another on unit Print messages then do any of the above Print messages and or run diagnostic routines then transfer control back to...

Page 161: ...al or non local GOTO or by returning to the calling procedure They may not call EXIT thot gh they may GO TO a point in the main program which does so heymay set error codes as return paramet er s prin...

Page 162: ...l up your bookkeepirq Write a subroutine called NOQUIT v hich responds to QUITs by pr Intinq a message at the terminal but otherwise ignoring the QUIT SUBROurINE NOQUIT CP INTEGER 4 CP This will be th...

Page 163: ...TURN At this point NOQUIT sauthority ceases END A PL I EXAMPLE The hypothetical problem provide a program with an on unit for the condi tion POINTER FAULT that will fix a faulting pointer to point at...

Page 164: ...r to cfh 1 dcl mspptr 1 local copy of machinestate ptr 1 dcl based _ptr ptr based msp cp cfh ms_ptr msp ffh fault_addr based_ptr eddr loo J 1 The above uses the hardware saverlpointer to the faul tirg...

Page 165: ...Appendices...

Page 166: ...ather than terminating the program immediately the condition mechanism activates an on unit to take some diagnostic or remedial action A list of conditions handl ed by PRIM03 condition mechanism is gi...

Page 167: ...fewer characters Which names a file or a directory Within any directory each filename is unique Directora nanes and a filencme may be canbined into a pathname M st corrma s accept a pathnane wherever...

Page 168: ...its own use file protection keys See keys file protection bomedirectory The user1s main working directory initially the login directory A different directory may be selected with the ATTACH comrnaoo...

Page 169: ...en the disk is brouqht up by a S mRTUP or AIDISKcommand Printed as IDEVby srxrts DISKS log ical disk A disk volune that has been assigned a logical disk nimber by the operator or during system startup...

Page 170: ...gram opens a file unit in order to read or write it output stream Output from the computer that It u1d usually be printed at a terminal during crnmand execution but W1ich is al so written to a file if...

Page 171: ...erator coemards phantom user A process nnnill3 Indepeodentfy of a terminal under the control of a conmandfile procedure In FORTRAN a stbroutine or function In PL I any sLt routine function or progran...

Page 172: ...orm of directory used in direct access file operations l ht to be confused with directory Wlich means file directory segno Segmen t nimber source file A file containing progranuning language statement...

Page 173: ...and directories A volune may occupy a complete disk pack or be a partition within a multi head disk pack vo1une name A sequence of 6 or fewer characters labeling a vo1une he name is assigned dur irg f...

Page 174: ...a 1PI s DPR lv1PI s ERASE II ESCAPE KILL SEMICO end of line or command TAB WILD SEGMENTED L ER SEG Load Irq address current TOP l in current procedure segment Stack size 6000 words Library PFTNLB and...

Page 175: ...tart address 100e Bits 4 6 of Keys 00e 16K sector address 001 32K sector address el 64K relative address 011 32K relative address 110 64K segmented address mIMOS ERASE INTERRUPr KILL Files CCNTROL P o...

Page 176: ...rity generations Input Parity is ignored by hardsare and by standard software Input drivers are responsible for making the parity bit suit the host software requirements Some controllers e g MLC may a...

Page 177: ...nput Physical vertical tab carriage control Form feed carriage control Carriage return carriage control 1 RRS red ribbon shift BRS b1ack ribboon shift RCP relative copy 2 RHT re1ative horizontal tab 3...

Page 178: ...246 306 F 346 f 247 I 4 307 G 347 9 2513 310 H 350 h 251 311 I 351 i 252 312 J 352 j 253 313 K 353 k 254 5 314 L 354 1 255 315 M 355 m 256 316 N 356 n 257 317 0 357 0 260 320 P 360 P 261 1 321 Q 361...

Page 179: ...sition 2 Terminal usage erase previous character 3 X in British use 4 Apostrophe sill3le qoote 5 Comma 6 Terminal usage kill line 7 1963 standard i terminal use log ical escape 8 1963 standard 9 Grave...

Page 180: ...group errors are listed alphabetically Run time error messages beg Innirq with a fil enane dev ice nane UFDnane etc are alphabeti zed according to the first word which is constant be user should have...

Page 181: ...V 00 64R MODE he Loader is at cenpt irq to load code in 64V mode which is not compiled in that mode This w uldarise if 1 A progran was compiled in a mode other than 64V 2 A PMA module is written in co...

Page 182: ...PRIMCS Fatal error abort 1000 NORcx M IN SY M30L TABLE Unlikely to occur no user solution A new issue of SEGwi th a bigger symbol table is required Check with analyst As a temporary measure user may t...

Page 183: ...rvals or use the SETS or D commands to specifically place base areas CAN T DEFERCCMv lON OLDCBJECTTEXT be Defer Commoncanmand has been given and a module created with a pre Rev 14 canpiler or assanble...

Page 184: ...been loaded into base areas as the resul t of a bed Load command sequence snarne xxxxxx NEED SECTffiZEROLINK At location xxxxxx a link is required for desectorirg the instruction No base areas are wi...

Page 185: ...be sure that all modules are correctly written since the de fa ul t load mode is 32R SYMBOL Nor FOOND An attanpt is be irq mede to equate t ltO symbols with the SYmbol conmand and the old symbol does...

Page 186: ...le system Attempt mede to assign a remote unit Yklen none are available Network error E FUIU ALOG ALOG 10 ARGUMENT 0 V mode function Argunent not greater than zero used in logarithm ALOG AI CX 113 fun...

Page 187: ...E Old file call The DAM file specified has been corrupted either by the programmer or by a systan problan SS Bad DAM file File System The l M file specified has been corrupted either by the programner...

Page 188: ...segment directory i e mIMOS file unit specified is not a segment directory SRCH E BSUN Bad stack format Bad stack format signal 1in FRIMOS Condition mechanisn cannot perform requested action because t...

Page 189: ...s not large enotqh to accomodate entry to be read into it RDEN E BF ffi CommandIine truncated PRIMOS An illegal comnand line has been rece ived executed and the user is returned to E TRCL The conmand...

Page 190: ...RGt J 1ENT TOO LARGE v mode function he argunent of the DEXPfunction is too large give a result outside the legal rarqe Le it will DEXP OVERFLCW UNDERFLCW V mode function An overflow or underflow cond...

Page 191: ...ons prog ramner A IOl CRFA GPAS PIH RDEN SATR SRCH SGm E DISK Disk is wri te protec ted File System An attempt has been mede to write to a disk which is WRITE protected E WTPR OK ERROR Old file call A...

Page 192: ...precision End of file r File System Attanpt to access location after the end of the file PRWF RDEN SGDR E EOF EQ R mode function Exponent overflow A 81 EX R mode function Exponent function value too l...

Page 193: ...of se J1lent directory beyorrl si ze limit scrass E FI1B FN n R mode function Device error in BACKSPACE cornnand on FORTRAN 103ica1 unit F BN BADIDGICALUNIT V mode function FORTRAN logical m it nunber...

Page 194: ...FORTRAN log ical unit for READstatement not conf iqur ed properly II R mode function Exponentiation exceeds integer si ze E ll ILLEGALINSTRUCTICN AT octal location R mode am 64V mode An instruction at...

Page 195: ...at t anpt Irq to create a sub UFO CRFA GPAS S TR SRCH SGrR E NRIT Invalid argument to command mIMOS A commandhas been issued with an il Leqal argunent is not executed E BARG he command Invalid segment...

Page 196: ...e already in use E NPHA No on unit found Condition mechanism Condition mechani an cannot take action User is returned to mIMOScomnand level D NOCN No roan File System An attempt has been made to add t...

Page 197: ...le lttlich is not a UFD AR Not a UFD File System Attempt to perfonn UFD operations on a file lttlich is not a UFD ATCH GPAS SRCH E NTUD dev Ice nane Nor ASSIGNED mIMOS User proqr an has at t enpted to...

Page 198: ...execution PAlSE n V mode function PAUSE statement n octal encomtered during proq rem execution POINTER FAULT 64V mode Reference has been mede to an argunent or instruction not in manory he t WO usual...

Page 199: ...open PI R MISMA lCH File System Internal file IX inters have becane cor rupt ed No user reme 1ial action posstble A lCH CREA GPAS PRWF RDEN SATR SRCH SGm Consult systan maneqer The remote line is down...

Page 200: ...UMENT TOOLARGE V mode function AIgunent too large for SIN or COS function SQ R mode fmction Negative argunent in SQRTor IEQRTfunction SCRT ARGUMENT 0 V mode functon Negative argunent in SQRTfunction S...

Page 201: ...more roan in UFD Unable to fim faul t frane Condition mechanism A call was made to CNSIG but CNSIG could not firrl that any condi tion hed been raised UNITIN USE Old file call Attempt to open file on...

Page 202: ...NDELETE Old file call Attempt to delete file without hev irq first closed it SD WN n R mode function Device error or erX3 of file in WRITEstatement on FORTRANlogical unit n XX R mode function Integer...

Page 203: ...before tbose options The syntax is JOBpathnane options Cpu limit must be specified Fatal The queue referred to by a QUEUEoption dur irq job submission is defined such that the CPTIME option is a requi...

Page 204: ...on the command line or in the cammam file JOB so the JOBcommand determined the home attach point of the stbmittirg job This message is typed out to renird the user that the HCME option was not specifi...

Page 205: ...eue name format rules Use BA IGEN STATU or DISPLAY to determine the names of legal queues Incorrect user name Fatal A commandfile was sutxnitted usirq the JOBcommandthat hed a JOB line as the first no...

Page 206: ...dentifier internal or external name Re enter the canmand with the job ide For example JOB C TOP HOID JCB fI l0032 ABORT Job not found Fatal The job referred to in a JOB command such as CHMGE cANCEL AB...

Page 207: ...Either Way the user will be immediately returned to comnandmode i e the operation the user attempted will not be per formed his can be typed out by the BA K H or the JOB coamands when they start runn...

Page 208: ...atus but by the time the execution file was reed in to detennine the user nunber of the process it had disappeared If the message II Job restarted II had been typed out then the job would be restarted...

Page 209: ...nane after the HCME option t your job Fatal A reference was mede to a job usirg an internal nane in the JOB comnarrl and the referenced job did not bel orq to the user makinq the reference USe JOB 5TA...

Page 210: ...ld be resubnitted to a different queue Queuedoes not exist Fatal The QUEUE option on the JOBcommand line or the optional JOBline referred to a queue that either did not exist or was in the process of...

Page 211: ...onmandwithout register settin Js text seen when end of line expected Fatal text was seen Wlen there sbould have been no more text end of line The conmandwill be ignored am the user will be returned to...

Page 212: ...beirq processed at this time Response The Batch monitor is not nnnin J l b subnitted jobs will be execute i Inti it has been started up he operation request ed will then be performed If the monitor is...

Page 213: ...N using ALIAS with 11 6 AssigninJ mag tape drives 11 3 Assignirl3 peripheral devices 11 1 INDEX ATTACH 2 5 3 2 ATTACH across network 12 1 12 3 ATTN key 2 10 AVAIL 3 6 Backslash 2 11 Backup onto tape 1...

Page 214: ...5 5 usirq condition mechanisn with 15 2 Code generation 5 4 Canbining Larqueqes in a proqr an 5 5 X 2 INDEX Canbinirg program modules 5 5 CCMINPUl 8 2 CCMINPUT options 8 3 Cbmmand environment 14 1 co...

Page 215: ...9 1 files 13 11 Compressed files 1 1 mTE 3 6 CCNCAT 4 14 EG 15 2 concatenating files for printing 4 14 DBMS 1 7 EMS Administrator sGuide 1 7 condition mechanism 15 1 EMS COBOL Reference Guide 1 7 Cont...

Page 216: ...yinq the spool queue 4 12 Executil lJ PHANT Jo1 files 8 11 Distributed Processing Terminal Executive Guide 1 8 Execution of R modemanory images 7 1 Il 1SI K 15 2 Doubl e quot e 2 11 Execution of segme...

Page 217: ...OOTRAN 77 combined with other languages 5 5 compiler defaults 5 2 docunentation for 1 5 editing source files 4 3 4 5 modes generated 5 4 on units in 15 2 15 4 x INDEX FORTRAN combined with other langu...

Page 218: ...J programs at terminal 4 11 LQ1 D Editor command 4 3 LQ D L D subcommand 6 6 x 6 INDEX LOAD SEG command 6 2 LQl D Sa subcanmand 6 2 LC1 D am SEG Reference Guide 1 5 LOP D error messages 0 4 LOAD subc...

Page 219: ...speed of execution 8 8 r t n i tor ing the spoof queue 4 12 M untingmeq tapes 11 8 x 7 INDEX Moving lines of code 4 3 MRGF 10 8 MSORTS 13 1 Netw rks attachirg across 12 3 defined 12 1 disk names 12 3...

Page 220: ...th other Larqueqes 5 5 PL1G compiler 5 1 FMA pr ramner s Guide 1 6 PGJER 1 6 1 7 mIME PCWER Guide 1 7 mlMENEl 1 7 12 1 x 8 INDEX mIMENEI Guide 1 7 PRIMOO 2 1 mIMOSConmarrlsReference Guide 1 5 mIMOSCbm...

Page 221: ...1 RPG II Debugging Template 1 5 RPG II He ference Guide 1 5 RUBOUT key 2 10 Run time error messages D 7 Running jobs under Batch 9 1 Running R mode programs 7 1 x 9 INDEX Rtmning V mode am I mode tro...

Page 222: ...5 Subroutines for condition mechanism interface 15 4 System Administrator s Guide 1 6 INDEX System Administrator The Programmer s Companion 1 8 System Architecture Reference Guide 1 6 system Prompts 2...

Page 223: ...es 19 1 Variables in abbreviations 14 3 Virtual memory 2 2 Vo1lJtle 2 3 VSRTLI 13 1 13 9 rking directory 2 5 writirB files fr on tape 11 19 11 17 WritirB mcg tapes 11 1 writirB output to a file 8 6 XO...

Search results

Summary of Contents for IDR 4130

Reviews:

Related manuals for IDR 4130

Brands by name

Popular brands

Prime IDR 4130, User Manual

Search results

Summary of Contents for IDR 4130

Reviews:

Related manuals for IDR 4130

Brands by name

Popular brands