MDBS INTERACTIVE DATA MANIPULATION REFERENCE MANUAL

Texte intégral

(1)MDBS INTERACTIVE DATA MANIPULATION REFERENCE MANUAL. The. IDML MANUAL. MDBS. Version. Micro. Data P.. Lafayette,. Base. 3.08. Box. O.. Inc.. Systems,. Indiana. 248 47902. USA. Telex:. (312). 209147. 303-6300. December. ISE. UR. (in Illinois). 1985. Copyright Notice This entire. employees. Inc . , and agreement. (C). and is provided for the use of the customer the customer ' s entire contents have been copyrighted by Micro Data Base Systems, reproduction by any means is prohibited except as permitted in a written Inc. with Micro Data Base Systems, manual. The. COPYRIGHT 1981. Yicro. Data. Base. Systems,. Inc.. Rev.. 85A. 3253324.

(2) NEW. RELEASES,. VERSIONS,. AND. A WARNING. ,. Any. proqramminq enáeavcm QÉ the magnitude of the MDBS software Realizinq this, Micro necessarily continue to evcilve over time. 3ase Systems, vows to provide its users with updates Inc., to version Foe a ncjminai handling fee.. will Data this. versions qÉ MDBS scÁtware will be cQnsidered as separate products. Qcmever, bcina fide owners cjf previmus versimns are generally entitled to a preferential rate structure.. New. Final1jj, each copy of our scÁitware is ?ersQnalized to identify the licensee. There are several levels of this personalizatimn, some of which involve encryptimn methcñs guaranteed to be combinatorially ciecypher. have been ?rQduced with a very Our products to difficult and to say ncNhinq of the substantial investment of capital labQr, oF primr involvement the base management área by our in data years we ccnicerned about any Accordinqly, are seriQusly principals. unauthcmizeei cogyinq qÉ mir products and will take any and all avaLlable legal acticjñ aqaimst illegal copying or distribution OF cjur products.. (C). CCJPYRIGFIT. 1981. Micra. Data. Base. Systems,. Inc..

(3) !q)Bs. IDML. MDBS. MANUAL. Table of Contents. ,. CHAPTER A. B. C. D. .. e. CHAPTER A. B. C D. . .. CHAPTER A. B. C. D. .. CHAPTER A. El. C. D E. . . .. CHAPTER a. B. C. .. D. CHAPTER A. B. C. CHAPTER A. B. CHAPTER. I.. OVERVIEW. ion. Int roduct Us IDML. ing. IDML. Commands. .. . . . .. . . . .. . . . .. . . . .. Notational Conventions On-Line Help. . . . . II. DISPLAY COMMAND Syntax . . . . . . . . Synops is . . . . . . . Description Examples. III.. .. .. .. . .. . . . . . .. . .. . .. . .. . .. . .. . . . .. . . . .. . . . .. . . . .. . . . .. . . . .. . . . .. Description. Examples . IV. DEFINE Syntax. . Synops is .. Description. . . .. . . . .. . . . .. . . . .. . . . .. . . . .. . . . .. COMMAND'.. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . . · . . . . . . . . . . . .. . . . . . . . . . . · . . . . . . . . . . . .. . . . . . . . . . . · . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . · . . . . . . . . . . . .. . . .. . . .. . . .. A-l to A-3 B-l to B-2 . . . .C-l. Examples . . Advanced Usage of Macros with Parameters. V. READ, ECHO AND COMMENT COMMANDS Syntax. . . . . . . . . . . . . . . . . . Synops is . . . . . . . . . . . . . . . . .. Description Examples . VI. QUIT Syntax. . Synops is .. . .. . .. . .. . .. . .. . .. . . .. . . .. . . .. . . .. .. .. .. .. .. . . . . .. .. COMMAND. Description VII. STAR-TUE_EÍLE Overv iew.. . . . . . . . .. . . . . . . . .. . . . . . . . . .. Creating the STARTUP File VIII. IDML ERROR MESSAGES. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . . . .. . . .. . . .. . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. l l l. . . . . . . . . . . .. INTERACTIVELY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .. INVOKING DML COMMANDS. Syntax . Synopsis.. MANUAL. IDML. 2 4 4 5 5 5 5 6 9 9 9 9 13 15 15" 15 15 17 18. !9. 19 19 19 20 21 21 21 21 23 23 23 25. APPENDICES APPENDIX APPENDIX APPENDIX. (C). A. B. C.. COPYRIGHT. DML DML DML. Command Commands Command. 1981. Micro. Break-down .. .. .. .. .. .. String Forms. Data. Functicn. by . .. . .. . .. Base Systems,. .. .. . .. Inc.. Rev.. 85A. i.

(4) MDBS. IDML. MDBS. MANUAL. I. A.. IDML. MANUAL. OVERVIEW. Introduction. The Interactive Data Manipulation Language (IDML) is an approach approaches MDBS data bases. access Alternative to accessing QRS IDML QRS, IBS and RDL. in that include the DML, is similar to independent is interactive, of any host language, and supports several QRS commands (such as DISPLAY. READ, and user-defined macro commands). IDML is similar inOMS that supports most of the DML to the DML commands MDBS a With IDML, Manual. presented can user in the command commands DML DML a each these execute one-at-a-time. of prompts the user for processor requires data inputs, then the IDMLcommand DML a data appropriate extracts data from a data values. base, then the extracted values are displayed at the console.. III. it. it. If. If. is particularly valuable as an aid in learning and testing logic. is also valuable for quickly making low volume, ad hoc It values changes to data and their interrelationships, without writing a in program. conditions as specified All data integrity and security the ddl are automatically enforced by IDML. Synonyms as defined with the DDL are generally recognized by IDML. IDBQ,. DML. B.. Using. IDML. IDML Simple instructions are included installation and execution IDML Once has been manual. system in the pertinent specific IDML be executed from the operating system. can be installed, can invoked with a -b argument on the command allocate line to explicitly the page buffer region. is not specified, this argument approximately half of the available memory is automatically allocated. Thé remainder base of available memory is reserved as a non-data work working space (e.g., areas). control blocks, stack, sort the has the form -bnnnnn where argument is used, nnnnn is the (decimal) number of bytes to be allocated for the page buffer region. This number should be at least as large as the "minimum Dl4S buffer region size" reported by the DDL Analyzer, otherwise OMS command too large a page buffer status error 31 results. region is requested, an error message indicating "excessive memory request" is The remaining displayed. memory reserved for non-data base working However, space is normally sufficient. in rare cases this working be may space insufficient, resulting in various kinds of error conditions and situations where the data base may be le£t open. In such a case, -b can be used to allocate a smaller page buffer region to allow a larger non-data base working space.. it. If. file. If. it. If. the user In the operating system command can also line, of name the the by optionally specify -r followed transaction log file system to be used during Thethe IDMI, execution (see the pertinent manual). disks containing the main data base area and specific the log file must be on-line.. (C). copYRIgaT. 1981·. Micro. Data Base Systems,. Inc.. Rev.. 85A. l. ".

(5) MDBS. IDML. manual. -. OVERVIEW. i.. mdbs. -. IDML. manual. IDML when the banner is executed, processor an IDML message This the console banner by screen. appears can be suppressed on including a -m argument in the command line used to invoke the IDML name of In any event, the user is prompted for the processor. the main data base area, user name, and user password. These prompts by including -d, can be suppressed -u and -p arguments on the command invoke used, the -d should used be followed IDML. line to Similarly, -u and -p should be followed immediately by the name. by the user name and password respectively.. file. If. file. checks to see whether the user name and password are valid then the I: prompt is for the indicated data base. are they valid, If issued and the data base is automatically opened. This means that command IDML IDML Ari command. is ready to accept an IDML is terminated by pressing the carriage return key. finishes After ÍDML to command, the I: prompt is again issued to show that its response IDML ready is to accept the next command. IDML. Execution of IDML is terminated by entering either QUIT or BYE. automatically closes the data base. This returns control to the Pressinq the "soft interrupt" key (ESCAPE on most operating system. IDML operating systems) interrupts the activity and results in the I:. This. prompt.. Chapter which. file,user.. VII. IDML. and C.. IDML. explains how to create and make use of a STARTUP can automatically utilize to identify the data base. Commands. The Interactive Data Manipulation Language supports a vatiety of commands. standard a user is allowed to define In addition, commands The standard other commands (called macro commands). IDML have the following effects: supported in. still. provide on-line descriptions of IDML command usage display selected data dictionary contents commands. l) 2). DISPIAY:. 3). DML. BELP:. AMM AMO AOM AOO. AUI CCU CRA CRS DBCLSA DBCNV DBENV DBOPNA DBSAVE DBSSTAT DRC. 2. Rev.. BSA. supported:. DRM DRO FDRK FFM FFO FFS FLF'! FLO FMI FRISK FNM FNMI FNN!SK FNO FNOI. (C). FNOSK FNS. GFM GFO GMC GOC GTC GTM GTO. FOl FOSK PPM FPMI FPMSR FPO FPOI FPQSK FRK GETC GETM GETO GFC. COPYRIGHT. INS lOS LGFLSEI LGMSG NLAU. MCC MCF MCP. 1981. Micro. MRTF MRTP MSF MSP NCI ODRK OFM OFO OLM OLO OMI OMSK ONE!. ONMI ONMSK. Data. ONO ONOI ONOSK OOI OOSK OP!!! OPMI OPMSK QPO OPOI OPOSK ORK PFC PFM PEO. Base Systems,. Inc..

(6) MDBS. IDML,. MANUAL. OVERVIEW. - I. SCD SCM SCN SCO. PUTC PUTM PUTO RMS. ros. SME SMN Sl90 smu SOC SQE. SDC SPIC commands. These Manual.. have the. Multiuser version of the DML. multiuser Loqqing not being. commands. 4). DEFINE:. 5). define macro. READ: read ECRO: echo COMM"ENT:. 6) 7) 8) 9). SOM SON SQQ SOU. SP!M. scu. RS!'! RSO. have. MDBS. SUO SUU TCN TCT. sue. tmn. SUM SUN. TMT TON. MANUAL. IDML. TOT TUN XMM XMO xom XOO. effects described. in the MDBS OMS a will have no effect used. being is not the RTL form of IDML is. if. commands IDML processor. if. e£fect. no. used.. commands. and execute the IDML commands on a disk a message to the console screen set the symbol used to denote a comment FILLCHR: character set the symbol to be used as a during data entry QUIT: stop processing IDML commands. file. fill. commands The These that follow. are described in the chapters the shows the shown presented above. are in Figure order MDBS DDL the sample presented Chapter logical in of structure One additional Manual (in Figures II-3 and III-1,2). set (ISKL) has been added to this schema. manual examples are based on in this All the logical structure oft Figure commands. I-l. II. I-l.. iE!qé. ; IDE?. DE?T. E?'!PLC)YEÉ. DNUMBÉR. ID LASTNAME KAS. MAMÉ. ,. SYSTEM. DETAILS. FNAMÉ. '. LOCATION. 3ÍOGRAPH. ,. PASTJQBS. L!NE. YTDEARN b. ;WJSSESS. FILLEDBY SKILL. JOB. IJQB. '. Figure. (C). COPYRIGHT. 1981. NEEDS. JCSCODE DESCRIPT. Micro. SKILCDDE DESCRIPT RATING. I-l.. Sample. MDBS. .T III. Data Base Systems,. ISKL. Schema. Inc.. Rev.. 85A. 3.

(7) MDBS. IDML. d.. NQtational Conventions. - I.. XANUAL. OVERVIEW. -. MDBS. IDML. MANUAL. each clause describing the syntax of an IDML command, is These two symbols are not used enclosed and >. within the symbols command clauses within an IDML to separate In actually itself. command, IDML two clauses in a command can be separated by statinq an either blanks or a comma. When. <. documentation, and other keywords purposes of syntactic User-determined faced elements are indicated with bold type. literals command a bold faced example, the For not display of in are type. command has the syntax: For. <display><parameter><list>. A. display. command. determines. display E.. the. must parameter. literally and. command.. Cln-Line. list. with the word display; the user that are to be used in a particular. begin. E!elp. To get a provides an on-line help facility. display of IDML comnands, the word type information about help in Command syntax response is displayed using to the I: prompt. notational conventions similar to those described above. IDML. helpful. Cominand. typing the. 4. Rev.. syntax command. 85A. for an individual DML command can be seen name followed by a question mark (?) symbol.. (C). COPYRIGHT. 19 81. Micro. Data Base Systems,. by. Inc..

(8) MDBS. IDML. MANUAL. MDBS. MANUAL. DISPLAYCOMMAND. II. A.. IDML. Syntax <display>. or <display><parameter><list> or. <disp><parameter><list> B.. Synopsis. DISPLAY command can be used to obtain information from the data A DISPLAY dictionary about areas, record types, sets, or data items. command be the used to obtain data dictionary cannot information DDL data Manual, base was initialized with the o"option (see MDBS Chapter VI). A. if. C.. Description There. used. in. a. are. DISPLAY. permissible one-character parameters tour command: jnfnrTna.fjnn. <piíriTl}erer>. di5p1aYed. that can. be. ,aMut. all areas data items all language used for sorting all record types all sets. a. i. lr s. optionally list in canorder parameters to. specified with the a, i, r and s restrict the displayed information toThisa data item, record type, or set (respectively). particular area, in more detailed information than what is obtained without results specifying the list. A. be. <1i"ñ">. f11nctjc)n. a. area. i. record type name,data. r. record type. s. set. display information about the indicated area display information about the item in the indicated record type display information about the indicated record type display information about the indicated set. <pa.rA.meter>. name. COPYRIGHT. name. name. name. IE both and <parameter> command, the prompted is user parameters, as shown below: (C). item. 1981. Micro. <list> are with a. Data Base Systems,. omitted. list. Inc.. oF. from the. a. DISPLAY. permissible Rev.. 8·5A. 5.

(9) MDBS. IDW. The h. MANUAL. - II.. following (a). (l) (r). (S). COMMAND. MDBS. -. IDML. MANUAL. display options are available:. display display display display display. (i). DISPLAY. areas items language records. type. sets. desired display option:. Enter. schema information is available to a user through The only kinds CE data dictionary information are user names, that are not available with the DISPLAY command passwords, and user access codes. Read and write access codes for data items, record types, or sets are not displayed. However, areas, the whether he has read and/or write access user is informed to the area, data item, record type or set being displayed. the. Virtually all DISPLAY command.. The response I: prompt D.. key can be used Escape as soon as the desired reappears.. to interrupt the DISPLAY command's The information has been displayed.. Examples DISPLAY. R. DISPLAY. R. displays. SKILL. SKILL. S. DISP DISP. information. displays summary record types. IEMP. A. for. all. detailed information for record type. the. displays detailed set iemp. information. for. the. displays. summary. information. for. all. detailed. information for item within the. DEPT. areas DIS!?. I. DEPT,. LOCATION. displays. LOCATION. record DISP. 6. Rev.. displays the language for sorting. L. BSA. data type. (C). copYRIgaT. 1981. Micro. used as. a. ijata Base Systems,. the. basis. Inc..

(10) MDBS. IDML. Sample. MANUAL. session. I:. using. II.. the. DISPLAY. DISPLAY. COMMAND. MDBS. -. IDML. MANUAL. command:. disp r. SYSTEM. title: synonyms. (none) (none) (none). :. owned by: owner of: items :. SSYSSET,. IEMP, IDEP,. IJOB. (none). DEPT. title: synonyms. (none) (none). :. owned by: owner of :. IDEP HAS DNUMBER,. items:. NAME,. LOCATION. EMPLOYEE. title: synonyms. (none) (none) iemp, FILLEDBY, HAS POSSESS, DETAILS. :. owned by: owner of : BIOGRAPH. titíe: synonyms. (none) (none) DETAILS (none) LINE. :. owned by: owner of:. items:. SKILL. title: synonyms. (none) (none). :. owned by: owner of :. POSSESS,. needs,. ISKL. (none). items:. SKILCODE.. DESCRIPT,. RATING. JOB. title: synonyms. (none) (none) IJOB FILLEDBY,. :. owned by: owner of :. items:. (C). COPYRIGHT. 1981. JOBCODE,. Micro. NEEDS DESCRIPT. jjata Base Systems,. Inc.. 7.

(11) MDBS. IDML. I:. áNUAL. disp r. skill. -. II.. DISPLAY. title: synonyms. IDML. MANUAL. (none) (none). :. POSSESS,. s. NEEDS. (none). items:. disp. MDBS. -. skill. owned by: owner of :. I:. COMMAND. UNSIGN SKILCODE STR DESCRIPT REAL RATING. 2 55 2. iemp. iemp. title: synonyms. (none) (none). :. N: M MANUAL IMMAT SYSTEM AUTO SORTED EMPLOYEE. type:. owner insertion: owner oUer: owners:. member member. insertion: order:. members:. I:. disp. a. JQBS. title: synonyms. (none) (none). :. READ,. access:. WRITE. JOEll. title: synonyms. (none) (none). :. READ,. access:. WRITE. JOB2. title:. synonyms access:. I: dept. disp. i. (none) (none). :. READ. dept. location. location. title: synonyms. (none) (none). :. STR. type:. 8. (C). COPYRIGHT. 35. 1981. Micro. Data Base SYstems,. Inc..

