- RGUTOS ;CAIRO/DKM - Platform-dependent operations;12-Oct-1998 16:40;DKM
- ;;2.1;RUN TIME LIBRARY;;Mar 22, 1999
- ;=================================================================
- ; Return version # of RTL
- VER() Q +$P($T(RGUTOS+1),";",3)
- ; Set right margin
- RM(X) X ^%ZOSF("RM")
- Q
- ; Test for routine/tag
- TEST(X) N Z
- S:X[U Z=$P(X,U),X=$P(X,U,2)
- X ^%ZOSF("TEST")
- Q $S('$T:0,$G(Z)="":1,Z'?.1"%"1.AN:0,1:$T(@Z^@X)'="")
- ; Raise an exception
- RAISE(X) ZT $G(X)
- ; Return code to set error trap
- TRAP(X) Q $$SUBST^RGUT(^%ZOSF("TRAP"),"X",""""_X_"""")
- ; Check for $ET capability
- ETRAP() Q $$NEWERR^%ZTER
- ; Open a file (extrinsic)
- OPENX(X1,X2) ;
- D OPEN(.X1,.X2)
- Q X1
- ; Open a file
- OPEN(X1,X2) ;
- N IO,POP,X3
- D PARSE(.X1,.X3),OPEN^%ZISH(X3_X1,X3,X1,$G(X2,"R"),32767)
- I POP ZT "OPEN"
- S ^XTMP("RGHFS",$J,IO)=X3_X1,X1=IO
- Q
- ; Close a file
- CLOSE(X) N Y
- S Y=$G(^XTMP("RGHFS",$J,X)),IO=X
- K ^(X)
- D CLOSE^%ZISH(Y)
- Q
- ; Close all open HFS
- CLOSEALL N Z
- S Z=""
- F S Z=$O(^XTMP("RGHFS",$J,Z)) Q:Z="" D CLOSE(Z)
- Q
- ; Parse out directory from filename
- PARSE(X,Y) ;
- N D,Z
- S D=$E($$DIRDLM,3),Z=$L(X,D),Y=$P(X,D,1,Z-1)_$S(Z>1:D,1:""),X=$P(X,D,Z)
- Q
- ; Read a line
- READ(X,Y) ;
- N IO,%ZA,%ZB,%ZC,%ZL
- S IO=$G(Y,$I)
- D READNXT^%ZISH(.X)
- U IO
- Q $$STATUS^%ZISH&'$L(X)
- ; Delete a file
- DELETE(X) ;
- N Z
- D PARSE(.X,.Z)
- S Z(X)="",Z=$$DEL^%ZISH(Z,"Z")
- Q
- ; Rename a file
- RENAME(X1,X2) ;
- N X3,X4
- D PARSE(.X1,.X3),PARSE(.X2,.X4)
- I $$MV^%ZISH(X3,X1,X4,X2)
- Q
- ; List files
- DIR(X1,X2,X3) ;
- N Z
- D PARSE(.X1,.Z)
- S Z(X1)="",X3=$G(X3,"^UTILITY(""DIR"",$J)")
- K @X3
- I $$LIST^%ZISH(Z,"Z",X3)
- Q
- ; Force error if at EOF
- EOF I $$STATUS^%ZISH ZT "EOF"
- Q
- ; Returns true if current error is EOF
- EOFERR() Q $$EC^%ZOSV["EOF"
- ; URL format filename-->HFS format
- CVTFN(RGFIL,RGROOT) ;
- N RGZ,RGZ1,RGD
- S RGD=$$DIRDLM,RGROOT=$G(RGROOT)
- S:$E(RGROOT,$L(RGROOT))=$E(RGD,3) RGROOT=$E(RGROOT,1,$L(RGROOT)-1)
- S RGZ=$L(RGFIL,"/"),RGZ1=$P(RGFIL,"/",1,RGZ-1),RGFIL=$P(RGFIL,"/",RGZ)
- S:$L(RGZ1) RGROOT=RGROOT_$E(RGD,$S($L(RGROOT):2,1:1))_$TR(RGZ1,"/.-",$E(RGD,2))
- Q RGROOT_$S($L(RGROOT):$E(RGD,3),1:"")_RGFIL
- ; Return directory delimiters
- DIRDLM() N X
- S X=$$PWD^%ZISH
- Q $S(X["[":"[.]",X["\":"\\\",1:"///")
- ; FTP file transfer
- FTP(X1,X2,X3,X4,X5,X6,X7) ;
- D:$$VERSION^%ZOSV(1)["DSM" VMS^RGUTFTP(.X1,.X2,.X3,.X4,.X5,.X6,.X7)
- Q
- ; Parse error data
- ERR(X1,X2,X3) ;
- N X
- S X=$$EC^%ZOSV,X1=$$VERSION^%ZOSV(1)
- G ERRMSM:X1["MSM",ERRDSM:X1["DSM"
- S (X1,X2,X3)=""
- Q
- ERRMSM S X1=$E($P(X,">"),2,99),X2=$P($P(X,">",2),":"),X3=X1
- S:X2["*" X2=""
- S:$E(X1)="Z" X3=$E(X1,2,99),X1="ZTRAP"
- Q
- ERRDSM S X1=$P($P(X,", ",2),"-",3),X2=$P($P(X,", "),":"),X3=$$TRIM^RGUT($P(X,", ",$S(X1="ZTRAP":4,1:3)))
- Q
- --- Routine Detail --- with STRUCTURED ROUTINE LISTING ---[H[J[2J[HRGUTOS1 2773 printed Mar 13, 2025@21:42:30 Page 2
- RGUTOS ;CAIRO/DKM - Platform-dependent operations;12-Oct-1998 16:40;DKM
- +1 ;;2.1;RUN TIME LIBRARY;;Mar 22, 1999
- +2 ;=================================================================
- +3 ; Return version # of RTL
- VER() QUIT +$PIECE($TEXT(RGUTOS+1),";",3)
- +1 ; Set right margin
- RM(X) XECUTE ^%ZOSF("RM")
- +1 QUIT
- +2 ; Test for routine/tag
- TEST(X) NEW Z
- +1 if X[U
- SET Z=$PIECE(X,U)
- SET X=$PIECE(X,U,2)
- +2 XECUTE ^%ZOSF("TEST")
- +3 QUIT $SELECT('$TEST:0,$GET(Z)="":1,Z'?.1"%"1.AN:0,1:$TEXT(@Z^@X)'="")
- +4 ; Raise an exception
- RAISE(X)
- *** ERROR ***
- +1 ; Return code to set error trap
- TRAP(X) QUIT $$SUBST^RGUT(^%ZOSF("TRAP"),"X",""""_X_"""")
- +1 ; Check for $ET capability
- ETRAP() QUIT $$NEWERR^%ZTER
- +1 ; Open a file (extrinsic)
- OPENX(X1,X2) ;
- +1 DO OPEN(.X1,.X2)
- +2 QUIT X1
- +3 ; Open a file
- OPEN(X1,X2) ;
- +1 NEW IO,POP,X3
- +2 DO PARSE(.X1,.X3)
- DO OPEN^%ZISH(X3_X1,X3,X1,$GET(X2,"R"),32767)
- +3 IF POP