Computer Associates SRAM Sort Emulation

Size: px

Start display at page:

Download "Computer Associates SRAM Sort Emulation"

Julianna Boyd
5 years ago
Views:

1 Batch Mainframe applications in COBOL or PL/1 may use CA s SRAM sort on the mainframe. Mainframe Express does not support SRAM by default. SRAM sort is compatible to DFSORT (only the process of invocation is different). There may be some minor incompatabilities in the sort parameters. However, these can easily be mapped. It is possible to emulate CA s sort with MFSORT, Micro Focus substitute for DFSORT. SRAM-Sort is controlled by five Call statements in the application programs (COBOL or PL/1). Namely: CALL SRTOPEN (SRTTABL) To initiate a CA-SRAM sort, the workfile must be opened by issuing this call and specifying the parameter table to be used (SRTTABL). CALL SRTFILL (SRTTABL,SRTRCD) To pass a record to the sorting process, the parameter table and the name of an area which contains the record to be sorted must be specified CALL SRTGETR (SRTTABL,SRTRCD) When retrieving the sorted records, the parameter table and an area into which the sorted record will be placed must be specified CALL SRTCLSE (SRTTABL) At the completion of the sort process, the workfile should be closed CALL SRTROPN (SRTTABL) When reopening a previously closed workfile, the parameter table must be specified The following example COBOL program includes the entries SRTOPEN SRTFILL SRTGETR SRTCLSE which fullfills the four necessary functions used by SRAM sort. Those entry points, then, would have to be made available to Mainframe Express via Entry Point Mapping. SRTOPEN not only creates a workfile, but also creates a sidefile for the invocation of MFSORT with the necessary information in the correct format. SRTFILL writes record by record into the workfile created by SRTOPEN. SRTGETR initiates the sort process with MFSORT on the first retrieval call and subsequently returns sorted records one by one It also sets a flag in the SRTTABL to indicate end of file. SRTCLSE closes files and cleans temporary help files. The following example program is offered AS IS as an example only. It is likely that for your own implementation, you will need to modify that which is offered. You are welcome to do so. However, should you want to use this solution example and require assistance with making it work for you, that assistance will only be considered by Micro Focus under a consulting engagement. IDENTIFICATION DIVISION. PROGRAM-ID. ZKBSORT. AUTHOR. CD. DATE-WRITTEN. 21/02/02. *****************************************************************

2 * THIS PROGRAM EMULATES CA'S S-RAM SORT. * * IT PROVIDES THE FOLLOWING ENTRIES: * * - MODE24 DUMMY FOR SWITCHING TO MODE 24 * * - MODE31 DUMMY FOR SWITCHING TO MODE 31 * * - SRTOPEN FOR OPEN OF TEMPORARY SORT FILE AND * * CREATION OF SORT PARAMETER FILE FOR MFSORT * * - SRTFILL FOR FILLING TEMPORARY SORT FILE * * RECORD BY RECORD * * - SRTGETR FOR RETRIEVING RECORD BY RECORD FROM * * SORTED FILE * * - SRTCLSE FOR CLOSING TEMPORARY FILES AND DELETING * * THEM * * * * IT IS NECESSARY TO MAKE THOSE S KNOWN TO MAINFRAME * * EXPRESS * * MAX RECORD LENGTH FOR SORT RECORD IS 1000 (CAN BE CHANGED) * * MAX LENGTH FOR SORT FIELDS PARAMETERS IS 306 * * S-RAM DOCUMENTS MAXIMUM LENGTH 256, HOWEVER CAN BE * * CHANGED IN THIS PROGRAM * * * ***************************************************************** ENVIRONMENT DIVISION. CONFIGURATION SECTION. SPECIAL-NAMES. INPUT-OUTPUT SECTION. FILE-CONTROL. * TEMPORARY SORT FILE SELECT SORT-FILE ASSIGN TO DYNAMIC SORT-DATEI ORGANIZATION IS SEQUENTIAL. * TEMPORARY FILE WITH SORT PARAMETERS FOR MFSORT SELECT DFSORT-FILE ASSIGN TO DYNAMIC DFSORT-DATEI ORGANIZATION IS LINE SEQUENTIAL. DATA DIVISION. FILE SECTION. FD SORT-FILE RECORDING MODE IS V LABEL RECORDS ARE STANDARD. 01 SORT-SATZ. 05 OUT-LEN PIC S9(4) COMP. 05 OUT-DATA PIC X(1000). FD DFSORT-FILE LABEL RECORDS ARE STANDARD. 01 PIC X(80). WORKING-STORAGE SECTION. 01 KOMMANDO-ZEILE PIC X(80). 01 FIRST-KZ PIC X VALUE 'Y'. 01 PIC 9(8). 01 ENV PIC X(40). 01 SATZ-POINTER PIC 9(04) COMP-X. 01 KEY-STR KEY-STATIC-68 PIC X(1) OCCURS KEY-STR KEY-STATIC-80-1 PIC X(1) OCCURS KEY-STR KEY-STATIC-80-2 PIC X(1) OCCURS KEY-STR KEY-STATIC-80-3 PIC X(1) OCCURS IND PIC 9(4). 01 IND1 PIC 9(4). 01 FILE-STAT PIC XX. 01 SORT-DATEI PIC X(65). 01 DFSORT-DATEI PIC X(65). 01 RESULT PIC X COMP-X VALUE FUNCTION-35 PIC X COMP-X VALUE FUNCTION-35-PARM. 03 FILLER PIC X COMP-X VALUE FILLER PIC X(100) VALUE SPACES.