(12) MDBS. IDML. MDBS. MANUAL. MANUAL. IDML. III. INVOKINGDMLCOMMANDSINTERACTIVELY A.. Syntax <dml. B.. command. name><command. string:. '. Synopsis. name invoked interactively by stating its command MDBS OMS, a string strinq. its just as with consists of from zero to three arguments indicating the data item, record type, set and/or area names that are pertinent to the DML command C). with which the command string is being used (see Appendix assignment AUI) and However, (e.g., in IDML some DML (e.g., SUM) commands a DML also require numbers in their command strings. command needs input data to store into the data base, then the user is prompted for the needed data. a DML command extracts data from the data base, that data is displayed at the console. A. and. command DML command. can. be. utility. If. If. is provided to obtain the command string form for any also indicates whether data will be passed to or from the data base. a command results from status other than If command, command DML a then a executing status message is displayed at the console.. facility. ? A DML command;. C.. it. O. Description To. execute. a DML command command. interactively,. simply enter its that valid in. an appropriate string. IDML within are presented in string entries for each space or comma can be used to string. Entries within string When blanks or commas. accepting command string to upper case.commandThus upper and lower intermixed when stating a string.. command names can A and B. The Appendices command C. Appendix are shown from name a command separate separated a command are IDML a DML command, DML. its by. name and be used command A blank command. either translates the case. can. be. DIQI.. strings can contain area names, set names, data item numbers names In addition to consulting (i.e., integers). C, a user Appendix can also find out about the command string form for a given DML command by entering the DML command name followed by ?. For instance, to find out the command string composition for SMM, Command. and. enter:. smm? IDML. responds. syntax of. (C). COPYRIGHT. with: SMM. 1981. is:. Micro. SMM. set set. Data Base Systems,. Inc.. 9.

(13) MDBS. IDML. which. MANUAL. -. indicates. string.. that. two. is:. SMU. see the. To. INVOKING. III.. om. COMMANDS. -. set names are needed, in string for SMU, enter:. command. MDBS. the. IDML. SMM. MANUAL. command. smu? IDML. with. responds. of. syntax. indicating. and the def ined. SMU. set number. that the first entry in the command string is a set name entry is a number (in this case the number of a usercurrency indicator) . second. IF a command then the ? base, For instance,. involves data input to or data output from the data facility will show that a data transfer is involved.. cr"s?. will result in the following CRS syntax is: CRS OiE. IDML. response:. record. {dataj. that the command string consists of a record name and that a The " transfer is involved. ]" surrounding the word "data" data entered not is not indicates that is on the command line. command the string. of part show. ing. É. data. it. IDML IE then the user expects data input flor a DML command, is prompted example, For an for the needed data values. create to of the EMPLOYEE record type, the occur rence following interaction would be used (user responses are underlined) .. I:. m". !emp1. oYép ID:. enter enter enter enter enter enter enter. g?74R796?. LASTNANE: FNAME:. ELCZK. PASTjQBS: PASTjOBS: PASTjOBS: YTDEARN:. == Marl'etinq. UAAQ. by pressing terminates the entry of each data value user the Notice that since PASTJOBS is a repeating data carriage return key. the user is given three opportunities item (that occurs three times) , PASTJQBS the user specified values. for specifying In this example, the cwo of oníy three possible values.. The. reads entering data for non-numeric data items, IDML in maximum the data blank the size of with item on characters up to something the other than a blank is desired for character right. theIE FILLCHR command data items, can be used to designate a non-blank When be FILLCHR is invoked should symbol character. as the when. fill. fill. 10. Rev.. 85A. it. (C). COPYRIGáT. 1981. Micro. Data Base Systems,. Inc..

(14) MDBS. IDML. MANUAL. INVOKING. - III.. DML. COMMANDS. MDBS. -. IDML. MANUAL. followed by either the desired symbol enclosed in a pair of quotes the whose ASCII character equivalent will serve as an integer For instance, character. FILLCHR causes. with. fill. O. subsequent values entered for character data items To later the null character. revert back to blank ". FILLCHR would. or. to. be. fill. filled. ". used.. be. entering data for a numeric data item, IDML issues the OMS status of 33 if the value is out of the maximum possible range allowed for that data item's size under IDML. If any value being entered is outside of the feasible range of values for the data item command a feasibility ranqe is specified in the DDL), then the (if When 30 prompted for a data value, pressing is returned. status of data the carriage return key will be interpreted as a for numeric items and a blank for other data items. When command. OMS. O. a. command a non-zero If command, then that. DML. and che. I:. that data is displayed is retrieved by a command, data the For instance, console. that was just loaded see to command,. when the the. is issued.. prompt. executing status results from interactively command status is displayed at the console. above. I:. data. the. CRS. GETC. command. coulá. be. at. by. used:. == ID:. 923487962 Smith Bob Marketing PASTjOBS: PASTjOBS: Sales. LASTNAME: FNAME:. PASTJOBS: YTDEARN:. Notice that. IDML. Several. 48000. provides the data item. name. for each data vaíue.. commands utility user-defined. as well as assignment (aui,ccu,dbenv), (scu, smu, indicators currency squ, suc, sum, sun, suo, suu), must have numbers specified in their command MDBS Dl4S command With these numbers were not strings. part strings, but were passed with data blocks or program record types. The use of a number within a command string is illustrated by: commands. involving. OE. i: I: I:. siuü. syntax for 1 =tÁ. SUM. The. is:. SUM. result is that user indicator current member of SET3. (C). COPYRIGHT. 1981. Micro. number. 7. set. is assigned. Data Base Systems,. to. Inc.. be. the. same. Rev.. as. the. 85A. li.

(15) MDBS. IDML. - III.. MANUAL. INVOKING. DML. COMMANDS. -. MDBS. IDML. MANUAL. is emitted from a command string, defaults to Ifset a nameset specified The itsame is in a command string. true. last number. and area,. that. suppose. we. item,. data want to. scroll. and record type names. through all department. the Eor As an example, names:. =". I: FEM syntax for FFM is: set 9ÉA" I: syntax for GFM is: GFM item set I: I: m= NAME : cust support I: I: 9Íí! NAME: production I: gíln. i:. = =4 = =. Ldataj. .. NAME:. R. &. D. 0 O 0. I: DMS. =. command. status 255. Notice that in the first usage of GFM the set name was not specified, so defaulted to the last set name that had previously been idep) The same specified (i.e. , is true for the usage of FNM. In . second (and subsequent) the was not usage of GEM the data item nante specified, defaultéd to the last item name that had previously so been specif led i. e. , name) . In commands where two sets are required, the saved. For example, one the íast set is. it. (. it. if. som. has idep. is the default set type remembered by same convention also holds if two numbers are required for str inq. is. 12. executed,. Rev.. 85A. idep. (C). COPYRIGHT. 1981. Micro. IDML The . cominand a. Data Base Systems,. Inc..

(16) MDBS. IDML. D.. Examples. I: I:. i: i:. I:. i:. I:. i:. I:. MANUAL. (user. gÁá2 syntax :QLá. enter enter. = í= GLá. emp]. DNUMBER: NAME: LOCATION:. for. = enter. record. -. MDBS. IDML. MANUAL. Idatal. JL4. persínnne.|. Martjn¶vi11e IMS. set. 1V4V777. ID:. LASTNAME: FNAME:. =Q=. PASTjOBS: PASTjOBS: PASTjOBS:. ¢=k UZ22. YTDEARN:. oYee ID:. g?3487gK?. enter enter enter enter enter enter enter. LASTNAME: FNAME:. enter enter enter enter enter. LINE: LINE: LINE: LINE: LINE:. ELCút. PASTjOBS: PASTjOBS: PASTjOBS: PASTjQBS:. &úkh Ma.rketjnq SaLaa. UQQQ. YTDEARN:. i= hioqrÁph. GLá = quit. CRS. is:. IMS. COMMANDS. underlined). is:. CRS. DML. cnj'ee. enter enter enter enter enter enter enter emp1. INVOKING. responses. for. g,= enter. Zaa2 syntax. III.. -. Flirt..hciatQ grAd'ÍÁred. .3/?1/'A. =om. is:. set Idata]. Ejjj¿auQ. ==. chj.cAqn tY L942.. =aLa. f]ni\Ter5j. jjj. afea.. 0 0 0. i: i:. fmsl' " syntax For £mak 1&á1r. enter enter DMS. (C). COPYRIGHT. LASTNAME: FNAME:. command. 1981. FRISK. EQQ=. =. status. Micro. FMSK. 255. Data Base Systems,. Inc.. Rev.. 82A. 13.

(17) MDBS. IDML. I: I: I:. I: I:. 14. MANUAL. = 9ÉC. enter enter. INVOKING. III.. -. LASTNEME: FNAME:. DML. COMMANDS. 1981. Micro. -. MDBS. IDML,. MANUAL. =q=. £teve. Ytdearn 58392. YTDEARN:. Ma. = = í= =¿Q. DNUMBER: NAME: LOCATION:. 14. personnel. !gartinsville. quit. (C). COPYRIGHT. Data Base Systems,. Inc.. ·.

