background image

Содержание IDR 4130

Страница 1: ...THE PRIME USER S GUIDE PRlME Computer IDR 4130...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 8: ...Part I Using Prime Documentation...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 17: ...Part II Writing and Running Programs...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 94: ...Part III System Facilities...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 153: ...PartN Altering the Command Environment...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 165: ...Appendices...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: