RMS is one of two file systems supplied on RSX-11M/M-PLUS systems. RMS-11 stands for Record Management Services for the PDP-11. RMS-11 is a series of user-callable subroutines which implement sequential, relative, and indexed file organizations. RMS-11 is accessible from MACRO-11, BASIC-PLUS-2, COBOL-11, and other DIGITAL languages. Other HELP information available includes switch and command summaries for RMS utilities and for RMS error message numbers. Type one of the following commands to access other RMS utility information: HELP RMS ERRORS to obtain RMS error code explanations HELP xxx to obtain information on the RMS utilities BCK - file backup CNV - convert DEF - interactive file define DSP - file attribute display IFL - indexed file load RST - file restore HELP RMS TKB to obtain information on various methods of task building with RMS HELP RMS MACROS to obtain a list of RMS macros used by the MACRO-11 programmer. HELP FCS to obtain information on File Control Services, the alternate file system. 2 TKB Task Building With RMS Those of you unfortunate enough to require the use of RMS in your tasks have the following options in task building against the RMS I/O system. 1. No overlays This is the most efficient way to build RMS in terms of execution speed of your task, but also takes the most task space (approximately 20K words of the 32K words available in your task). This approach should be used unless you simply cannot afford the task space. Input to the task builder is as follows: xxx=xxx1,xxx2,xxx3,LB:[1,1]F4PRMS/LB,RMSLIB/LB / any options // where xxx is the task name and xxx1,xxx2,xxx3, etc. are your object modules. "any options" is options input to the task builder, such as MAXBUF, ASG, etc. (The RESSUP=DR:[1,1]FCSFSL/SV option is relevant to FCS, not RMS, and should NOT be included). 2. Disk resident overlays This is the most efficient method in terms of conserving task space (approximately 4.5K words used), but is very inefficient in terms of program execution speed, since it must go to disk every time it has to overlay something. It will also significantly increase the time required to perform a task build. This method is not recommended unless there is a significant problem in getting your code to fit into 32K words. You must create an "overlay descriptor file" that will be used as input to the task builder. The file must have an extension of .ODL, and contain the following: ! .ROOT MYPROG-LB:[1,1]F4PRMS/LB-RMSROT,RMSALL ! MYPROG: .FCTR xxx1-xxx2-xxx3 ! @LB:[1,1]RMS11M.ODL where xxx1, xxx2, xxx3, etc. are your object modules The input to the task builder is as follows: xxx=file/MP any options // xxx is the name of the task. "any options" is options input to the task builder, such as MAXBUF, ASG, etc. (The RESSUP=DR:[1,1]FCSFSL/SV option is relevant to FCS, not RMS, and should NOT be included). Notice that there is no slash before the "any options". 3. Memory resident overlays This approach is a compromise between the above two. It requires 8K words of task space, but performs all overlays simply as memory remapping, so it is only slightly less speed-efficient than no overlays. In order for tasks built under this approach to run, the RMS memory resident library must be installed into 11/44 memory. Input to the task builder is as follows: xxx=xxx1,xxx2,xxx3,LB:[1,1]F4PRMS/LB,RMSLIB/LB:R0AUTO,RMSLIB/LB / LIBR=RMSRES:RO any options // where xxx is the task name and xxx1,xxx2,xxx3, etc. are your object modules. "any options" is options input to the task builder, such as MAXBUF, ASG, etc. (The RESSUP=DR:[1,1]FCSFSL/SV option is relevant to FCS, not RMS, and should NOT be included). 2 MACROS Following are the user macros defined in the RMSMAC.MLB Macro library. CCML$ BLK FABDF$ FABOF$ OFFSET FABOF$ OFFSET FAB$B FAB$BT DEF FAB$BT DEF FAB$E F$ALQ SIZE F$BKS SIZE F$BLS SIZE F$BPA LABEL F$BPS SIZE F$BSZ SIZE F$CTX VALUE F$DEQ SIZE F$DNA LABEL F$DNS SIZE F$FAC OPTIONS F$FNA LABEL F$FNS SIZE F$FOP OPTIONS F$FSZ SIZE F$JFN NUMBER F$JNL LABEL F$LCH VALUE F$MRN NUMBER F$MRS SIZE F$NAM LABEL F$ORG VALUE F$RAT OPTIONS F$RFM VALUE F$RTV NUMBER F$SHR OPTIONS F$XAB LABEL GCMLB$ MAXD,PRMPT,UBUF,LUN,PDL,SIZE,?PDL1,?BUF GCMLD$ GBL GCMLD$ X GCML$ NAME,ADPR,LNPR,UBUF,SIZE GCML$D GBL GCML$D X NAMDF$ NAMOF$ OFFSET NAMOF$ OFFSET NAM$B NAM$E N$ESA LABEL N$ESS VALUE N$RLF LABEL N$RSA LABEL N$RSS VALUE ORG$ ORGTYP,OPTYPS POOL$B POOL$E P$BDB VALUE P$BUF VALUE P$FAB VALUE P$IDX VAL1 P$RAB VALUE P$RABX VAL1,VAL2,VAL3 RABDF$ P1 RABOF$ OFFSET RABOF$ OFFSET RAB$B P1 RAB$BT DEF RAB$BT DEF RAB$E RCML$ NAME R$BKT NUMBER R$CTX VALUE R$FAB LABEL R$KBF LABEL R$KRF VALUE R$KSZ SIZE R$LSN NUMBER R$MBC NUMBER R$MBF NUMBER R$RAC VALUE R$RBF LABEL R$RHB LABEL R$ROP OPTIONS R$RSZ NUMBER R$UBF LABEL R$USZ NUMBER XABDF$ XABOF$ OFFSET XABOF$ OFFSET XAB$B TYPE XAB$BT DEF XAB$BT DEF XAB$E XBAOF$ OFFSET XBDOF$ OFFSET XBKOF$ OFFSET XBPOF$ OFFSET XBSOF$ OFFSET X$AID VALUE X$ALN VALUE X$ALQ SIZE X$AOP VALUE X$BKZ VALUE X$DAN VALUE X$DEQ SIZE X$DFL VALUE X$DTP VALUE X$FLG P1 X$HAL OFFSET X$IAN VALUE X$IFL VALUE X$KNM LABEL X$LAN VALUE X$LOC VAL1 X$NUL VALUE X$NXT LABEL X$POS OFFSET X$PRG VALUE X$PRJ VALUE X$PRO VALUE X$REF NUMBER X$SIZ SIZE X$VOL VALUE $BUFFER VALUE $CLOSE FAB,ERR $COMPARE INPUT,FIELD,PTR $CONNECT RAB,ERROR,SUC $CREATE FAB,ERROR $DELETE RAB,ERROR,SUC $DISCONNECT RAB,ERROR,SUC $DISPLAY FAB,ERR $ERASE FAB,ERROR $EXTEND FAB,ERROR $FBCAL $FETCH DEST,FIELD,PTR $FIND RAB,ERROR,SUC $FLUSH RAB,ERROR,SUC $FREE RAB,ERROR,SUC $GET RAB,ERROR,SUC $GNCAL $INIT $INITIF $LOAD DEST,FIELD,PTR $LOCALS $NXTVOL RAB,ERR,SUC $OFF VALUE,FIELD,PTR $OPEN FAB,ERROR $PUT RAB,ERROR,SUC $RBCAL $READ RAB,ERR,SUC $RELEASE RAB,ERROR,SUC $RETURN $REWIND RAB,ERROR,SUC $RMSDT $RMSTAT VALUE $SET VALUE,FIELD,PTR $SPACE RAB,ERR,SUC $STORE SOURCE,FIELD,PTR $TESTBITS VALUE,FIELD,PTR $TRUNCATE RAB,ERROR,SUC $UPDATE RAB,ERROR,SUC $WAIT RAB $WRITE RAB,ERR,SUC 2 ERRORS For a list of RMS error codes type HELP RMS ERRORS ALL For an individual error code, use the command: HELP RMS ERRORS xxx where xxx is the three-letter error name or the string equivalent to the negative decimal error value. For example: HELP RMS ERRORS ACC and HELP RMS ERRORS -32. access the same error text 3 ALL ER$ABO,177760,-16., ER$ACC,177740,-32., ER$ACT,177720,-48.,<"FILE" ACTIVITY PRECLUDES OPERATION> ER$AID,177700,-64., ER$ALN,177660,-80., ER$ALQ,177640,-96., ER$ANI,177620,-112., ER$AOP,177600,-128., ER$AST,177560,-144., ER$ATR,177540,-160., ER$ATW,177520,-176., ER$BKS,177500,-192., ER$BKZ,177460,-208., ER$BLN,177440,-224.,<"BLN" LENGTH ERROR(RAB/FAB)> ER$BOF,177430,-232., ER$BPA,177420,-240., ER$BPS,177400,-256., ER$BUG,177360,-272., ER$CCR,177340,-288., ER$CHG,177320,-304.,<$UPDATE-KEY CHANGE WITHOUT HAVING ATTRIBUTE XB$CHG SET> ER$CHK,177300,-320., ER$CLS,177260,-336., ER$COD,177240,-352., ER$CRE,177220,-368., ER$CUR,177200,-384., ER$DAC,177160,-400., ER$DAN,177140,-416., ER$DEL,177120,-432., ER$DEV,177100,-448., ER$DIR,177060,-464., ER$DME,177040,-480., ER$DNF,177020,-496., ER$DNR,177000,-512., ER$DPE,176770,-520., ER$DTP,176760,-528.,<"DTP" FIELD INVALID(STV=@XAB)> ER$DUP,176740,-544., ER$ENT,176720,-560., ER$ENV,176700,-576., ER$EOF,176660,-592., ER$ESS,176640,-608., ER$EXP,176630,-616., ER$EXT,176620,-624., ER$FAB,176600,-640., ER$FAC,176560,-656., ER$FEX,176540,-672., ER$FID,177530,-680., ER$FLG,176520,-688., ER$FLK,176500,-704., ER$FND,176460,-720., ER$FNF,176440,-736., ER$FNM,176420,-752., ER$FOP,176400,-768., ER$FUL,176360,-784., ER$IAN,176340,-800., ER$IDX,176320,-816., ER$IFI,176300,-832., ER$IMX,176260,-848., ER$INI,176240,-864.,<$INIT MACRO NEVER ISSUED> ER$IOP,176220,-880., ER$IRC,176200,-896., ER$ISI,176160,-912., ER$KBF,176140,-928., ER$KEY,176120,-944., ER$KRF,176100,-960., ER$KSZ,176060,-976., ER$LAN,176040,-992., ER$LBL,176020,-1008., ER$LBY,176000,-1024., ER$LCH,175760,-1040., ER$LEX,175750,-1048., ER$MAP,175720,-1072., ER$MKD,175700,-1088., ER$MRN,175660,-1104.,MRN> ER$MRS,175640,-1120., ER$NAM,175620,-1136.,<"NAM" BLOCK ADDRESS INVALID(NAM=0, OR NOT ACCESSIBLE)> ER$NEF,175600,-1152., ER$NID,175560,-1168., ER$NPK,175540,-1184., ER$OPN,175520,-1200., ER$ORD,175500,-1216., ER$ORG,175460,-1232., ER$PLG,175440,-1248., ER$POS,175420,-1264.,<"POS" FIELD INVALID(POS>MRS,STV=@XAB)> ER$PRM,175400,-1280., ER$PRV,175360,-1296., ER$RAB,175340,-1312., ER$RAC,175320,-1328., ER$RAT,175300,-1344., ER$RBF,175260,-1360., ER$RER,175240,-1376., ER$REX,175220,-1392., ER$RFA,175200,-1408., ER$RFM,175160,-1424., ER$RLK,175140,-1440., ER$RMV,175120,-1456., ER$RNF,175100,-1472., ER$RNL,175060,-1488., ER$ROP,175040,-1504., ER$RPL,175020,-1520., ER$RRV,175000,-1536., ER$RSA,174760,-1552., ER$RSZ,174740,-1568.,MRS, OR NOT=MRS IF FIXED LEN RECS> ER$RTB,174720,-1584., ER$SEQ,174700,-1600., ER$SHR,174660,-1616.,<"SHR" FIELD INVALID FOR FILE(CAN'T SHARE SEQ FILES)> ER$SIZ,174640,-1632.,<"SIZ" FIELD INVALID(STV=@XAB)> ER$STK,174620,-1648., ER$SYS,174600,-1664., ER$TRE,174560,-1680., ER$TYP,174540,-1696., ER$UBF,174520,-1712., ER$USZ,174500,-1728., ER$VER,174460,-1744., ER$VOL,174440,-1760., ER$WER,174420,-1776., ER$WLK,174410,-1784., ER$WPL,174400,-1792., ER$XAB,174360,-1808., 3 -16. #ABO 3 ABO ER$ABO,177760,-16., 3 -32. #ACC 3 ACC ER$ACC,177740,-32., 3 -48. #ACT 3 ACT ER$ACT,177720,-48.,<"FILE" ACTIVITY PRECLUDES OPERATION> 3 -64. #AID 3 AID ER$AID,177700,-64., 3 -80. #ALN 3 ALN ER$ALN,177660,-80., 3 -96. #ALQ 3 ALQ ER$ALQ,177640,-96., 3 -112. #ANI 3 ANI ER$ANI,177620,-112., 3 -128. #AOP 3 AOP ER$AOP,177600,-128., 3 -144. #AST 3 AST ER$AST,177560,-144., 3 -160. #ATR 3 ATR ER$ATR,177540,-160., 3 -176. #ATW 3 ATW ER$ATW,177520,-176., 3 -192. #BKS 3 BKS ER$BKS,177500,-192., 3 -208. #BKZ 3 BKZ ER$BKZ,177460,-208., 3 -224. #BLN 3 BLN ER$BLN,177440,-224.,<"BLN" LENGTH ERROR(RAB/FAB)> 3 -232. #BOF 3 BOF ER$BOF,177430,-232., 3 -240. #BPA 3 BPA ER$BPA,177420,-240., 3 -256. #BPS 3 BPS ER$BPS,177400,-256., 3 -272. #BUG 3 BUG ER$BUG,177360,-272., 3 -288. #CCR 3 CCR ER$CCR,177340,-288., 3 -304. #CHG 3 CHG ER$CHG,177320,-304.,<$UPDATE-KEY CHANGE WITHOUT HAVING ATTRIBUTE XB$CHG SET> 3 -320. #CHK 3 CHK ER$CHK,177300,-320., 3 -336. #CLS 3 CLS ER$CLS,177260,-336., 3 -352. #COD 3 COD ER$COD,177240,-352., 3 -368. #CRE 3 CRE ER$CRE,177220,-368., 3 -384. #CUR 3 CUR ER$CUR,177200,-384., 3 -400. #DAC 3 DAC ER$DAC,177160,-400., 3 -416. #DAN 3 DAN ER$DAN,177140,-416., 3 -432. #DEL 3 DEL ER$DEL,177120,-432., 3 -448. #DEV 3 DEV ER$DEV,177100,-448., 3 -464. #DIR 3 DIR ER$DIR,177060,-464., 3 -480. #DME 3 DME ER$DME,177040,-480., 3 -496. #DNF 3 DNF ER$DNF,177020,-496., 3 -512. #DNR 3 DNR ER$DNR,177000,-512., 3 -520. #DPE 3 DPE ER$DPE,176770,-520., 3 -528. #DTP 3 DTP ER$DTP,176760,-528.,<"DTP" FIELD INVALID(STV=@XAB)> 3 -544. #DUP 3 DUP ER$DUP,176740,-544., 3 -560. #ENT 3 ENT ER$ENT,176720,-560., 3 -576. #ENV 3 ENV ER$ENV,176700,-576., 3 -592. #EOF 3 EOF ER$EOF,176660,-592., 3 -608. #ESS 3 ESS ER$ESS,176640,-608., 3 -616. #EXP 3 EXP ER$EXP,176630,-616., 3 -624. #EXT 3 EXT ER$EXT,176620,-624., 3 -640. #FAB 3 FAB ER$FAB,176600,-640., 3 -656. #FAC 3 FAC ER$FAC,176560,-656., 3 -672. #FEX 3 FEX ER$FEX,176540,-672., 3 -680. #FID 3 FID ER$FID,177530,-680., 3 -688. #FLG 3 FLG ER$FLG,176520,-688., 3 -704. #FLK 3 FLK ER$FLK,176500,-704., 3 -720. #FND 3 FND ER$FND,176460,-720., 3 -736. #FNF 3 FNF ER$FNF,176440,-736., 3 -752. #FNM 3 FNM ER$FNM,176420,-752., 3 -768. #FOP 3 FOP ER$FOP,176400,-768., 3 -784. #FUL 3 FUL ER$FUL,176360,-784., 3 -800. #IAN 3 IAN ER$IAN,176340,-800., 3 -816. #IDX 3 IDX ER$IDX,176320,-816., 3 -832. #IFI 3 IFI ER$IFI,176300,-832., 3 -848. #IMX 3 IMX ER$IMX,176260,-848., 3 -864. #INI 3 INI ER$INI,176240,-864.,<$INIT MACRO NEVER ISSUED> 3 -880. #IOP 3 IOP ER$IOP,176220,-880., 3 -896. #IRC 3 IRC ER$IRC,176200,-896., 3 -912. #ISI 3 ISI ER$ISI,176160,-912., 3 -928. #KBF 3 KBF ER$KBF,176140,-928., 3 -944. #KEY 3 KEY ER$KEY,176120,-944., 3 -960. #KRF 3 KRF ER$KRF,176100,-960., 3 -976. #KSZ 3 KSZ ER$KSZ,176060,-976., 3 -992. #LAN 3 LAN ER$LAN,176040,-992., 3 -1008. #LBL 3 LBL ER$LBL,176020,-1008., 3 -1024. #LBY 3 LBY ER$LBY,176000,-1024., 3 -1040. #LCH 3 LCH ER$LCH,175760,-1040., 3 -1048. #LEX 3 LEX ER$LEX,175750,-1048., 3 -1072. #MAP 3 MAP ER$MAP,175720,-1072., 3 -1088. #MKD 3 MKD ER$MKD,175700,-1088., 3 -1104. #MRN 3 MRN ER$MRN,175660,-1104.,MRN> 3 -1120. #MRS 3 MRS ER$MRS,175640,-1120., 3 -1136. #NAM 3 NAM ER$NAM,175620,-1136.,<"NAM" BLOCK ADDRESS INVALID(NAM=0, OR NOT ACCESSIBLE)> 3 -1152. #NEF 3 NEF ER$NEF,175600,-1152., 3 -1168. #NID 3 NID ER$NID,175560,-1168., 3 -1184. #NPK 3 NPK ER$NPK,175540,-1184., 3 -1200. #OPN 3 OPN ER$OPN,175520,-1200., 3 -1216. #ORD 3 ORD ER$ORD,175500,-1216., 3 -1232. #ORG 3 ORG ER$ORG,175460,-1232., 3 -1248. #PLG 3 PLG ER$PLG,175440,-1248., 3 -1264. #POS 3 POS ER$POS,175420,-1264.,<"POS" FIELD INVALID(POS>MRS,STV=@XAB)> 3 -1280. #PRM 3 PRM ER$PRM,175400,-1280., 3 -1296. #PRV 3 PRV ER$PRV,175360,-1296., 3 -1312. #RAB 3 RAB ER$RAB,175340,-1312., 3 -1328. #RAC 3 RAC ER$RAC,175320,-1328., 3 -1344. #RAT 3 RAT ER$RAT,175300,-1344., 3 -1360. #RBF 3 RBF ER$RBF,175260,-1360., 3 -1376. #RER 3 RER ER$RER,175240,-1376., 3 -1392. #REX 3 REX ER$REX,175220,-1392., 3 -1408. #RFA 3 RFA ER$RFA,175200,-1408., 3 -1424. #RFM 3 RFM ER$RFM,175160,-1424., 3 -1440. #RLK 3 RLK ER$RLK,175140,-1440., 3 -1456. #RMV 3 RMV ER$RMV,175120,-1456., 3 -1472. #RNF 3 RNF ER$RNF,175100,-1472., 3 -1488. #RNL 3 RNL ER$RNL,175060,-1488., 3 -1504. #ROP 3 ROP ER$ROP,175040,-1504., 3 -1520. #RPL 3 RPL ER$RPL,175020,-1520., 3 -1536. #RRV 3 RRV ER$RRV,175000,-1536., 3 -1552. #RSA 3 RSA ER$RSA,174760,-1552., 3 -1568. #RSZ 3 RSZ ER$RSZ,174740,-1568.,MRS, OR NOT=MRS IF FIXED LENGTH RECS> 3 -1584. #RTB 3 RTB ER$RTB,174720,-1584., 3 -1600. #SEQ 3 SEQ ER$SEQ,174700,-1600., 3 -1616. #SHR 3 SHR ER$SHR,174660,-1616.,<"SHR" FIELD INVALID FOR FILE(CAN'T SHARE SEQ FILES)> 3 -1632. #SIZ 3 SIZ ER$SIZ,174640,-1632.,<"SIZ" FIELD INVALID(STV=@XAB)> 3 -1648. #STK 3 STK ER$STK,174620,-1648., 3 -1664. #SYS 3 SYS ER$SYS,174600,-1664., 3 -1680. #TRE 3 TRE ER$TRE,174560,-1680., 3 -1696. #TYP 3 TYP ER$TYP,174540,-1696., 3 -1712. #UBF 3 UBF ER$UBF,174520,-1712., 3 -1728. #USZ 3 USZ ER$USZ,174500,-1728., 3 -1744. #VER 3 VER ER$VER,174460,-1744., 3 -1760. #VOL 3 VOL ER$VOL,174440,-1760., 3 -1776. #WER 3 WER ER$WER,174420,-1776., 3 -1784. #WLK 3 WLK ER$WLK,174410,-1784., 3 -1792. #WPL 3 WPL ER$WPL,174400,-1792., 3 -1808. #XAB 3 XAB ER$XAB,174360,-1808.,