(18) XDBS. IDML. MDBS. MANUAL. IV.. A.. IDML. MANUAL. DEFINECOMMAND. Syntax <define>. B.. Synopsis. used to define macros (i.e., new, usercommands). These definitions are held in The the ciata base and therefore exist across QRS and IDML sessions. and menu-driven. interactive process is definition itself The. defined. command. DEFINE commands. can or parts of. be. is a word that can be equated to any section of an IDML that can be freely substituted for that portion of the command. can also be equated to an entire IDML command or to a It commands IDML Thus many sequence of (involvinq lines of input). a convenient means and macros provide for storing utilizinga later commands A macro often-used IDML for. or sections of a command. series of IDML commands is especially useful for iteratively executing DML logic. same the tMe user is prompted for any input needed by an command ID!4L a command within a macro returns within the macro. If command is displayed and macro execution status of 255, the statuscommand Any other non—zero continues. status will cause macro termination. A command. macro and. A macro used within QRS. IDML, provided defined with can later its text Parameterized consists of a valid command expression within IDML. macros are supported in IDML. When a macro is to be used for any part command DML string, that macro's name must be in upper case. of a A. macro. defined with. can later be be used within. IDML. QRS. be nested Macros Macrcis may not may, within other macros. be however, executed included within a command via the READ command (see Chapter V). Because synonyms are treated very similarly be recognized a not within macro text. synonym will to macros,. file. C.. Description When. the. command. DEFINE. displayed: Macro. '. (C). is. given,. Definition. the. following. menu. is. Utility. Macroi'Sy'nonym Functions: (A) Add a Macro (C) Change a Macro (D) Delete a Macro (I) Index of Macro/Synonym Names (L) List Macros and Synonyms This Command List (?) print Define (Q) Mode Quit Furiction? COPYRIGHT. 1981. Micro. Data Base Systems,. Inc.. Rev.. 85A. 15.

(19) MDBS. IDML. MANUAL. Thé effects described below. A:. The. IV.. DEFINE. COMMAND. these. seven. macro. of. MDBS. -. IDML. MANUAL. definition functions. are. for the name of the new macro and for the be A name must macro represent. will Use a and alphanumeric, cannot begin with of this macro digit. name within an IDML command will cause the macro's text to be The text for a macro plus the substituted for the macro name. 255 name the exceed of cannot Macros macro length characters. another the not macro are recognized. occurring within text of Synonyms occurring within the text of a macro are ñQt recognized. The macro is not translated to upper case; must be referenced in the same case with which is defined in this function. user. IDML. text. is prompted that. it. it. it. user is prompted for the name of an existing macro. is then prompted flor the new text for that macro.. C:. Hie. D:. The user. I:. An. L:. The. index. indented,. is prompted of. for the. name. all. of. macros and synonyms macros are not.. the. macro. to. be. is displayed.. The user. deleted. Synonyms. are. Pressing user is prompted for a macro or synonym name. the a (and key result in of all macros return listing will their name a of and all the user enters the synonyms. text) the user enters the particular macrQ, its text is displayed. name then the name of the of a particular synonym, area, set, record type or data item for which is a synonym is displayed. A may not user define a macro that has the same name as a synonym.. If. If. it. ?:. The macro. Q:. The user prompt.. 16. Rev.. BSA. definition functions are displayed. leaves the macro definition mode.. (C). COPYRIGHT. 1981. Micro. IDML. gives the. Data Base Systems,. I:. Inc..

(20) I'IDBS. IDML. D.. Examples. i:. - IV.. MANUAL. DEFINE. COMMAND. MDBS. -. (underlined characters are entered. by the. IDML. MANLLAL. user). defjnp Macro. Utility. Definition. Macro/Synonym Functions: (A) Add a Macrcj (C) Change a N!acro (D) Delete a Macro (I) Index of Macro/Synonym Nanies (L) List MacroS and Synonyms (?) Print This Command List (Q) Quit De£ine Mode Function?A Name?GE=. text below (terminate with uíú, johcnde táQA fi.11Mbv jjiQh. Enter. *GLÁ. = *= dniimMr *= ÍáQül u=. bioqraph. *í= *. = hm. an. empty. line). an. empty. line). = =. Function?A Name?N. Enter. *= *==. (terminate with. text below. *. Function?1 ONO SC CEMP N. Function?C Name?B. Enter. *=G. (terminate with empty line). text below. *1ÉÁÁñ. * Function?Q. .. (C). COPYRIGHT. 1981. Micro. Data Base Systems,. Inc.. Rev.. 85A. 17.

(21) MDBS. IDML. I:. MANUAL,. - IV.. C=E. enter enter enter enter enter enter enter enter enter enter enter enter enter enter GE=. I:. DEFINE. COMMAND. MDBS. -. IDML. MANUAL. jQBCODE:. 5 1?3443?10 ID: LASTNAI'E: Ferq|lsío,n. Kristin.a. FNAM-E:. 8aLÉS. PASTjOBS: PASTjOBS: PASTjOBS:. =. 22UQ. YTDEARN:. Au¿g«== Rackqrou.n,d .i.n,. LINE: LINE: LINE: LINE: LINE:. ¶a1psperson. 1?/13/51.. medicine gf tfte year. aM marketina. jjj lZZ2.. I. DNUMBER:. 0 0 0. EÉid. I: I:. Um. W. DNIMBER: NAME: LOCATION: A. I:. DNUMBER: NAME: LOCATION:. ti. I:. 3. cust support Indianapolis 5. production Lafayette. 0 0 6. A. I:. DNUMBER: NAME : LOCATION: OMS. Advanced. E.. 13. sales. Lafayette. command. status. 255. of Macros with Parameters. Usage. command, the text oF a macro with the DEFINE up embedded within the macro Each macro parameters can text. to parameter functions as a variable, whose value can be stated by a user whenever the the text of a inacr o For example, macro is executed. SQ be defined as: might called. specifyinq. When. 9. SOM. where. and. &1. interested the current. be. &1,&2 &2. are. in setting. member. used the. of. HAS,. to áenote macro parameters. current owner of POSSESS to then. the. macro would. be. be. Ifthea. executed. user. is. same. as. as:. SQ (PQSSESS,E1AS) 18. Rev.. 85A. (C). COPYRIGEIT. 1981. Micro. Data Base Systems,. Inc..

(22) MDBS. If to. IDML. - IV.. MANUAL. DEFINE. COMMAND. MDBS. -. the user is later interested in setting the current then the the same as the current member of IJCB, executed, parameter values: but with different be. MANUAL. IDML. owner. of. NEEDS. macro. same. is. SQ(NEEDS,IJOB) above examples show, IDML substitutes the values specified by a 'Me macro for the parameters declared in the original text. value appearing is following the macro name in the parentheses substituted for &l, the second value is substituted for &2, and so. the user. As. first. forth.. parameter is specified in macro When a user be an optional parameter. be indicated for an optional needs to defined to be optional by appending the the For example, followed by a space. As. a. if. &1. GETM. ,. can be defined to no a macro, executes value A parameter parameter. is parameter with the = symbol macro text for GP is. it. text,. &2=. then. the. value for. second parameter is the second parameter. optional. be. may. When. executing the macro,. omitted. a. GP(IJOB,) or. it. may. be. included. GP(IJOB,PUTC). Default values for parameters can also text. For instance, if the macro text for. be. SQ. SOl'!. u,. is. specified in the macro. &2=E!AS. HAS then second is the default value for this macro's SQ Whenever a user executes a value without specifying for IDML parameter, For instance, uses HAS as the value.. parameter. the second. SQ(DETAILS,). sets the current owner of DETAILS to a user of HAS. explicitly states then IDML Ifignores the default value. A parameter can the macro an example, FMSK PFM. finds name. finds. a. used more than. text. (IEMP,LASTNAW) of IEMP based on name.. PMSK member. last. COPYRIGHT. same. once. within. for. as the current member the second parameter, a. macro's. text.. As. &2,&1. a. a. the value. &1. record and then gives one of of this macro is PMSK, then. member's (C). be. be. 1981. Micro. a. its fields. sort key value. Data Base Systems,. Inc.. a. new. and. value.. If. changes. Rev.. 85A. the. that 18.1.

