How To Transfer Your Mainframe SAS (R) Dataset Into Your Lotus 123 (R) Spreadsheet or dbase III (R) Databaste; Det1ef Dewitz, idv GmbH Bonn

Transcription

1 How To Transfer Your Mainframe SAS (R) Dataset Into Your Lotus 123 (R) Spreadsheet or dbase III (R) Databaste; Det1ef Dewitz, idv GmbH Bonn With the dominance of IBM on PC's market, special software was created to skill the problems of management. In further times it became important to process mainframe data on PC's. Lotus Developement Corporation became leader selling their spreadsheet system 123. Ashton Tate became also leader selling database systems dbase II and dbase III. Now what happens if you want to process SAS datasets of your mainframe with PC software? Let's show three possible ways for transfering LOTUS 123 data: 1. Data Transfer Of A Report This way is the most simple to understand. First you create a report on the mainframe via a DATA step and write this report into a file. DATA extract; SET data; IF salary) 2000; FILE lotus; PUT name $20 sex $1. age 2.0 salary 8.2; Now download this lotus file to your PC by standard file transfer with ASCII translation. Example (on IBM 3270 PC's): receive lotus.wk1 a:'user.lotus.wk1' ascii crlf NOTE: You have to translate mainframe EBCDIC code into PC ASCII code while downloading. In the next step start your lotus 123 session, select the transfer option and load the downloaded data into your spreadsheet. Advantages: - simple to understand - easy control of filetransfer results Disadvantages: - You have to write a new DATA step for each SAS data set. Performing three conversions: SAS internal -) text (report) EBCDIC text EBCDIC -) text ASCII text ASCII -) Lotus internal 481

2 2. Using PC SAS - For this solution first start your SAS session on the PC and afterwards on the mainframe (with the SIGNON command). Download your data with PROC DOWNLOAD and convert it into a DIF format with PROC DIF. DATA extract; SET data; IF salary) 2000; PROC download DATA=extract OUT=work; (start this program with REMOTE SUBMIT) PROC dif DATA=work DIF=lotus LABELS; (start this program with SUBMIT) At next leave the PCSAS session and start Lotus 123. Now load your DIF file into your spreadsheet. Advantages: You need no mainframe experiences as you will get all mainframe data via the PC SAS session - Created DIF files contain information about data structures Disadvantages: - PC SAS in connection with the IBM Control Program 2.x/3.x raises memory overflow - PC SAS necessary - Performing two conversions: SAS internal -) DIF DIF -) Lotus internal 3. Using PROC WRITWKl Usage of PROC WRITWKl is the most efficient way of transfering mainframe SAS data to your PC Lotus spreadsheet. PROC WRITWKl creates a Lotus internal format on the mainframe. Additional EBCDIC -) ASCII translation is unnecessary because PROC WRITWKl realizes all translations. In the next step download the created file to your PC with standard file transfer in binary mode. The PC file needs the extension.wkl At least start your Lotus session and use the file itself! No other conversion is necessary! 482

3 The WRITWK1 Procedure PROC WRITWK1 offers the facilities of direct data transfer from a SAS dataset into a LOTUS-123 spreadsheet. Each spreadsheet contains the observations of the SAS dataset as a row and the variables as a column. The created spreadsheet files must be downloaded onto the personal computer in binary format. It is necessary to allocate an output file before executing this procedure (TSO: ALLOC command; BATCH: DD-statement). It is recommendable to use RECFM=VB and LRECL=256 for the output files. PROC WRITWK1 Statement PROC WRITWK1 options; The options below might appear in the PROC WRITWK1 statement. DATA=libref.member names the input SAS datset. If DATA= is omitted, the most recently created dataset is used. OUT=fileref specifies the fileref for the output LOTUS-123 file NULLS/NONULLS orders if zero-values are transfered. MISS/NOMISS orders if missing values are transfered. FORMAT/NOFORMAT orders if values are transfered with their SAS format representation. VARROW/NOVARROW orders if the first row of the spreadsheet receives information about the names of the SAS variables and their attributes. Syntax: [variable] [( [length] [format])]. Examples: VAR Statement VAR variables; NAME STREET ($20;) PRICE (8;COMMA10.2) (12;$12.) The VAR statement names the variables to be transfered (in this order). If no VAR statement is used, all variables in the dataset are transfered. LIBNAME in LIBNAME out 'user.sas.data' DISP=SHR; 'user.lotus.wk1' ; DATA temp; SET in. example; IF var1 = value; PROC WRITWK1 DATA=temp OUT=out NOFORMAT YARROW; VAR var1 var2 var3; LIBNAME _ALL_ CLEAR; 483

