@NewPage @Section(INDIVIDUAL COMMANDS)@Label(Command1) @Begin(Group)@SubSection(ANALYSE) @Begin(Description) @Index(ANALYSE)@IndexSecondary(Primary="Command", Secondary="ANALYSE") Format @\ANALYSE ,[infile2,...]/[] [] Description @\The ANALYSE command displays information about a file or files. @b[Parameters] Infile @\Name of file to be analysed. Wild cards are accepted in the filename but not directory name. Outfile @\File to which ANALYSE output is to be sent. (default=console) -BRIEF @\One line of information about the file is displayed. This comprises the file name, the date the file was created or last altered, access permissions, archive status, size in bytes and blocks and the number of extents in the file. No information about the file contents is produced. -NORMAL @\The same information is displayed as for -BRIEF but in a more readable form. -FULL @\A full analysis of the file is produced. The file is reading and a line count or list of external references is produced for "text" or recognisable object modules respectively. -DUMP @\The file will be dumped in hexadecimal and character form. Note @\DUMP is an alias for Analyse-dump. Examples @\}ANALYSE TEST1 @End(Description) @End(Group) @Begin(Group)@SubSection(ASS) @Begin(Description) @Index(ASS)@IndexSecondary(Primary="Command", Secondary="ASS") Format @\ASS - Description @\@Begin(Multiple)The ASS command invokes the m68000 assembler to assemble the program in (with assumed extension ASM). The object code (in Motorola format) goes into a file with extension MOB, the listing into a file extension LIS. By default, production of object code is enabled, of a listing disabled. The assemble accepts the full assembly language as defined by the manufacturer (see Motorola Manual M68000 Assembly Language). @End(Multiple) @End(Description)@End(Group) @Begin(Group)@SubSection(CLEAN) @Begin(Description) @Index(CLEAN)@IndexSecondary(Primary="Command",Secondary="Clean") Format @\CLEAN Description @\The command is self-documenting - just type H for information. IE is supported and is called by the command IE. It is very similar to the standard APM command D. However extra commands have been added to dump files,edit files (with IE or ECCE), etc. Examples @\@Begin(Ex) }CLEAN fred { cleans the file "fred" }CLEAN martin: { cleans all files in MARTIN: }CLEAN *link* { cleans all files matching filespec @End(Ex) @End(Description) @End(Group) @Begin(Group)@SubSection(CLEAR) @Begin(Description) @Index(CLEAR)@IndexSecondary(Primary="Command",Secondary="CLEAR") Format @\CLEAR Description @\This command takes no parameters and clears both the VDU and graphics screens if present. @End(Description) @End(Group) @Begin(Group)@SubSection(COMPARE) @Begin(Description) @Index(COMPARE)@IndexSecondary(Primary="Command",Secondary="COMPARE") Format @\COMPARE ,/ Description @\The program COMPARE compares two files and produces a list of lines which differ in each file. The matching is done in such a way that short insertions are recognised without generating a lot of false mismatches. The differing lines are printed out preceded by 1 or 2 to indicate which file they are from. The differing lines are followed by the first line wich matches in both files preceeded by an equal. Note @\If no is given the differences will be printed on the terminal. Examples @\@Begin(Ex) }COMPARE TEST1,TEST2 }COMPARE TEST1,TEST3/RESULTS @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(D) @Begin(Description) @Index(D)@IndexSecondary(Primary="Command",Secondary="D") Format @\D Description @\This command displays the names of the files in the specified directory and allows the user to ask for any of them to be Shown, Renamed, Deleted or Permitted. It is self-documenting. Type "?" within it for assistance. Examples @\@Begin(Ex) }D LIB2 }D @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(DELETE) @Begin(Description) @Index(DELETE)@IndexSecondary(Primary="Command",Secondary="DELETE") Format @\DELETE ,[,...] Description @\The DELETE command causes the specified file(s) to be destroyed. As a precaution against accidental deletion of source files, confirmation is requested before files without order extension then .MOB or .LIS are deleted. The response should be 'Yes' or 'Y' if the file is to be deleted, 'No' or 'N' if not. Note @\The user must have owner-authority over the directory involved in order to delete files in it. Examples @\}DELETE TEST1,LIB:TEST2 @End(Description)@End(Group) @Begin(Group)@SubSection(E) @Begin(Description) @Index(E)@Index(EDIT)@Index(ECCE) @IndexSecondary(Primary="Command",Secondary="E") @IndexSecondary(Primary="Command",Secondary="EDIT") @IndexSecondary(Primary="Command",Secondary="ECCE") Format @\@Begin(Enum) E / E .N/ E E ,[/] E /.N @End(Enum) Description @\@Begin(Multiple)The Edit command is used to invoke the ECCE context editor. @Begin(Enumeration) The first form of command is used to edit an existing file to a new file. The second form is used to create a file from scratch. The third form is used to edit an existing file. In this case, the new file is given the same name as the old but the original file is not deleted until the editing has been finished successfully. The fourth form is used to specify a secondary input file. The last form is used to examine a file without altering it. @End(Enumeration) For more information on the ECCE editor, see section @ref(ECCE). @End(Multiple) Examples @\@Begin(Ex)}E TEST1/TEST2 }E .N/NUPROG }E DATA }E DATA, EXTRA }E PROG.LIS/.N @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(EFTP) @Begin(Description) @Index(EFTP) Format @\EFTP Description @\The EFTP program is used for inter-filestore transfer of files residing on the various filestores, including the departmental Vax, connected to the Ether. For more information see section @Ref(EFTP). Example @\@Begin(Ex)} EFTP EFTP> Transfer ::vax:u0:[test]test1 ::b:[try]try1 @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(FILES) @Begin(Description) @Index(F)@Index(FILES)@IndexSecondary(Primary="Command",Secondary="F") @IndexSecondary(Primary="Command",Secondary="FILES") Format @\F [:] [] Description @\@Begin(Multiple)The file enquiry command F provides the facility to list the names of the files in a given directory. If a directory is not specified the current default directory is used. If no filename is specified, the names of all the accessible files in the current directory are listed. Accessible files are those to which the enquirer has some permited access. The purpose of specifying a template is to select a subset of the complete list names which have certain character sequences in common. A template consists of a sequence of characters each of which is a file-name character, or a question-mark, or an asterik. For a file-name to match the template, the characters of the template must match those of the file-name in the order given, with the question-mark acting as a wild-card matching any single character and the asterik as a wild-card matching any sequence of characters. @End(Multiple) @Hinge @b[Parameters] -OUTPUT= @\Directs the output from F to the nominated file. -FULL @\Gives further information about the file: SOA, Date, Time, Blocks(Extents). -S0 @\is the access permissions for Self and Others, A is the Archive/Noarchive, Date and Time are the date and time of creation and the Blocks(Extents) is the size of the file in 512-byte blocks and the number of extents it is spread over. -ORDER=ALPHA @\Presents the files in alphabetical order. -TOTALS Gives only the information about the directory (i.e. the information normally given in the first line of an F request.) -?? @\Causes F to prompt for each parameter in turn. @End(Description) @Hinge Examples @\@Begin(Ex)}F }F APM: }F NEW* }F APM:*.ASM }F APM:-ORDER=ALPHA @End(Ex) @End(Group) @Begin(Group)@SubSection(FORGET) @Begin(Description) @Index(FORGET)@IndexSecondary(Primary="Command",Secondary="FORGET") Format @\FORGET Description @\Files which it is reckoned will be frequently used can be brought into memory and locked down using the PRELOAD command. This may result in memory being cluttered up eventually with unwanted files. FORGET gets rid of them. FORGET will prompt for each file in turn and invite you to FORGET it. @End(Description)@End(Group) @Begin(Group)@SubSection(FROMBIN) @Begin(Description) @Index(FROMBIN)@IndexSecondary(Primary="Command",Secondary="FROMBIN") Format @\FROMBIN , Description @\Convert from Binary to Motorola (Hex) Object Module Format @End(Description)@End(Group) @Begin(Group)@SubSection(GRID) @Begin(Description) @Index(GRID)@IndexSecondary(Primary="Command",Secondary="GRID") Format @\Grid Description @\This is an engineer's test program for checking the alignment of a graphics monitor. The command takes no parameters and draws a pattern of coloured "graphpaper" on the graphics monitor. The pattern may then be moved around using the cursor keys. The presence or absence of the whole of the lines down the side of the screen is a sensitive indication of how well they are set up. @End(Description)@End(Group) @Begin(Group)@SubSection(HELP) @Begin(Description) @Index(HELP)@IndexSecondary(Primary="Command",Secondary="HELP") @Index(VIEW)@IndexSecondary(Primary="Command", Secondary="VIEW") Format @\HELP [] Description @\The HELP command is used to obtain information about APM commands and facilities. It provides access to on-line documentation for the user to browse through. The single word HELP by itself displays a list of topics and invites the user to select one. Typing gives the user general information about the APM and its command language. Help followed by a topic-name like TERMINAL provides information about a particular topic. To obtain a summary of the operations provided, type within HELP. HELP HELP provides more detailed information about the HELP facility. Note @\VIEW is an alias of HELP. Examples @\@Begin(Ex) }HELP HELP }HELP USERS }HELP APM }HELP @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(ID) @Begin(Description) @Index(ID)@IndexSecondary(Primary="Command",Secondary="ID") Format @\ID Description @\The command ID returns a brief description of your APM. There are no parameters and the information displayed is @Begin(Itemize) Date of the main firmware and Ethernet firmware running in your APM. Your Ethernet station. Your default port and your default filestore and port. The address range and size of your Main store. The address range and size of the remaining free store. An approximate figure for the Processor speed. @End(Itemize) @End(Description) @End(Group) @Begin(Group)@SubSection(IE) @IndexSecondary(Primary="Command",Secondary="IE") @SeeAlso(Primary="Command", Other="IE") @Begin(Description) Format @\IE /- Description @\If an output file is omitted, output will be the same as the input. To create a file, you only have to give the file name and it will be created. For more information on IE see section @ref(IE). Example @\} IE TEST.LIS @End(Description)@End(Group) @IndexSecondary(Primary="Command",Secondary="IMP") @IndexSecondary(Primary="IMP",Secondary="Calling the Compiler") @Begin(Group)@SubSection(IMP) @Begin(Description) Format @\IMP Description @\@Begin(Multiple)This invokes the IMP compiler for the M68000. The program in (No assumed extension) is compiled, with object code (in binary image form) going to a file with extension MOB. By default, production of object code is enabled, but is suppressed if the program contains compiler-detected errors. By default, production of a listing is disabled. The main options are: @Begin(FileExample) -LIST Produce a listing to file with same name as source and extension @.LIS -NODIAG Suppress line-number diagnostic -NOCHECK Suppress run-time checks @End(FileExample) For more information see section @Ref(IMP). @End(Multiple) Examples @\@Begin(Ex)}IMP TEST1-LIST }IMP TEST2 }IMP TEST3-NODIAG @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(INSTALL) @Begin(Description) @Index(INSTALL)@IndexSecondary(Primary="Command",Secondary="INSTALL") Format @\INSTALL Description @\INSTALL takes a file and enters any entry points into the system dictionary. This makes these entry points accessible to any program which declares them as external references. @End(Description) @End(Group) @Begin(Group)@SubSection(L) @Begin(Description) @Index(L)@Index(LOG ON)@Index(LOG OFF) @IndexSecondary(Primary="Command",Secondary="L") @IndexSecondary(Primary="Command",Secondary="LOG ON") @IndexSecondary(Primary="Command",Secondary="LOG OFF") Format @\@Begin(Enum) L [Filestore::]Username L @End(Enum) Description @\This command is used to log on to a Filestore or log off from a filestore. The purpose of logging on is to establish the default directory to be used in referencing files and to demonstrate authority to use those files by citing the appropriate password. The user is prompted for the password (wich is not echoed). If the command file LOGIN.COM exists (see section @Ref(LOGIN) for further information on LOGIN.COM files), the commands in it are obeyed before the system accepts further commands from the terminal. If another users already logged on at this machine, the previous user is automatically logged off. Since this command always causes any existing user to be logged off, it can be used without any parameter simply to log the current user off. Examples @\@Begin(Ex)} L B::PDS Pass:...... (not echoed) @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(LASER) @Begin(Description) @Index(LASER)@IndexSecondary(Primary="Command",Secondary="LASER") Format @\LASER [] Description @\The LASER command queues files for printing on the laser printer and/or interrogates the laser printer queue. @b[Parameters] File @\Name of file to be printed. There is a default extension of .LAY. If .LAY does not exist, LASER will attempt to print . Queue Enquiry -Q or -Queue @\If the additional parameter -Q or -QUEUE is specified, LASER will display the laser printer queue (after sending the file if specified ). If the specified file is in the laser printer queue already, LASER will prompt the user for further instructions. The user may reply @Begin(FileExample) O Overwrite the current copy of the file on the queue. S Queue a second copy of the file. (Filename will be "uniqueified") Q Quit and not attempt to queue the file. Failure messages: No Authorisation The user is not on the list of accredited users. No Access to The specified file is not accessible in read mode Laser failure - The laser queue is not accessible. @End(FileExample) @End(Description)@Hinge @Begin(Description) Notes @\@Begin(Multiple)The command is available on all filestores. The command SETUP SSE must be issued before this command may be used. The SETUP command may be included in the LOGIN.COM file. The laser printer is expensive to run so avoid printing unnecessary copies. The command DOC:LG1 enables a laser printer LAYOUT file to be previewed on an APM with level 1 graphics. Text may be prepared for the laser printer using the LAYOUT text processing package. @End(Multiple) @End(Description) @End(Group) @Begin(Group)@SubSection(LAYOUT) @Begin(Description) @Index(LAYOUT)@IndexSecondary(Primary="Command",Secondary="LAYOUT") Format @\LAYOUT / Description @\This command invokes the document production program LAYOUT to format a file prepared in LAYOUT source. The default output file-name is the same as the input without the .LAY and the extension .LIS is applied. This version of LAYOUT produces standard ASCII output, suitable for terminals and printers. Examples @\}LAYOUT PROJ.LAY @End(Description)@End(Group) @Begin(Group)@SubSection(LINK) @Begin(Description) Format @\LINK MainFile,File1,[File2,...][/Outfile][-Include=?][-Exclude=?] Description @\The LINK command may be used to consolidate a group of object modules, resolving the external references made within the group. @b[Parameters] Mainfile @\The name of the object file (.MOB extension assumed) containing the main module of the group. This will normally be a main program, but this is not compulsory. File1..File19 @\The names of object files containing further modules to be linked with the main file. Outfile @\The name of the file to receive the resulting object module. If omitted, the output is sent back into the main file. -Include,@* -Exclude @\@Begin(Multiple)By default the output module will export only those entries which are exported by the input modules and were not used to satisfy any internal references. This may be over-ridden by using the INCLUDE and EXCLUDE parameters. If present, they are either "*" or a filename. If "*", this means all exports are to be in/excluded in the output, if a filename (which may be the terminal (":")), then a list of export names to be in/excluded are read from the specified file. If one is specified as "*", it will be processed before the other, so that the other is always a list of exceptions to the first. Specifying "*" for both is daft. @End(Multiple) @Hinge @b[Restrictions] Part-linking @\@Begin(Multiple)For the moment it is not recommended to part-link a collection of modules, either for further linking, or for installing. More precisely, you are likely to get into trouble if any included exports are not from the first module of the parameter list (Mainfile). In other words, you can "part-link" A with B and C, provided that, at run-time, the exports made by B and C are only used by A, B, or C, not by the main program or other modules loaded with it. @End(Multiple) @End(Description)@End(Group) @Begin(Group)@SubSection(MAIL) @Begin(Description) @Index(MAIL)@IndexSecondary(Primary="Command",Secondary="MAIL") Format @\MAIL [,...] Description @\The command displays the number of VAX mail messages waiting for each of the requested users. If the user parameter is omitted altogether it will display mail messages for the currently logged-on user. There are no facilities (yet) for sending or receiving mail on the Advanced Personal Machines. @End(Description)@End(Group) @Begin(Group)@SubSection(P) @Begin(Description) @Index(PRINT)@Index(P)@IndexSecondary(Primary="Command",Secondary="P") @IndexSecondary(Primary="Command",Secondary="PRINT") Format @\P - Description @\The specified file is sent to the nominated printer. The allowed printer are @Begin(FileExample, LeftMargin 16) Printer Queue number MH North Machine Halls TXA6 (Default) OP Block O/P TTC15 LJ HP Laser Jet @End(FileExample) Note @\In order to delete an entry from a queue, you can loggon to Vax and use the following command @Begin(fileExample) Show queue @End(FileExample) to find out what is the job number of your request. Then you can use the command @Begin(FileExample) Delete/entry= @End(FileExample) to delete your entry from the queue. Examples @\@Begin(Ex) }P TEST.LIS }P TEST.IMP -OP @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(PAMSET) @Begin(Description) @Index(PAMSET)@IndexSecondary(Primary="Command",Secondary="PAMSET") @IndexSecondary(Primary="Set",Secondary="Command Separators") Format @\PAMSET Description @\@Begin(Multiple)The command is used to specify user preferences for the characters used as punctuation symbols in the parameter part of a command line. Choice is provided for two cases: the group separator used to seperate output file names from input file names and the flag character used to introduce a keyword parameter. The standard system default for these is: @Begin(FileExample) Group separator: oblique stroke ('/') Keyword flag : dash ('-') @End(FileExample) The commands PAMSET prompts for two characters which must be typed in the order indicated without intervening spaces. The space character is a valid choice for group separator, though its use imposes restrictions which do not apply to non-space choices. Space is not valid for the keyword flag. @End(Multiple) Note @\The system default are restored whenever a user logs off. @End(Description)@End(Group) @IndexSecondary(Primary="Command",Secondary="PASCAL") @IndexSecondary(Primary="PASCAL",Secondary="Calling the Compiler") @Begin(Group)@SubSection(PASCAL) @Begin(Description) Format @\PASCAL Description @\@Begin(Multiple)This invokes the PASCAL compiler for the M68000. The program in (No assumed extension) is compiled, with object code (in binary image form) going to a file with extension MOB. By default, production of object code is enabled, but is suppressed if the program contains compiler-detected errors. By default, production of a listing is disabled. The main options are: @Begin(FileExample) -LIST Produce a listing to file with same name as source and extension @.LIS -NOCHECK Suppress run-time checks @End(FileExample) For more informations see section @Ref(Pascal). @End(Multiple) Examples @\@Begin(Ex)}PASCAL TEST1-LIST }PASCAL TEST2 }PASCAL TEST3-NOCHECK @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(PASS) @Begin(Description) @Index(PASS)@Index(Password) @IndexSecondary(Primary="Command",Secondary="PASS") Format @\PASS Description @\This command is used to alter the user's password to something else. First, the existing password is requested, as a safeguard, and then the new password, which is requested twice to verify correct entry (since passwords are not echoed). This permanently changes the password to the new choice. @End(Description)@End(Group) @IndexSecondary(Primary="File",Secondary="Protection") @IndexSecondary(Primary="Directory",Secondary="Protection") @Index(PERMIT)@IndexSecondary(Primary="Command",Secondary="PERMIT") @Begin(Group)@SubSection(PERMIT) @Begin(Description, Below 1 Line) Format @\@Begin(Enum) PERMIT / PERMIT :/ @End(Enum) @Hinge Description @\@Begin(Multiple)The first form changes the protection of to . The second form changes the default protection associated with the directory ; this applies to all files subsequently created in that directory. The interpretation of on the current Filestores is as follows: The first letter denotes the permission given to anyone with owner-authority, the second letter denotes permissions given to everyone else. These letters may be: @Begin(Enumerate) F : Free (i.e. Read/Write/Delete) R : Read-only N : No acces @End (Enumerate) The third letter, if present, affects the archive flag associated with the files and may be: @Begin(Enumerate) A : Archive (i.e. back this file up regularly) V : Vulnerable (do not back this file up). @End(Enumerate) @End(Multiple) @Hinge Examples @\@Begin(Ex) }PERMIT PROG/FF }PERMIT LIB:/FRA @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(PERUSE) @Begin(Description) @Index(PERUSE)@IndexSecondary(Primary="Command",Secondary="PERUSE") Format @\PERUSE Description @\This is used to peruse files. @b[Commands] @\@Begin(Ex) S or or or : Skip to next page R or : restart at top of file N : Moves to next file B : Back one file Q : Quit - or : Go back one page @End(Ex) Examples @\@Begin(Ex) }PERUSE fred:jim } looks at FRED:JIMASSWDSS }PERUSE fred:* } all extensionless files } in directory FRED }PERUSE ** } all files in current } directory @End(Ex) @End(Description) @End(Group) @Begin(Group)@SubSection(PRELOAD) @Begin(Description) @Index(PRELOAD)@IndexSecondary(Primary="Command",Secondary="PRELOAD") Format @\PRELOAD Description @\Files are generally brought into memory as required and forgotten about when they are no longer needed. This can be slow and wasteful of Ethernet and Filestore capacity if the files are used frequently. To avoid this the files may be PRELOADed: This brings them into store and locks them down until released by the FORGET utility. See also REMEMBER, section @Ref(Remember) @End(Description) @End(Group) @Begin(Group)@SubSection(QUEUE) @Begin(Description) Format @\QUEUE Description @\This simply returns the number of entries in the queue. @End(Description)@End(Group) @Begin(Group)@SubSection(QUOTE) @Begin(Description) @Index(QUOTE) @IndexSecondary(Primary="Command",Secondary="QUOTE") @IndexSecondary(Primary="File",Secondary="Access to") Format @\QUOTE Description @\The QUOTE command is used to QUOTE a password in order to demonstrate authority additional to that established at log-on, so that proctected files in directories owned by someone else may be accessed. Examples @\@Begin(Ex)}QUOTE Pass:..... (not echoed) @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(REMEMBER)@Label(Remember) @Begin(Description) @Index(REMEMBER)@IndexSecondary(Primary="Command",Secondary="REMEMBER") Format @\REMEMBER Description @\Installs the file (assumed to be a .MOB file) in the appropriate dictionary and marks it such that when it is next brought in (e.g. by a %external reference) it is locked down in store, not discarded as is usually the case. @End(Description) @End(Group) @Index(RENAME)@IndexSecondary(Primary="Command",Secondary="RENAME") @Begin(Group)@SubSection(RENAME) @Begin(Description) Format @\RENAME / Description @\The RENAME command is used to rename one or more files. The user must have owner authority with respect to the directory containing the file in order to rename it. Other attributes of the file, like date of creation and permissions, are unaffected by renaming. It is not possible to alter the directory part of a file-specification. The parameter may contain a directory name, as in LIB:TEST2, but may not. Examples @\@Begin(Ex)}RENAME CURDATA/OLDATA }RENAME LIB:CURDATA/OLDATA @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(S-ALGOL COMPILER)@Label(Salgol) @IndexSecondary(Primary="S-ALGOL", Secondary="Compiler") @SeeAlso(Primary="Languages",Other="S=ALGOL") @Begin(Description) Format @\@Begin(Ex)SETUP SA SR @End(Ex) Description @\@Begin(Multiple)The command SETUP SA sets up the definitions required by S-Algol. The SR command then invokes the APM interpreter for the S-Algol language as described by Cole and Morrison. It takes no parameters. The first line of input is taken to be the name of an S-code file, which is loaded and interpreted. @End(Multiple) Examples @\@Begin(Ex) } SR } SA:SC invokes the S-Algol interpreter to load and interpret the S-Algol compiler. @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(SEARCH) @Begin(Description) @Index(SEARCH)@IndexSecondary(Primary="Command",Secondary="SEARCH") Format @\SEARCH , Description @\This command takes a wild card file name and a string which is to be searched for in all files matching the file specification. @b[Parameters] -Centred @\Causes matches to be displayed in the centre of the screen with the 36 characters on either side. Unprintable characters and newlines are replaced by '_'. -Line(default) @\The line containing the match is printed verbatim. -Output= @\Specifies that output from the search should go to Examples @\@Begin(Ex) }SEARCH FMACS:*,HDX { searches for 'HDX' in all { extensionless files in { fmacs. }SEARCH ?? { searches for FRED in .MOB's Wildfile[*.*]:*.mob Searchstring:FRED @End(Ex) Note @\If the search string contains leading or trailing spaces it should be enclosed in double quotes ("..."). @End(Description) @End(Group) @Begin(Group)@SubSection(SET) @Begin(Description) @Index(SET)@IndexSecondary(Primary="Command",Secondary="SET") @IndexSecondary(Primary="Directory",Secondary="Set") Format @\SET Description @\The SET command is used to change to another default directory, to be used in subsequent file references. If is omitted, the default reverts to that established at log on. Examples @\@Begin(Ex) }SET }SET LIB @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(SETUP)@Label(SETUP) @IndexSecondary(Primary="Command", Secondary="SETUP") @SeeAlso(Primary="Command",Other="SETUP") @IndexSecondary(Primary="SETUP", Secondary="ESDL") @IndexSecondary(Primary="SETUP", Secondary="EDWIN") @IndexSecondary(Primary="SETUP", Secondary="ILAP") @Begin(Description) Format @\SETUP Description @\@Begin(Multiple)The SETUP command has been provided to make available packages. The following is a list of packages which may be made available in this way. @Begin(FileExample) @IndexSecondary(Primary="SETUP", Secondary="VLSI") @IndexSecondary(Primary="SETUP", Secondary="IPLOG") @IndexSecondary(Primary="SETUP", Secondary="GKS") @IndexSecondary(Primary="SETUP", Secondary="SSE") @SeeAlso(Primary="SETUP", Other="EDWIN") ESDL : Suite of circuit design programs. EDWIN : Graphics package. ILAP : A procedure library for generating CIF descriptions. VLSI : IPLOG : GKS : SSE : Routines for building communications utilities. SA : Definitions required by S-Algol. @End(FileExample) For further information on EDWIN, ILAP, VLSI see chapter @Ref(Graphic) and @Ref(VLSI). @End(Multiple) NOTE @\On the current 1-process operating system SETUP is implemented by switching input to a command file :SETUP. This means that SETUPs buried in command files will cause control to be switched out from the command file, it may not be switched back. Command files may therefore only contain one SETUP command which should be the last command in the file. @End(Description)@End(Group) @Begin(Group)@SubSection(SUGGEST) @Begin(Description) @Index(SUGGEST)@IndexSecondary(Primary="Command",Secondary="SUGGEST") Description @\This command prompts you for a suggestion, which will be recorded along with a record of who you are. The suggestions box will be examined from time to time and suggestions implemented as appropriate. @End(Description) @End(Group) @Index(T)@Index(TRANSFER)@Index(COPY) @IndexSecondary(Primary="Command",Secondary="T") @IndexSecondary(Primary="Command",Secondary="TRANSFER") @IndexSecondary(Primary="Command",Secondary="COPY") @IndexSecondary(Primary="File",Secondary="Copy") @Begin(Group)@SubSection(T) @Begin(Description) Format @\@Begin(Ex) T / COPY / @End(Ex) Description @\The TRANSFER command is used to copy information from one or more source streams to a destination stream. If more than one sourcee stream is specified, the data is concatenated in the order given. The default for and are the terminal. Examples @\@Begin(Ex)}T ONE,TWO/BOTH }COPY ,ONE/BOTH @End(Ex) @End(Description)@End(Group) @Begin(Group)@SubSection(TO) @Begin(Description) @IndexSecondary(Primary="Stream",Secondary="TO") @Index(TO)@IndexSecondary(Primary="Command",Secondary="TO") Format @\TO or TO Description @\Console output (stream 0) is switched to the nominated file. To switch back the output to the console (stream 0) use the command "TO :T". @End(Description)@End(Group) @Begin(Group)@SubSection(TOBIN) @Begin(Description) @Index(TOBIN)@IndexSecondary(Primary="Command",Secondary="TOBIN") Format @\TOBIN / Description @\Convert Motorola (Hex) Object Module Format to Binary @End(Description) @End(Group) @Begin(Group)@SubSection(TOD) @Index(TOD)@IndexSecondary(Primary="Command", Secondary="TOD") @Begin(Description) Format @\TOD Description @\Time Of Day. @End(Description)@End(Group) @Begin(Group)@SubSection(TRACE) @Begin(Description) @Index(TRACE)@IndexSecondary(Primary="Command",Secondary="TRACE") Format @\Trace Description @\@Begin(Multiple)The Filestores each keep a circular log of all transactions with APM machines. This lives in the special file $:TRACE and can be displayed using the TRACE utility. The trace is displayed with the commands (issued by the APM) to the left and the matching responses (from the filestores) to the right, with a '/' to delimit them. The command primitive is interpreted and its name is given at the left hand side. Exceptions are.. @Begin(Itemize) Data packets (Interpreted as ) Packets where the command or reply is missing (Interpreted as '*') @End(Itemize) If the same command/response pair occurs more than once in succession, it will be printed once with a repeat count in square brackets to the right. @End(Multiple) @b[Parameters] Context @\This is the filestore local port number (It can be displayed using the ID utility and appears in the $:UNOS special file), assigned one per user. Default for this parameter is the calling user's own context. Context=0 causes all contexts to be displayed in turn. Input file @\The trace file can be copied like any other file. This instructs TRACE to take its input from the nominated file. Output file @\File to which output is to be sent. @End(Description) @End(Group) @Begin(Group)@SubSection(TRY) @Begin(Description) @Index(TRY)@IndexSecondary(Primary="Command",Secondary="TRY") Format @\TRY Description @\This routine loads the software front panel and then tries to load the nominated file as a trial operating system. Note @\This routine was supplied for the CS3 operating systems practical. Random use will probably result in a reboot being necessary! @End(Description) @End(Group) @Begin(Group)@SubSection(USERS) @Begin(Description) @Index(USERS)@IndexSecondary(Primary="Command",Secondary="USERS") Format @\USERS Description @\The command USERS provides a list of the users currently logged on to the same Filestore as the calling user. @End(Description)@End(Group) @Index(VAX)@IndexSecondary(Primary="Command",Secondary="VAX") @IndexSecondary(Primary="Log On",Secondary="VAX") @Begin(Group)@SubSection(VAX) @Begin(Description) Format @\VAX Description @\@Begin(Multiple)The VAX command allows the APM user to access the ECSVAX/VMS system over the ethernet, so that the terminal can be used as a VAX terminal. As this is a Network Terminal connection, rather than a direct one, some facilities may not work in the customary way or may require special action. This facility should be used sparingly, because the mode of connection puts a heavier load on VAX than ordinary terminals. Throughout the VAX session, all commands and data are being directed to the VAX system. A return is made to the APM system command level when the VAX process to which the user is connected stops (normally when the user logs off VAX). @End(Multiple) Examples @\}VAX @End(Description)@End(Group) @Begin(Group)@SubSection(VTOL) @Begin(Description) @Index(VTOL)@IndexSecondary(Primary="Command",Secondary="VTOL") Format @\VIEW:VTOL , Description @\This command takes a VIEW format file as input and produces a file (default extension .LAY) in LAYOUT source. @b[Parameters] -Laser @\instructs VTOL to produce the output in LAYOUT 1.5 format (suitable for the laser printer. If this parameter is omitted the file will be produced in the VAX LAYOUT source format. The command accepts parameters through PAM. @End(Description) @End(Group) @Begin(Group)@SubSection(WHO) @Begin(Description) @Index(WHO)@IndexSecondary(Primary="Command",Secondary="WHO") Format @\WHO Description @\This command takes no parameters and displays your user name, irrespective of which directory you have SET to. @End(Description) @End(Group) @Begin(Group)@SubSection(WHOIS) @Begin(Description) @Index(WHOIS)@IndexSecondary(Primary="Command",Secondary="WHOIS") Format @\WHOIS [,....] Description @\This command searches the system manager database for the specified directory and prints back the directory owner's name and his user group. Parameter @\List of directories separated by commas. If no parameter is supplied the information will be given for the user who called WHOIS. @End(Description)@End(Group)