Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: RGUTOS1

RGUTOS1.m

Go to the documentation of this file. 
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