3 LINKAGE SECTION. 01 SORTTAB-SORT DDNAME PIC X(8). 02 CORE PIC X(4). 02 RECLNG PIC S9(4) COMP. 02 MODESR PIC X(2). 02 KEYDEF PIC X(1) OCCURS SORT-RECORD PIC X(1000). PROCEDURE DIVISION. * DUMMY MODULES WHICH SWITCH BETWEEN MODE 24 AND MODE 31 * ARE ONLY NEEDED AS AN, NO FUNCTION REQUIRED 'MODE24'. 'MODE31'. * END OF DUMMY MODULE SECTION * CREATE AND OPEN TEMPORARY SORT FILE AND CREATE FILE FOR SORT * PARAMETERS AS INPUT FOR MFSORT 'SRTOPEN' USING SORTTAB-SORT01. * PUTTING SORT PARAMETERS IN CORRECT LAYOUT FOR MFSORT MOVE SPACES TO KEY-STR-68 MOVE SPACES TO KEY-STR-80-1 MOVE SPACES TO KEY-STR-80-2 MOVE SPACES TO KEY-STR-80-3 MOVE 0 TO IND1 PERFORM WITH TEST AFTER VARYING IND FROM 1 BY 1 UNTIL IND > 500 OR KEYDEF(IND) = ')' IF KEYDEF(IND) <> ' ' IF IND1 < 69 IF KEYDEF(IND) = ',' AND IND1 > 60 MOVE KEYDEF(IND) TO KEY-STATIC-68(IND1) MOVE 68 TO IND1 MOVE 'C' TO KEY-STATIC-68(IND1) MOVE 'H' TO KEY-STATIC-68(IND1) MOVE KEYDEF(IND) TO KEY-STATIC-68(IND1) IF IND1 > 68 AND IND1 < 149 IF KEYDEF(IND) = ',' AND IND1 > 140 MOVE KEYDEF(IND) TO KEY-STATIC-80-1(IND1-68) MOVE 148 TO IND1 MOVE 'C' TO KEY-STATIC-80-1(IND1-68) MOVE 'H' TO KEY-STATIC-80-1(IND1-68) MOVE KEYDEF(IND) TO KEY-STATIC-80-1(IND1-68) IF IND1 > 148 AND IND1 < 229 IF KEYDEF(IND) = ',' AND IND1 > 220 MOVE KEYDEF(IND) TO KEY-STATIC-80-2(IND1-148)