4 The READWK1 Procedure PROC READWK1 offers the facilities of direct data transfer from LOTUS-123 spreadsheets into SAS datasets. Every row of the spreadsheet becomes one observation, every column one variable of the new SAS dataset. The spreadsheet file must be uploaded onto the mainframe in binary format. PROC READWK1 Statement PROC READWK1 options; The options below might appear in the PROC READWK1 statement. WK1n =fil eref LOTUS=fileref IN=fileref specifies the fileref of a LOTUS 123 spreadsheet file. OUT=libref.member names the output SAS dataset. If OUT= is omitted, a dataset named DATAn will be created. RANGE=LOTUSrange specifies a named range of the spreadsheet to be transfered into the SAS dataset. If this option is specified, don't use FIRSTCOL=, LASTCOL=, FIRSTROW= and LASTROW= options. FIRSTCOL=n FCOL=n FC=n first column of the spreadsheet to be transfered. LASTCOL=n LCOL=n LC=n last column of the spreadsheet to be transfered. FIRSTROW=n FROW=n FR=n first row of the spreadsheet to be transfered. LASTROW=n LROW=n LR=n last row of the spreadsheet to be transfered. VARROW/NOVARROW orders if the first row of the spreadsheet containing the information about the names of the SAS variables and their attributes. Syntax: [variable] [( [length] ; [format] )]. Examples: NAME STREET ($20;) PRICE (;COMMA10.2) (12;$12.) LIBNAME in 'user.lotus.wk1' DISP=SHR; LIBNAME out 'user.sas.data'; PROC READWK1 IN=in OUT=out.example RANGE=test VARROW; PROC PRINT; LIBNAME _ALL_ CLEAR; 484

5 The WRITDBF Procedure PROC WRITDBF offers the facilities of direct data transfer from a SAS dataset into a dbase III database. The created database obtains the same structure as the SAS dataset. Indexfiles (.NDX) and textfiles (.DBT) are not supported. The created dbase III files must be downloaded onto the personal computer in binary format. It is necessary to allocate an output file before executing this procedure (TSO: ALLOC command; BATCH: DD-statement). It is recommendable to use RECFM=VB and LRECL=256 for the output files. PRoe WRITDBF statement PROC WRITDBF options; The options below might appear in the PROC WRITDBF statement. DATA=libref.member names the input SAS datset. If DATA= is omitted, the most recently created dataset is used. OUT=fileref DBF=fileref specifies the fileref for the output dbase III file. FORMAT/NOFORMAT orders if the values are transfered with their SAS format representation. VAR Statement VAR variables; The VAR statement names the variables to be transfered (in this order). If no VAR statement is used, all variables in the dataset are transfered. LIBNAME in 'user.sas.data' DISP=SHR; LIBNAME out 'user.dbase.dbf'; DATA temp; SET in.example; IF varl = value; PROC WRITDBF DATA=temp OUT=out NOFORMAT; VAR varl var2 var3; LIBNAME _ALL_ CLEAR; 485

6 The READDBF Procedure PROCREADDBF offers the facilities of direct data transfer from dbase III databases into a SAS datasets. All fields (except MEMO fields) are accepted by this procedure. The dbase III database must be uploaded onto the mainframe in binary format. PROC READDBF Statement PROC READDBF options; The options below might appear in the PROC READDBF statement. DBF=fileref DBASE=fileref IN=fileref specifies the fileref of a dbase III file as input. OUT=libref.member names the output SAS dataset. If OUT= is omitted, a dataset named DATAn will be created. DELETED/NOTDELETED orders if deleted records of the dbase file are transfered. LIBNAME in 'user.dbase.dbf' DISP=SHR: LIBNAME out 'user.sas.d.ata': PROC READDBF DBF=in OUT=out.example DELETED: PROC PRINT: LIBNAME _ALL_ CLEAR: 486

7 Conclusions:. There are a lot of possible ways to satisfy your necessities in transfering mainframe data to the PC. The new developed procedures PROC WRITWK1 PROC READWK1 PROC WRITDBF creating Lotus files, loading Lotus files, creating dbase III files and PROC READDBF loading dbase III files gives much more power and comfort to your data processing. Further informations can be obtained from the authors at: idv - Gesellschaft fur individuelle Datenverarbeitung mbh Weil3stral3e 41 D-5300 Bonn 1 SAS (R) is a registered trademark of SAS Institute Inc.; Lotus 123 is a registered trademark of Lotus Developement Corporation; dbase II and dbase III are registered trademarks of Ashton-Tate Inc.; 487