Google
 

Trailing-Edge - PDP-10 Archives - decuslib10-05 - 43,50337/21/hmess.dmp
There is 1 other file named hmess.dmp in the archive. Click here to see a list.
\
!!!HELPMESS
:\;Give a line in a procedure, which can be an answer to an arbitrary;question in a conversation with FETCH.;The procedure is terminated with END.\\
INDEX\;.INDEX,INDEXNAME;;To reactivate the set of records previously saved;through the .INVERT command and the retrieval operation;following it.;After an .INDEX command the set of records specified there;will be subject to the searches specified throug .AND and .OR;commands.;;.INDEX,,0   will reset current record type as basis for;search operations (i e cancels the effect of a previous .INDEX).\\
RESET\;Resets several control parameters to the values they had;on entering FETCH. Can be used if an undefined situation is;suspected due to interdependence between commands.\\
DEFINE\;.DEFINE,SETNAME,OWNERTYPE,MEMBERTYPE;;To create a set specification in the data base.;It is given a name and assigned types allowed for;owner and member records.;Set occurences can then be created using .INSERT;and manipulated using .SET, .OWNER and .REMOVE;commands.\\
SET:\;Specify set to be followed in search operation. The;scan is started by going through all the records of the;type specified as owner in that set.;;To terminate SCAN operation , answer with .TYPE if;you want the resulting records to be typed, .INDEX if;you want to save them for later reference.;;The question CONDITIONS: is given if a set name was given as answer;to th SET:  question.;;;Give conditions to select records of the owner type;of the record being scanned. Note that the member records;are owners in the next step of the scan operation.;The question FINAL CONDITIONS: is given at the bottom level.;;Give conditions to select records of the member type on;the bottom level of a SCAN operation.;The actual scan is not started until this;final answer has been given.\\
STORE\;.store[,recordtype];;Store a record of given type ( if type omitted then the;type given in the latest .type command is assumed).;The user is prompted to give a value for each field;of the record.\\
SELECT\;To start from owners within set and;follow network to all members. Members found can then;be owners to other records which are reached in the next;step and so on.;On each level the user is prompted to give:  (a)  The;name of the set to be followed to the next level.;(b)  Conditions to select the records on the present level.;;The search is terminated by giving either .INDEX or .DISPLAY;as an answer to the  SET:  question.;;See further help information for the the prompting;question  SET:.\\
DISPLAY\;.DISPLAY,INDEXNAME[,FILENAME,SETNAME];;To list the records previously saved through an .INVERT;operation. The parameters filename and setname have the same meaning;as described for the .AND command.\\
DELETE\;DELETE,R1,R2,R3,  .......;;Delete the records with keys given (maximum 18).;They are automatically removed from sets where they are members, but;not from indexfiles.\\
DESCRIPTION\;Give text describing the procedure. This text will be;stored in the record representing the procedure and is;intended to facilitate maintenance.\\
FIELDS\;.FIELDS,rname;;To type names of data fields and their types for;the record type with name rname.\\
TTY\;To resume output of found records directly on the TTY;terminal. Cancels a previous .INVERT command.\\
APPEND\;.append,newname,iname1,iname2[,intersection];;Make logical operations on two sets giving a new;which is stored in the data base. Possibilities:;;newname = iname1  OR  iname2 (fourth par omitted);newname = iname1  AND   iname2 (fourth par = I);newname = iname1  AND NOT iname2 (fourth par = NOT)\\
TABLE\;.table[,tabname,store];;To specify a table to be produced as output from a;search operation.;If tabname is given then a table definition with;that name is assumed to already exist in the data base,;otherwise the user is prompted to specify one. If;tabname,store is specified, the new table definition;is stored in the data base for later reference.;;The user is prompted to specify fields to be output;from the records found on a sequential file (as;later specified as an argument to the .AND, .OR;commands).  Numeric fields can optionally be summated;for the records found.;;See further the help info for the questions issued when;the .TABLE command is executed.\\
OVERWRITE ?\;There is an old record in the base with the same;key as the one just specified.;If you overwrite the old record will disappear.\\
REMOVE\;REMOVE,setname,ownername,MBr1,mbr2,  ......;;Remove from set SETNAME for owner OWNERNAME all the members whose keys;are given (MBR1,MBR2  .....  up to 18 member keys).\\
OR\;As  .AND but the conditions are or-connected i.e. the;search is a match if some of the conditions are;satisfied.  See further  the  .AND command and the;help information  for  asterisk *  .\\
TERM:\;Here you can answer either:;;1.  With a fieldname for the current record type.;     Then the value of that field will be typed.;;2.  FIELDNAME=newvalue  where newvalue is a valid;    value for the field specified. This value;    will then replace the old value. (Updating;    individual fields).;;3.  .     if you want all fields for the record printed;    with their names and values.;;4.  FIELDNAME oldstring=newstring;    where oldstring is an arbitrary string not containing "=";    and newstring is an arbitrary string which shall replace;    the old string. Only the first occurence is replaced.\\
TYPE\;.type,rname;;This command is used to specify current record type.;The retrieval commands .AND and .OR  are working on;records of that type, and also retrieval of individual;records by just giving a key.\\
COMMAND\;.command,cprocname;;To define a command procedure with given name.;The user is then prompted to give a description of it;and then give its statements one per line.;A statement can be any line in a conversation with FETCH.;Arguments to the procedure call will replace the strings;%1, %2, %3   up to %9.;;Procedures are stored in the data base as records of;the type CPROC, and can thus be updated in the usual way.\\
EXIT\;To close all files involved and terminate FETCH execution.;On termination with CONTROL C ( or runtime error) part;of the updates made may be lost.\\
AND\;.and[,filename,setname];;Retrieval of records of current type (as set by the;.type command) . The user is then prompted with an;asterisk to give and-connected conditions.;;When filename is specified output is made to a sequential;file with that name. The contents and format of that;file must have been previously defined using the;.table command.;;If filename = "NAMES" then only the keys of the records found;are listed on the terminal.;;If setname is given then data for the owners of the records found;are typed (instead of data for the records themselves).;\\
INVERT\;.invert;;If you want the records found in a retrieval operation;(.and, .or  commands) to be saved as a pointer array;for later reference instead of being listed directly;on the terminal use this command.   To resume direct;TTY output mode, use the  .TTY  command which cancels;an earlier .INVERT command.\\
GIVE NEW NAME:\;Give a new name for the record just specified.;The name given before is already used as key;for an existing record which should not be overwritten.\\
OPEN\;.open,filename[,imagesize];;Open a data base file. Must always be the first command after;entering FETCH. Imagesize has default value = 68.;;Several data bases can be opened in the same run, and then;the OPEN command will also close the data base;previously opened. An OPEN for the same file that;is already opened will close and reopen it which will;ensure that all updates done will be stored properly;in the file.\\
HELP\;.help,commandname;;where commandname is a command keyword for which help information;is wanted. It could also be one of the prompting questions;issued in the FETCH conversation, and then the same text will be;typed as with a question mark as answer to that question.\\
*\;*  (asterisk);;This prompter is used to request retrieval conditions;on the records scanned. The must have the form:;;     FIELDNAME  OP  CONSTANT;;where FIELDNAME is a name of a field within the current;record type.  OP is a relational operator, either: =  /=  <  >;>=  <  <=  .   and  CONSTANT is a constant which is a legal;value of that field.;;To finish sequence of conditions, answer with return.;;The logical connectives .AND, .OR can also be used to;form sub-blocks of conditions . Each extra connective;must be matched with a return.\\
>\;Answer with either:  key for a record;or with a command starting with a period.;After that comes a command keyword, of which the three first characters;are significant, and then parameters separated by commas. No spaces are;allowed in command strings.;The following commands are available:;;HELP    TTY     TABLE   SET     TYPE    EXIT    DISPLAY OWNER;INVERT  FIELDS  SELECT  APPEND  AND     OR      DEFINE  INSERT;REMOVE  DELETE  RESET   MAKE    COMMAND INDEX   STORE   OPEN;;If you want more information about a command;then give the command .HELP,commandname;where commandname is one of the keywords listed above.\\
.\;To list all data fields of the record found;by giving a key (instead of command) on the prompting >.;It is a valid answer on the question TERM: .\\
NEXT ACTION:\;Answer either:;;.DISPLAY;        if you want the records found to be output on the terminal;        in standard format, all data fields.;.NAMES;        if you want only the names (=keys) of the records typed.;.AGAIN;        if you want to make further searches on the set of records;        now found.;.INDEX,INDEXNAME,REMARK;        if you want the result saved as a pointer array for;        later reference.;        There are the commands .INDEX and .DISPLAY to do this;        on the top level (When prompted with > ).;.EXIT;        if you don't want any new action.\\
SET\;SET,setname,ownername[,filename,setname];;To type data for members in a set. Filename and setname have the;same meaning as for the .AND command.\\
INSERT\;.INSERT,SETNAME,OWNER,MEMBER1,MEMBER2, ...;;To insert records into a set occurence. The set must have;been defined previously through the .DEFINE command.;OWNER and MEMBER1, MEMBER2  ...   must be keys of existent;records of the types given in the .DEFINE command.\\
OWNER\;OWNER,setname,membername[,filename,setname];;Type data for owner of record membername in set setname.;Filename and setname have the same meaning as for the .AND command.\\
MAKE\;With this command you can make an indexfile by;enumerating the keys for the records.\\
GIVE INDEX NAME:\;You must give a name for the indexfile.;This is the key of a record of type INDEXFILE;which is stored for later reference via the;commands INDEX,DISPLAY and APPEND.\\
KEYS:\;Write the keys (names) for the records you;want to have in the indexfile in the following;form      /key1,key2,.....,keyn/\\
FIELDS:\;Give the tablefields in the form:;/field1,field2,.....,fieldn/\\
COLUMNS:\;Give the columns for the fields and as;last element the recordlength for the tablefile:;/colnr1,colnr2,....,colnrn,recordl/\\
REMARK:\;Here you can write a remark or a comment;within slashes (/remark/) or just return.\\