4 MOVE 228 TO IND1 MOVE 'C' TO KEY-STATIC-80-2(IND1-148) MOVE 'H' TO KEY-STATIC-80-2(IND1-148) MOVE KEYDEF(IND) TO KEY-STATIC-80-2(IND1-148) IF IND1 > 228 IF KEYDEF(IND) = ',' AND IND1 > 300 MOVE KEYDEF(IND) TO KEY-STATIC-80-3(IND1-228) MOVE 308 TO IND1 MOVE 'C' TO KEY-STATIC-80-3(IND1-228) MOVE 'H' TO KEY-STATIC-80-3(IND1-228) MOVE KEYDEF(IND) TO KEY-STATIC-80-3(IND1-228) END-PERFORM. * GET UNIQUE FILENAMES FOR TEMPORARY FILES DISPLAY "MFDIR" UPON ENVIRONMENT-NAME ACCEPT FROM TIME ACCEPT ENV FROM ENVIRONMENT-VALUE MOVE SPACES TO DFSORT-DATEI STRING ENV DELIMITED BY ";" ".DFS" DFSORT-DATEI. * CREATE INPUT-FILE FOR MFSORT INVOCATION FROM COMMANDLINE * MFSORT TAKE HHMMSSSS.DFS OPEN OUTPUT DFSORT-FILE. MOVE "CHAR-EBCDIC" TO * WRITE SORT FIELDS STATEMENT, CAN BE UP TO 4 LINES STRING "SORT FIELDS" KEY-STR-68 DELIMITED BY SPACE IF KEY-STR-80-1 <> SPACES STRING KEY-STR-80-1 DELIMITED BY SPACE IF KEY-STR-80-2 <> SPACES STRING KEY-STR-80-2 DELIMITED BY SPACE IF KEY-STR-80-3 <> SPACES STRING KEY-STR-80-3 DELIMITED BY SPACE

5 * WRITE "USE" STATEMENT FOR THE FILE TO BE SORTED (INPUT) STRING "USE " ENV DELIMITED BY ";" ".SRT". * WRITE "GIVE" STATEMENT (OUTPUT) STRING "GIVE " ENV DELIMITED BY ";" ".SRT". CLOSE DFSORT-FILE * CREATE / OPEN TEMPORARY SORT FILE MOVE SPACES TO SORT-DATEI STRING ENV DELIMITED BY ";" ".SRT" SORT-DATEI. OPEN OUTPUT SORT-FILE. * END SRTOPEN * FILL THE TEMPORARY SORT FILE RECORD BY RECORD 'SRTFILL' USING SORTTAB-SORT01,SORT-RECORD. COMPUTE OUT-LEN = RECLNG + 2 MOVE SORT-RECORD TO OUT-DATA WRITE SORT-SATZ * END SRTFILL * READ TEMPORARY SORT FILE 'SRTGETR' USING SORTTAB-SORT01,SORT-RECORD. * BEFORE THE FIRST RECORD CAN BE RETRIEVED, THE FILE HAS TO BE * SORTED VIA MFSORT IF FIRST-KZ = 'Y' MOVE 'N' TO FIRST-KZ PERFORM DFSORT-ROUTINE OPEN INPUT SORT-FILE * NOW GET RECORD BY RECORD TILL END OF FILE READ SORT-FILE AT END MOVE '99' TO MODESR OF SORTTAB-SORT01 GO TO END-SORT END-READ MOVE OUT-DATA TO SORT-RECORD * END SRTGETR * CLOSE AND DELETE TEMPORARY SORT FILE AND FILE WITH SORT * PARAMETERS 'SRTCLSE' USING SORTTAB-SORT01. CLOSE SORT-FILE. CALL "CBL_DELETE_FILE" USING SORT-DATEI.

6 CALL "CBL_DELETE_FILE" USING DFSORT-DATEI. * END SRTCLSE * PROGRAMM END END-SORT. GOBACK. * INVOCATION OF SORT PROGRAM: MFSORT TAKE HHMMSSSS.DFS * VIA COMMAND LINE AND X'91' DFSORT-ROUTINE. CLOSE SORT-FILE. * START MFSORT WITH TAKE FILENAME STRING "MFSORT TAKE " DFSORT-DATEI DELIMITED BY SPACE KOMMANDO-ZEILE DISPLAY KOMMANDO-ZEILE UPON COMMAND-LINE. CALL X'91' USING RESULT FUNCTION-35 FUNCTION-35-PARM. END-DFSORT-ROUTINE.

TABLE 1 HANDLING. Chapter SYS-ED/ COMPUTER EDUCATION TECHNIQUES, INC.

TABLE 1 HANDLING. Chapter SYS-ED/ COMPUTER EDUCATION TECHNIQUES, INC. TABLE 1 HANDLING Chapter SYS-ED/ COMPUTER EDUCATION TECHNIQUES, INC Objectives You will learn: C C C C C C When to use a table How to allocate and initialize a table Differences between a subscripted and