(23) MDBS. IDML. MANUAL. TV.. -. 'Rn1c'ñ. DEFINE. 'ír'ecif\'inq. h"'r. COMMAND. p1'ír(qmetf'rA. MDBS. -. IDML. MANUAL. in M'wrn Twf. l.. n parameters are valid macro parameters. are &1) S n S 9) ; &1 should should be &1, (where the leftmost parameter in the macro text ; the remaining parameters can be specified in any order within the InacrQ text.. 2.. Any parameter. 3. To. &1, &2,. &9. ., specified,... they be. .. signify. .... more than. can appear. that. once. in. is optional, follow the parameter in the macro text.. a. If. macro's. an equal number. parameter. a. must immediately whenever appears. it. 4. l. text. sign and space ) &5= (e. g. ,. specify. the parameter number a default value for a parameter, immediately and by equal the def is sign an followed desired ault Any letter or digit can appear in a default value. Any value. of the tollowinq characters is also allowed. To. .. ". [. ]. /. .. *. +. -. <. >. =. #. S. parentheses or are allowed in the default they are within a matching pair of double quotes. A parameter or macro cannot appear as part of a default value. a parameter can have appears multiple times in a macro's text, a different default value at each place appears. No. spaces.. commas,. value unless. it. it. fnr FYecl]tjnq. Mi1"S. macro name is parentheses ot set separated by commas.. l.. Tlie. 2. Macro. ii parRmprpri"pd. If. MrlcrQ. followed immeáiately (no space) containing the desired values.. by a matching The values are. evaluation the sUbstitutes parameter) leftmost. IDML is based on positional substitutions. &1 parentheses (the for value in the first the second value is substituted for &2 (the , a parameter) , and so Forth. next no value is given f or If commas) then two parameter consecutive the , i. e. , there are does not have a default parameter's default value is used. If value, but is optional, then the parameter is ignored. Omitting a value for a required parameter results in an error message. be The number of commas in a macro' s list of values must always one less than the number of parameters. If too many or too few values are specified, an error message results.. .. (. it. 3. .. commas, value cannot contain spaces, parameter or parentheses A a enclosed matching of double they unless pair in are quotes. be a used parameter cannot addition as value. In to digits macro and numbers, a value can contain any of the following characters:. 4. A. .. ". 18. .2. Rev.. [. 85A. ]. .. /. *. +. (C). -. <. >. =. #. COPYRIGAT. $. 1981. Micro. Data Base Systems.. Inc..

(24) MDBS. IDML. IDML. 64ANUAL. ECHOANDCOMMENTCOMMANDS. READ,. V. A.. MDBS. MANUAL. Syntax <read><file-name><batch> <echo><messaqe> <comment><symbol>. B.. Synopsis. containing. a causes IDML to read a disk IDML commands. these then executes commands. of series of all commands IDML the The file-name is indicated by that contains the The batch option can be used to indicate that all input to clause. commands the dml in the are contained itself; user prompting will not occur. The. file. command. READ IDML. file file's An. console by a. file. command By screen. command, READ ECHO. file. processing action can A. interpreted. C.. be. command. COMMENT. documentation. on the causes a specified message to appear processed embedding ECHO commands within the READ command's the of an ongoing commentary. as beginning purposes in. provided.. is used to designate the symbol that will be Comments a comment. included for can be a. file. processed. by. READ.. Description In using. the. READ. command,. indicated file name must be quoted within the host operating system, The is not on the default drive.. the. be Fully must qualified the drive number including and/or saved through the prepared, can be read, of IDML commands file !4DBS.DDL and same used editing, for creating, facilities that are DDL specifications. standard saving any Alternatively, text editor of IDML commands. read, and save the Any can be used to create, file command command IDML READ the with can appear in valid the command the READ file, For example, exception of a READ command. can be used to execute a series of macros. the If an error is encountered, READ command is terminated and any remaining lines in the READ command. and. if it. file will. (C). not. COPYRIGHT. be. read.. 1981. Micro. Data Base Systems,. Inc.. Rev.. 85A. 19.

(25) MDBS. IDML. MANUAL. READ. - V.. MDBS. COMMAND. is emitted,. IDML. MANUAL. the optional batch keyword that any DML command batch processing is user input results in user prompts. requested, each required input for a DML command will be read frc succeeding Thus for batch processing, the lines in the used by READ should contain data as well as DML commands. For example. If requires. If. fil.. file.. CRS. JCB. 125. President be Such a file must three lines in a READ command's file. data flor in a batch fashion and will not prompt the user of JOB values. The above three lines would result in a new occurrence 125 whose whose code and description is President. is for a job be might processed ,. file,. can be used in a READ command's in a startup a macro's (Chapter IV) VII) or in text to cause messages the console The message on following screen. an echo be A the the message can screen. output to next line on either a number (je a string of characters enclosed in a matching OF there is no message, a blank line is output. quotes. ECHO. commands. Elle (Chaptet to appear keyword will. be. pair. If. Whenever the ; symbol appears in a command, the remainder of the be a comment aná therefore cons-idered the by is ignored is to line command COMAENT IDML be used to designate The some can processor. The should symbol be other symbol as the indicator of comments. the enclosed comment keyword. in quotes tollowinq D.. Examples READ "QFILE" READ "B: BATCA.TXT" ECHO 29 ECHO "The ECHO ECZO COMMENT. BATCH. instructions. are. as. follows:. ". 'Processing is complete' ": ". 20. Rev.. 85A. (C). COPYRIGRT. 1981. Micro. Data Base Systems,. Inc..

(26) MDBS. IDML. MANUAL. XDBS. VI. A.. QUITCOMMAND. Syntax <quit>. B.. or. <bye>. SynQpsis The. (or. QUIT. automatically C.. MANUAL. IDML. closes. command the data base.. BYE). terminates. an. IDÑ!L. session.. It. Description The. the returns the user quit command terminates IDML and base QUIT closes the data (saving all macro operating system. data base area). IE a data base is not definitions in the be main used in the future. The "soft interrupt" key carincjt closeá, (CONTROL-C it cjn mQst systems) operating abort any current IDML will The the ncit operating system. but control to return activity, IDML prompt will. I:. Ec). results.. In addition to quit, bye may aisQ be used to close the data base return the user to the operating system. SuccessEul execution of the QUIT ccmmand is indicated by the "data base successfully closed" messaqe.. and. (C). COPYRIGHT. 1981. Micro. Data 3ase Systems,. Inc.. 21.

(27) MDBS. IDML. MANUAL. -. This. 22. VI.. page. (C). µ": r". CCMNARD. intentionally. COPYRIGHT. i981. MDBS. -. IDML. MANUAL. left blank.. Micro. Data 3ase Systems,. inc..

(28) MDBS. IDML. MDBS. MANUAL. VII. STARTUP A.. MANUAL. IDML. FILE. Overview. session as described in can begin an IDML command STARTUP a Chapter b. can be created Alternatively, I, Section main data name of the base which the user name, area, specifies When IDML IDML of commands. a password, is series user and/or named STARTUP a read executed, one is to activity its nameCí exists. there is none, the IDML processor looks for a main the STARTI and treats exists. as the startup name, area user name, or user password is absent from the STARTUP Then, all the IDML user is prompted for the missing value(s). commands When commands IDML STARTUP executed. these are on the have been executed, the IDML I: prompt is displayed. An. IDML. user. file. file. file, B.. Creating the The. File edited, and saved by using the The text editing facilities. to that used for creating an input file of command (Chapter VI).. can be created, file software or any other standard used. The A. is similar. flor. commands. START.. STARTUP. STARTUP. approach. user they. file. file. MDBS.DDL IDML. If. file if it. it. file. if. file. first. If. the. READ. First line name. file. of. the. (for. a. be password can optionally must appear in this order. START. "JOBS.DB". must begin file main base's area),. with. STARTUP. data. "D-LEHR". specified on this For example:. user. line.. the. word. and/or present,. name. If. "smiles". name of the Here JOBS.DB is the fully qualified containing the D LEHR a main data base and is "smiles" is the area, user name, from these the password. arguments is omitted any of line of STARTUP, the user is prompted for the missing the user value(s). appropriate values, IDML returns control to the fails to provide Each subsequent line of the STARTUP can operating system. consist of any valid IDML command.. file. If. The. STARTUP. drive/directory under. system. first If file. file. and which the. must. its. reside. on the currently consistent with the is working.. name must IDML user. be. logged-on. operating. startup information can be created on STARTUP the the than In this case, startup files other such a by can be used in place of the STARTUP information on name line that is on the operating system command entering the See the pertinent used to begin the execution of the ID!4L processor. system specific manual for details. In. many. operating systems,. file. (C). COPYRIGHT. 1981. file. Micro. file.. Data Base Systems,. file. Inc.. Rev.. 85A. 23.

(29) MDBS. IDML. MANUAL. -. This. 24. VII.. page. (C). STARTUP. FILE. intentionally. COPYRIGHT. 1981. MDBS. -. IDML. MANUAL. left blank.. Micro. Data Base Systems,. Inc..

(30) MDBS. IDML. MDBS. MANUAL. IDKL. MANUAL. VIII. IDMLERRORMESSAGES of that can occur in the interactive utilization ObiS errors command being executed with IDML, then various is If MDBS command These are described in the status messages can result. command "DP!S be DMS prefaced and will always Manual, with the phrase Those errors encountered within the IDML logic are described status". IDML.. These are a. DP!S. below.. ***Alternate. input. Explanation: A. file. files be. cannot. may. read. not. be. nested.. Possible Causes and/or Solutions:. l.. A a. 'READ' 'READ'. has been used on. command command.. ***Data dictionary. not. file. within another. from. read.. a. file. which. which. is. being. itself contains. accessible.. Explanation:. The data dictionary cannot be accessed with the DISPLAY Possible Causes and/or Solutions: The data base was initialized with the o option.. command.. l.. ***Enclose. file. Explanation:. Because names,. of. name. in quotes.. non-alphanumeric. characters which are allowed for file IDML requires that file names. for operating in quotes. possible Causes and/or Solutions: l. The file name specified must. systems,. many. be. ***File. not. be. enclosed. in quotes.. present.. Explanation:. The file specified is not present on the disk. Possible Causes and/or Solutions: l. The system could not find the file indicated command.. (C). COPYRIGHT. 1981. Micro. Data Base Systems,. Inc.. in. the. READ. 25.

(31) MDBS. IDBIL. MANUAL. ***Insufficient. room. VIII.. IDI.IL. blESSAGES. ERROR. FIDBS. -. MANUAL. IDML. in memory.. Explanation:. is not enough rcjom in memory to carry out any further processing by ID2'1L. Possible Causes and/or Solutions: not enough room in memory to open the data base. l.2. Theretheis data base has been already o?ened, there is the given corürüand. memory to process insufficient 3. See the appropriate system specific manual. There. If. ***Invalid area. Explanation: Self-explanatory. Possible Causes and/or Solutions: area name specified DDLin an IDML command is not l. The specification. area, as deEined in the using the DISP A command. 2. Check of valid areas list ***Invalid. a. valid. DISPLAY parameter.. Explanation:. The parameter specified is not a valid DISPLAY parameter. Possible Causes and/or Solutions: The parameter specified is not one of a, i, l, r, s.. ***Invalid item. nawe.. Explanation: The specified data item name does not exist for the record that processed. be is to possible Causes and/or Solutions: item name is misspelled or ty?ed as record.item (which is l. The invalid in IDBÍL). 2. Check the command syntax For the proper sequence of arguments. ***Invalid. number.. Explanation: The indicated field contains an invalid number. Possible Causes and/or Solutions: l. An invalid character has been specified. field.. 2. Check numeric. specifications. within. a. numeric. in query cowmand.. ***Missing area. Explanation:. is missing. and/or Solutions: An area was expected in the command and no area had been specified in any. ex?ected Possible Causes Añ. l.. 26. Rev.. 85A. area. name. (C). COPYRIGHT. 1981. string. earlier. It. IDL·1L. was missing command.. flicro Oata Ease Systems,. Inc..

(32) MDBS. IDML. MANUAL. VIII.. -. IDML. ERROR. MESSAGES. MDBS. -. MANUAL. IDML. **"Missing item. Explanation:. expected data item name is missing. Possible Causes and/or Soluticms: 1. a data item was expected in the command missinq and no item name had been specified An. TDML. string.. command.. in any. It. was. earlier. **"Missing number. Explanation: Self-explanatory.. PQssible 1.. Causes anci/or. A number was and no number. "**Mssing. ScÁutions: expected in the command string. had been specified in any earlier. missing ItIDMLwas command.. reeord.. Explanation: An. É'Qss:. expectea record type name is missing. üüe Causes and/or Soluticins: 1. A record in the command string. type was expected missing and no record type name had been specified earlier IDML command.. Itin. was any. ***Missing set. Explanation:. expected set name is missing. Causes and/cm Solutions: Possible 1. A set was missing was expected in the command string. had no set name been specified in any earlier It IDML command. An. ***Syntax error-command. and. expected.. Explanation:. The system was expecting a command name and encountered alphanumeric character within the command name. Possible Causes and/or Scjutions: 1. A character wizhin name was not alphanumeric. the command ***Unmatched. a. non-. quotes.. Zxplanaticm:. SelF-explanatory. ?osstble Causes and/or S<jiutions: 1. Qucjtes have been improperly specified or imprc'perly {C). COPYRIGHT. 1981. Micro. Data Base Systems,. Inc.. matched. 27.

(33) MDBS. IDML. MANUAL. -. T5is. 28. vi: r.. gage. {C}. T2.Y1-. T?.!?.CR. MESSAGES. íntentLonally. COPYRIGHT. 198'. KDBS. -. ID9L. MANUAL. left blank.. :. 'icro. Data 3ase Systems,. Inc..

(34) Appendix A. DML Command Break-down. (C). COPYRIGHT. 1981. Mj.cro Data. Base. Systems,. by Function. Inc..

(35) FAJBS. IDML. MDBS. MANUAL. Appendix. MANUAL. IDML. A. page. reference in MDBS DMS M'inti'í. ASSIGNMENT SCD SCM SCN SCO SCU SDC SMC SME SMM SMN SMO SMU SOC SOE SOM SON SOO SOU SUC SUM SUN SUO SUU. BOOLEAN. COMMANDS. run unit to Qata base key). . . run unit based on Wember) . . . run unit to j9Ul) . . . . . . . run unit based on Qwner). . . . (Get Gurrent run unit based on Aser indicator) (Save Qata base key for Current of run unit). . (Set l4elnber based on Gurrent of run unit) . . . (Set E!ember to current of run unit (Exception)) (áet µember based on fjember). . . . . . . . . . (áet Gember to Mull). . . . . . . . . . . . . . (Set Wember based on Qwner) . . . . . . . . . . (Get Fiember based on 9ser indicator). . . . . . (Get Qwner based on Current of run unit). . . . (Set Qwner to current of run unit (Zxception)). (&et Qwner based on 2ember) . . . . . . . . . . (Set Qwner to Null) . . . . . . . . . . . . . . (Set Qwner based on Qwner). . . . . . . . . . . (Set Qwner based on Aser indicator) . . . . . . (Set 9ser indicator to >rrent of run unit) . . (Set LLser indicator to Member). . . . . . . . . (áet Bser indicator to MUÍ). . . . . . . . . . (Set User indicator to Qwner) . . . . . . . . . (Set Aser indicator to Bser indicator). . . . .. (áet Current (Set Current (Set Current (Set Current. (ánd of 2embers with 4embers) (ánd of LLembers with Qwners). (ánd of Qwners with [jembers). (And of Qwners with Qwners) . (eXchide Pembers from 2embers). (eXclude 2embers from Qwners) (eXáude Qwners from Members) (eXclude Qwners from Qwners).. (Insert Member into Set). (Lnsert Qwner into Set). lOS. .. . .. .. .. .. .. .. . . . . . . . .. . .. . . . . . . .. .. .. . .. .. . . . .. .. .. .. . . . . .. . . . .. . . . .. .. .. . . . .. . . .. . . . . . . . .. . . . . . . . . . . .. 41 41 42 43 43 44 44 45. 46" 46 47 47 48 49 49 50 50 51 52. . . .. .. .. . . .. . . . .. . . . .. . . . . . . . .. .. . . .. .. . .. . . . .. . . . .. . .. .. . . . . . . . .. .. .. . . .. . .. .. . .. . . .. . . . . . . .. . . . . . . . .. . . . . . . .. . . . . . . . .. . .. . .. . .. . .. . .. . .. . .. . .. .. . .. . . . . . . . .. .. .. 82 83 83 84 85 86 87 88. . .. . .. . .. . .. . .. . .. .. .. .. .. . .. .. .. .. in Area) . átore). . .. . .. . .. . .. . .. . .. . .. . .. . .. . .. 57 58. COMMANDS. CRA CRS. (C). 40.1 40.1 40.2 40.2. . . . . . .. . . .. COMMANDS. IMS. CREATION. of of of of of. COMMANDS. AMM AMO AOM AOO XMM XMO XOM XOO. CONNECT. 1. COPYRIGHT. (Create (Create. 1981. Record Zecord. and. Micro. Data. Base Systems,. Inc.. Rev.. .. 85A. 54 55. A-l.

(36) FQDBS. IDML. MANUAL. IQDBS. IDML. MANUAL. page. reference in !qDBs DMS M1'Ín!11A. DELETION. (Qelete (Delete. DRC DRM DRO. (Delete. DISCONNECT. (Éemove. (Eemve (Eemove. that is Current) that is lgember). that is Qwner) .. . .. . .. .. . . .. .. .. . . .. .. .. .. . . .. . . .. .. . . . .. . . . .. . .. . . .. .. .. .. . . .. .. .. . . .. . . . .. .. . . .. . . . .. . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . .. .. .. .. . . . . .. . .. .. .. .. . .. . .. . . .. . . .. . . . .. . . . .. . .. .. e. . .. .. .. 63 64 65. gember froin 8et). Qwner from Get) . Gembers). all Set Set Qwners) . all. . . . .. . .. . .. . . . .. . .. .. . .. 59 60 60 61. COMMANDS. FDRK FFM FFO FFS. (Eind (Eiñd. elm. (Eind (EiMí (Eind (Eind. Eirst. Wember). .. .. .. .. calc Key). on .. .. #. fmi. FMSK FNM FNMI FNMSK FNO FNOI. (EiM (Eind (Eind (Eind. (EiM (EiMi (EiMí (EiMí (Eind (Eind (EiMí. fnosk. ENS. FOl FOSK F'PM FPMI FPMSK FPO F'POI FPOSK FRK. MODIFY. Quplicate Record based. (EiM Eirst Qwner). . . . . . Eind Zirst Sequential record).. FLO. (EiM. (EiMl. (EiM (EiM (EiMi. . .. . .. .. .. . . . . . . .. . .. . *. .. .. L,ast Gember). . . . . . . . . . Qwner) . . . . . . . . . Last . Me1nber based on data ítem). . . l±ember based on áort 5e;j') . . . Next ±ember). . . . . . . . . O . based on data Ltem) . lgext lgember Next 2ember based on Sort *ey). . jgext Qwner) . . . . . . . . . . . Next Qwner based on data ítem). . jjext Qwner based on Sort Sey) . . Next .jequential record) . . . . . Qwner based on data LteIn) . . . . Qwner based on Sort Key). . . . . . . . . . . . . . . 2rior 2ember) 2rior Member based on data Lteln). based on Sort XéY) . 2rior Member 2rior Qwner). . . . . . . . . . . 2rior Qwner based on data Ltem) . 2rior Qwner based on Sort 5</). . Zecorá based on calc XQl) . . . .. .. . . . . . . . . . . . .. . . . .. .. .. . .. . . .. . . . . . . . . .. .. .. .. .. .. .. .. .. a. . . . . .. . .. . . . . . . . .. .. .. .. .. . .. .. .. . .. . . . . . . . . . . . . . . .. . . .. . . .. . . . . . . . . . . . . . . .. . .. .. .. .. .. .. . . .. . .. . . . . .. .. . .. .. .. . . . . . . . .. . . . . . . . .. . .. .. . .. .. . . . . . . . .. 12 13 14 14 15 15 16 17 18 19 19 20 21 22 23 24 25 26 26 27 28. 28.1 28.2 28.3. COMMANDS. PFC PFM PFO PUTC PUTM PUTO. A-2. Becord Becord Eecord. COMMANDS. (2emve. RMS ROS RSM RSO. FIND. 1. COMMANDS. Rev.. (Eüt data (ZNt data (2ut data (2!JT data (E!1T data (UT data. into into into into into into. 85A. (C). Eield of Gurrent cñi run EiUd of 2ember) . . Eidld of Qwner). . Gurrent of run unit) . .. F'ember). Qwner). COPYRIGHT. .. . .. . .. 1981. . .. . .. . .. Micro. unit).. .. .. .. .. .. .. . . .. .. . .. .. .. Data. . .. . . .. . .. .. . . . .. .. .. .. .. .. .. . . .. .. .. Base Systems,. 34 34 35 35 36 37. Inc..

(37) MDBS. IDML. MDBS. MANUAL. MANUAL. IDML. page. reference in MDBS DMS M(in]1qí1. RETRIEVAL GETC GETM GETO GFC GEM GFO ODRK OFM OFO OLM OLO OMI OMSK ONM ONMI ONMSK ONO ONOI ONOSK OOI OQSK OPM OPMI OPMSK OPO OPOI OPOSK ORK. UTILITY. COMMANDS. from Current of run unit) . . . from LLember). . . . . . . . . . from Qwner) . . . . . . . . . . (Get Zield from >rrent of run unit). . . (Get EiUd Erorn yeníber) . . . . . . . . . (Get 2ield from Qwner). . . . . . . . . . (Qbtain Quplicate Record based on calc ZéY) (Qbtain Eirst Member) . . . . . . . . . . (Qbtain Eirst Qwner). . . . . . . . . . . (Qbtain Last gember). . . . . . . . . . . (Qbtain Last Qwner) . . . . . . . . . . . (Qbtain µember based on data Ltem). . . . (Qbtain lZember based on 8ort ±éY) . . . . (Qbtain Eext Member). . . . . . . . . . . (Obtain ¿ext Gember based on data ítem) . (Qbtain Next L1ember based on Sort SéY). . (Qbtain Eext Qwner) . . . . . . . . . . . (Qbtain Next Qwner based on data LtemA . (Qbtain Eext Qwner based on Sort ±éY) . . (Qbtain Qwner based on data Ltem) . . . . (Qbtain Qwner based on Sort Uy). . . . . (Qbtain 2rior lAember) . . . . . . . . . . (Qbtain Erior 2ember based on data Ltem). (Qbtain 2rior gTember based on ¿ort ±E!y) . (Qbtain 2rior Qwner). . . . . . . . . . . (Qbtain 2rior"Qwner based on data Ltem) . (Qbtain 2rior Qwner based on Sort Key). . (Qbtain Eecord based on calc %ey) . . . . (GET (GET (GET. . . . . . .. . . . . .. . . .. .. .. . . . . . . . . . . . .. . .. . .. . . . . . . . . . . . . . . . . .. .. .. .. .. .. . .. . . .. .. . . . . . . . .. . .. . . . . . . . . . .. . . .. . . . . . . .. . . . . . . .. .. . .. .. .. . . . . . . .. . .. . . . . . . . .. . . . . .. .. .. .. .. .. 30 30 31 31 32 32. .. .. . .. .. 32.1 . 32.2 . 32.3 . 32.4 . 32.5 . 32.6 . 32.7 . 32.8 . 32.9 .32.10 .32.11 .32.12 .32.13 .32.14 .32.15 .32.16 .32.17 .32.18 .32.19 .32.20 .32.21 .32.22. .. .. .. .. . .. . . . .. . . . . . .. . . .. .. COMMANDS. AUI CCU DBCLS DBCLSA DBCNV DBENV DBOPNA DBSAVE DBSTAT GMC GOC GTC GTM GTO NCI TCN TCT. tmt TOT. (C). data data data. COPYRIGET. (Allocate User índicators). . . . . . (Check Qirrent of run unit against Rser indicator). (Qata (Qata (Qata (Qata (Qata (Qata (Qata (Get (Get (Get. E,ase. CLoGe) CLoSe. .. .. .. .. .. . .. .. .. . . .. . .. . .. Base for Area). Zase format CoNyersion) . . 8ase =irc)nment) . . . . . . Zase Q2eN Área) . . . . . . . 8ase SAVE). . . . . . . . . . aase STATistics). . . . . . . LLember Gount). . . . . . . . . Qwner Qount) . . . . . . . . . Type of Gurrent of run unit) . Fype of Member). . . . . . . . (get (Get Eype of Qwner) . . . . . . . . Qjull all Qurrency Lndicators). . . Gest Gurrent of run unit for NUA (Test Gurrent of run unit fype) . . (Fest jjember Eype). . . . . . . . . (fest Qwner Fype) . . . . . . . . . 1981. Micro. Data. Base Systems,. .. .. .. .. .. .. . . . .. .. .. . .. . .. . .. .. .. .. .. . .. .. . . . . .. .. . .. .. .. .. .. .. .. .. .. . . . . .. .. .. . . . . . .. .. . . . . . .. .. .. . . .. .. .. . . . . . . .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . .. .. .. .. . .. .. .. .. .. .. . .. .. .. .. . .. .. .. .. . .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . . . .. .. .. .. .. . . . .. . . . . .. Inc.. . . .. .. .. . .. .. Rev.. .. .. .. . . . . .. . . .. . .. BSA. 67 68 69 70 70. 70.1 . .. . . .. .. 72 73 74 75 75 76 76 77 77 78 78 78 79. A-3. ..

(38) MDBS. IDML. MDBS. MANUAL. Appendix. B. DML Commands. (C). copYRIgaT. 1981. Micro. Data. Base. Systems,. Inc.. IDML. MANUAL.

(39) MDBS. IDML. MANUAL. MDBS. Appendix. IDML. MANUAL. B. page. reference in MDBS DMS AMM AMO AOM AOO. AUI CCU CRA CRS DBCLS DBCLSA DBENV DBOPNA DBSAVE DBSTAT DRC DRM DRO FDRK FFM FFO FFS ELM FLO EMI. FMSK FNM FNMI FNMSK FNO FNOI FNOSK FNS. FOl FOSK FPM FPO FRK GETC GETM GETO GFC GFM GFO GMC GOC GTC GTM. gto. (C). ·. 82 (ánd of Zembers with Members). . . . . . . . . . . . . . . 83 (And of Members with Qwners) . . . . . . . . . . . . . . . (And of Qwners with Members) . . . . . . . . . . . . . .83-84 (ánd of Qwners with Qwners). . . . . . . . . . . . . . .84-85 (Allocate Eser Lndicators) . . . . . . . . . . . . . . .67-68 (Check >rrent of run unit against 9ser indicator) . . .68-69 (Greate Eecord in área). . . . . . . . . . . . . . . . .54-55 (Create Eecord and ¿tore). . . . . . . . . . . . . . . .55-56 (Qata 8ase CLoSe). . . . . . . . . . . . . . . . . . . . . 69 70 (Qata Base CLoáe for área) . . . . . . . . . . . . . . . . (Qata aase =iron1nent). .70-71 . . . . . . . . . . . . . . . (Qata Zase QEeN Area). . . . . . . . . . . . . . . . . .72-73 (Qata 2ase"SAYE) . . . . . . . . . . . . . . . . . . . .73-74 (Qata Ease STATistics) . . . . . . . . . . . . . . . . . . 74 (Qelete Eecord that is Current). . . . . . . . . . . . .63-64" (Qelete Zecord that is Gember) . . . . . . . . . . . . . . 64 65 (Relete Zecord that is Qwner). . . . . . . . . . . . . . . (EÁxid on Zecord based Key). .12-13 Quplicate calc . . . . . . 13 (Ehid Eirst Member). . . . . . . . . . . . . . . . . . . . (Eind Zirst Qwner) . . . . . . . . . . . . . . . . . . . . 14 (Ehid Eirst Gequential record) . . . . . . . . . . . . .14-15 (EiM Last gjember) . . . . . . . . . . . . . . . . . . . . 15 (EiM Last Qwner). . . . . . . . . . . . . . . . . . . .15-16 (Eind Member based on data Lteni) . . . . . . . . . . . .16-17 (Eind !nember based on 'íort Xey). . . . . . . . . . . . .17-18 (EiMl Next Member) . . . . . . . . . . . . . . . . . . . . 18 (Zhid gjext µember based on data ítem). . . . . . . . . . . 19 (Eind fjext Zember based on áort Xey . . . . . . . . . . 19-20 (Eind Next Qwner). . . . . . . . . . . . . . . . . . . .20-21 (Eind fjext Qwner based on data Ltem) . . . . . . . . . .21-22 (Eind Next Qwner based on áort Key . . . . . . . . . . .22-23 (Einá jgext &equential record-). . . . . . . . . . . . . .23-24 (EiM Qwner based on data ítem). . . . . . . . . . . . . . 24 (EiM Qwner based on Sort Key) . . . . . . . . . . . . . . 25 (EiM 2rior i±ember). . . . . . . . . . . . . . . . . . . . 26 (EiM 2rior Qwner) . . . . . . . . . . . . . . . . . . .26-27 (Eind Zecord based on calc *ey). . . . . . . . . . . . .27-28 data from Ciirrent of run unit). . . . . . . . . . . . 30 (GEE data from Member) . . . . . . . . . . . . . . . . . . 30 (GET 31 data from Qwner). . . . . . . . . . . . . . . . . . . (Get Eield from Cjirrent of run unit) . . . . . . . . . . . 31 Get EiUd Eroni Gember). . . . . . . . . . . . . . . . . . 32 (Get Eield from Qwner) . . . . . . . . . . . . . . . . . . 32 (Get jjember Gount) . . . . . . . . . . . . . . . . . . . . 75 (Get Qwner Count). . . . . . . . . . . . . . . . . . . . . 75 (Get Fype of Current of run unit). . . . . . . . . . . . . 76 (Get Fype of l9ember) . . . . . . . . . . . . . . . . . . . 76 77 (Get ;jype of Qwner). . . . . . . . . . . . . . . . . . . .. «=. COPYRIGHT. 1981. Micro. Data. Base Systems,. Inc.. B-l.

(40) FñjBs. IDML. MANUAL. MDBS. MANUAL. IDML. page. reference in MDBS DMS MrmáL—. ,. IMS. lOS NCI PFC PFM PFO PUTC PUTM PUTO RMS ROS RSM RSO SCI) SCM SCN SCO SCU SDC SMC SME SMM SMN. sm. SMU SOC SOE SOM SON SOO SOU SOC SUM. sun SUO SOU TCT TMT TOT XMM XMO XOM XOO. B-2. (Lnsert jjember into Get) . . . . . . . . . . (Lnsert Qwner into Set). . . . . . . . . (Null all Currency Lndicators) . . . . . . . (2ut data into Eield Current of run unit) (2ut data into EiUd of ±ember). . . . . . . (Eut data into Eiela of Qwner) . . . . . . . (29T data into Current of run unit). . . . . data into Wember) . . . . . . . . . . . (E9T data into Qwner). . . . . . . . . . . . e. .. O: E. (=. . e. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . .. from Set) . . . . . . . . . . (Zemove Qwner from aet). . . . . . . . . . . (Zemove all Set Members) . . . . . . . . . . (Eemove all Set Qwners). . . . . . . . . . . (áet Current of run unit to Qata base key) . (Set Current of run unit based on ±ember). . O (Get Current of run unit to Eñíll). . . . . . . (Get Current of run unit based on Qwner) . . . (Gíet Cjirrent of run unit based on ttser indicator). (SÁ'jé Qata base key for Current of run unit) . . (áet 2ember based on Current of run unit). . . . (Set ly!ember to current of run unit (Exception)). (Set g1ember based on Member) . . . . . . . . . . (Set Xe%er to 2uUj . . . . . . . . . . . . . . (Get Member based on Qwnet). . . . . . . . . . . (Get !AeInber based on User indicator) . . . . . . (Set Qwner based on Qurrent of run unit) . . . . (&et Qwner to current of run unit (Exception)) . (&et Qwner based on l!!ember). . . . . . . . . . . (&et Qwner to Mull). . . . . . . . . . . . . . . (&et Qwner based on Qwner) . . . . . . . . . . . (Set Qwner based-on Aser indicator). . . . . . . (Set Oser indicator to >rrent of run unit). . . (Set Aser indicator to 2e%er) . . . . . . . . . (Get gser indicator to EMll) . . . . . . . . . . (Set Aser indicator to Qwner). . . . . . . . . . (Set Aser indicator to user indicator) . . . . . (Fest Cjirrent of run unit Eype). . . . . . . . . (Fest Zelnber fype) . . . . . . . . . . . . . . . (Fest Qwner tIYpeA . . . . . . . . . . . . . . . (eFc4ide Members from MeTnbers) . . . . . . . . . (eXclude ¥embers front Qwners). . . . . . . . . . (eXclude Qwners from |!!embers). . . . . . . . . . (eXáUe Qwners from Qwners) . . . . . . . . . . (Remove. Member. (C). COPYRIGHT. 1981. Micro. Data. . . . . . . . . . . . . . . . .. .. . . . .. . . . . . . . . . . . . . .. O. e. .. O. .. . . .. .. .. . . . .. . .. .. . . . . . . . . . . . . . . . .. . .. G O. . . . . . . .. .57-58 . . .. . . .. .. .. . .. . . . .. 58 77 34. .34-35 35. .35-36. .. .. 36 37 59 60. .60-61 . .. .. 61. 40.1. .40.1-40.2. .. . . . . . . . G. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .. 40.2 40s2 .. 41. 40.1 .42-43 .. .. .. .. 43. .43-44 44. .44-45 . .. . .. .. .. .. . .. 45 46. .46-47 47. .47-48 e. 48 49. .49-50 .. .. .. . . . .. . . . . .. . . .. . . .. 50. .50-51 51 52. 78 78 79. .85-86. Base Systems,. 86 87 88. Inc..

(41) MDBS. IDML. MDBS. MANUAL. Appendix. C. DML Command String Forms. (C). COPYRIGHT. 1981. Micro. Data. Base. Systems,. Inc.. IDML. MANUAL.

(42) MDBS. IDML. MDBS. MANUAL. Appendix. C. lgflsh. lgmsg,data mau,data mcc,data mcf. aui,number ccu,number. cra,record,area,data crs,record,data. mcp. dbc1sa,area. mrtf,record mrtp,record msf,set. dbcnv,data dbenv,data. dbopna,area,data. msp,set. nci odrk,record,data ofm,set,data ofo,set,data olm,set,data olo,set,data omi,item,set,data omsk,set,data onm,set,data onmi,item,set,data onmsk,set,data ono,set,data onoi,item,set,data onosk,set,data ooi,item,set,áata oosk,set,data opm,set,data opmi,item,set,data opmsk,set,data opo,set,data opoi,item,set,data oposk,set,data ork,record,data pfc,item,data pfm,item,set,data pfo,item,set,data putc,data putm,set,data puto,set,data rins,set ros,set. dbsave. dbstat,data drc drm,set dro,set fdrk,record,data ffm,set. ffo,set. ffs,area flm,set. flo,set. fmi,item,set,data fmsk,set,data fnm,set fnmi,item,set,data fnmsk,set,data fno,set fnoi,item,set,data fnosk,set,data fns,area foi,item,set,data fosk,set,data fpm,set fpmi,item,set,data fpmsk,set,data fpo,set fpoi,item,set,data fposk,set,data frk,record,data getc,data getm,set,data geto,set,data gfc,item,data gfm,item,set,data gfo,item,set,áata gmc,set,data goc,set,data gtc,data gtm,set,data gto,set,data. COPYRIGHT. MANUAL. ims,set ios,set. amm,set,set,set amo,set,set,set aom,set,set,set aoo,set,set,set. (C). IDML. 1981. rsm,set. rso,set scd,data scm,set. scn,set sco,set. scu,number. sdc,data. smc,set. Micro. Data. Base Systems,. Inc.. Rev.. 85A. C-l.

(43) KDBS. IDML. MANUAL. MDBS. sme,set smm,set,set smn,set. tcn tct,record tmn,set tmt,record,set ton,set tot,record,set. smu,set,number. soc,set soe,set som,set,set son,set soo,set,set. tun,number. xmm,set,set,set xmo,set,set,set xom,set,set,set xoo,set,set,set. sou,set,number suc,number sum,set,number sun,number. Rev.. MANUAL. suo,set,number suu,number,number. smo,set,set. C-2. IDML. 85A. (C). COPYRIGHT. 1981. Micro. Data. Base Systems,. Inc..

(44) DOCUMENTATION. MDBS. COMMENT. FORM. Title:. Document. welcome aníi appreciate all comments and suqqestions help us to improve our manuals and products. Use this express your views concerning this manual.. We. Please. ¿q. that can form. tQ. this. form to FepQrt problems system or to etc. System problems shQulcj be repcmted to by phone or telex, or in a separate the letter addressed the Requests áttentíQñ of technical support division. for published materials should be addressed to the attention of the marketing divisimn. ñQt use. request materials, MDBS. Ec). Sender: (pQsLtLcln). (name). (teiepnQnej. (cQlnrjany) (address). (city, state, 'zip) COMMENTS:. Areas cjf ccmment are general presentation, format, orqanization, completeness, etc. accuracy, clarity, If a comment applies to a specific page or paqes, please cite the page number(s).. Continue. on. áááíticmal pages,. as. needed.. Thank. yQu. for your response..

(45)