Batch Utility Statements

Batch Utility Reference › Batch Utility Statements › Batch Utility Statements

Batch Utility Statements

The PROCESS statement specifies the actions to be taken by the batch utility. The following general rules apply when coding PROCESS statements:

One or more PROCESS statements must be submitted in each batch utility run.
When multiple PROCESS statements are specified, each successive PROCESS statement overrides the previous one.
A PROCESS statement specifies the action to be taken for the utility PANEL and MAP statements that follow it.

                    ┌──────── , ───────────────────────────────────────────┐
►►──── PROCESS = ───▼──┬─── LOAD ───────────────────────────────────────┬──┴─►◄
                       ├─┬─ REPORT ─┬───────────────────────────────────┤
                       │ └─ IMAGE ──┘                                   │
                       ├─┬─ DECOMPILE ─┬─┬──────────────────────┬───────┤
                       │ └─ TERSE ─────┘ └─ , DATETIME = YES ─┬─┘       │
                       │                               └─ NO ─┘         │
                       ├────── ALL ─────────────────────────────────────┤
                       └────── DELETE ──────────────────────────────────┘

Parameters

LOAD

Generates a map load module and stores the module in the DDLDCLOD area of the data dictionary. LOAD applies only to MAP statements; at least one MAP statement must follow a PROCESS LOAD statement.

REPORT/IMAGE

Generates a report and/or a copy of the screen format for all specified map and panel occurrences:

REPORT prints a screen image and report for the specified map and panel occurrences as shown in the following figure.
IMAGE prints a screen image for the specified map and panel occurrences.

DECOMPILE/TERSE

Produces source code from data dictionary map and panel occurrences:

DECOMPILE provides all specifications made for the named map and/or panel occurrences
TERSE provides only non-default specifications for the named map and/or panel occurrences

Output for either DECOMPILE or TERSE is written to SYSPCH and consists of executable source code suitable for processing by the map compiler. The decompile process does not affect the load module.

DATETIME date-time-stamp

DATETIME has the following options:

YES—Includes the map's date/time stamp in the decompiled map's source code. The date/time stamp is returned in the DATETIME clause in the newly decompiled map source statements.
NO (default)—Decompiles the map without retaining the map's date/time stamp.

Note: DATETIME is only an option for decompile operations (PROCESS=DECOMPILE or PROCESS=TERSE).

DELETE

Logically deletes map load modules from the DDLDCLOD area. The actual deletion is performed at CA IDMS startup. DELETE applies only to MAP statements; at least one MAP statement must follow a PROCESS DELETE statement. The DELETE operation has no effect on map occurrences in the DDLDML area. The map compiler must be used to delete map or panel occurrences.

ALL

Requests that LOAD, REPORT, and DECOMPILE be performed. ALL applies only to MAP statements; at least one MAP statement must follow a PROCESS ALL statement.

Note: When multiple processes are specified, each must be separated by a comma, as shown:

PROCESS=REPORT,LOAD

If there are spaces between items, this will result in the rest of the line to be ignored.

Sample Report and Code

As a result of specifying DECOMPILE, REPORT, the map utility produces a report, a screen image, and mapping language source code as shown on the following pages.

EJECT
MAP CEXME028 VERSION     1
    AUTOPANEL
    DEVICES = (24X80, 32X80, 43X80, 27X132)
    NONRESIDENT
    USING ( (EMPLOYEE    100))
    EDIT
    RESET UNLOCK NOALARM NOPRT NLCR
    NONPAGEABLE
    DECIMAL POINT IS PERIOD
    HELP NO
    ON EDIT ERROR
        SOUND NOALARM.
         SPACE 2
MFLD
    FOR (24X80, 32X80, 43X80, 27X132)
    AT (   4,  25)
    ATTRIBUTES = (ALPHANUMERIC,PROTECTED,DETECTABLE,BRIGHT,NOMDT,
                  NOBLINK,NORMAL-VIDEO,NOUNDERSCORE,
                  NOCOLOR)
    NODELIMIT
    VALUE = ((   1) 'EMPLOYEE PHONE INFORMATION')
    NOCURSOR
    LITERAL.
         SPACE 2

MFLD
    FOR (24X80, 32X80, 43X80, 27X132)
    AT (   8,  25)
    ATTRIBUTES = (NUMERIC,PROTECTED,NONDETECTABLE,DISPLAY,NOMDT,
                  NOBLINK,NORMAL-VIDEO,NOUNDERSCORE,
                  NOCOLOR)
    NODELIMIT
    VALUE = ((   1) 'EMPLOYEE ID')
    NOCURSOR
    LITERAL.
         SPACE 2

MFLD FOR (24X80, 32X80, 43X80, 27X132) AT ( 8, 45) ATTRIBUTES = (ALPHANUMERIC,UNPROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) DELIMIT = SKIP NOCURSOR DFLD EMP-ID-0415 OF EMPLOYEE VER 100 HELP SOURCE NONE OPTIONAL REVERSE NUMERIC IS NO EXTERNAL PICTURE IS INTERNAL ZEROED WHEN NULL DISPLAY WHEN ZERO FOR INPUT JUSTIFY LEFT PAD NO DATA YES UPPER NO FOR OUTPUT DATA YES BACKSCAN NO. SPACE 2 MFLD FOR (24X80, 32X80, 43X80, 27X132) AT ( 12, 25) ATTRIBUTES = (NUMERIC,PROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) NODELIMIT VALUE = (( 1) 'PHONE NUMBER') NOCURSOR LITERAL. SPACE 2 MFLD FOR (24X80, 32X80, 43X80, 27X132) AT ( 12, 45) ATTRIBUTES = (ALPHANUMERIC,UNPROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) DELIMIT = SKIP NOCURSOR DFLD EMP-PHONE-0415 OF EMPLOYEE VER 100 HELP SOURCE NONE OPTIONAL REVERSE NUMERIC IS NO EXTERNAL PICTURE IS INTERNAL ZEROED WHEN NULL DISPLAY WHEN ZERO FOR INPUT JUSTIFY LEFT PAD NO DATA YES UPPER NO FOR OUTPUT DATA YES BACKSCAN NO. CAGJF0 CA IDMS/DC MAP UTILITY DATE: mm/dd/yy TIME: 171634 PAGE 3 THE FOLLOWING SYMBOLS REPRESENT ATTRIBUTE CHARACTERS: U - UNPROTECTED ALPHANUMERIC FIELD P - PROTECTED ALPHANUMERIC FIELD N - UNPROTECTED NUMERIC FIELD S - AUTOSKIP FIELD (PROTECTED AND NUMERIC)

CAGJF0 CA IDMS/DC MAP UTILITY DATE: mm/dd/yy TIME: 171634 PAGE 4 REPORT FOR MAP CEXME028 VERSION 1 COMPILE DATE: mm/dd/yy COMPILE TIME: 171458 DEVICES: 24X80, 32X80, 43X80, 27X132 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 125 130 ********************************************************************************************************************************** PEMPLOYEE PHONE INFORMATION SEMPLOYEE ID U....S (CURSOR) - SPHONE NUMBER U..........S ********************************************************************************************************************************** 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 100 105 110 115 120 125 130 CAGJF0 CA IDMS/DC MAP UTILITY DATE: mm/dd/yy TIME: 171634 PAGE 5 REPORT FOR MAP CEXME028 VERSION 1 COMPILE DATE: mm/dd/yy COMPILE TIME: 171458 DEVICES: 24X80, 32X80, 43X80, 27X132 USING RECORDS: EMPLOYEE VERSION 100 WCC: NOALARM, UNLOCK KEYBOARD, RESET MODIFIED, NOPRT, NLCR PANEL CEXME028-AUTOPANEL VERSION 1 PFLD: AUTOPF00001 AT ( 4,25) ATTRIBUTES = (ALPHANUMERIC,PROTECTED,DETECTABLE,BRIGHT,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) NODELIMIT LITERAL STRING PFLD: AUTOPF00002 AT ( 8,25) ATTRIBUTES = (NUMERIC,PROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) NODELIMIT LITERAL STRING PFLD: AUTOPF00003 AT ( 8,45) ATTRIBUTES = (ALPHANUMERIC,UNPROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) DELIMIT SKIP DFLD: EMP-ID-0415 OF EMPLOYEE HELP SOURCE NONE OPTIONAL EXTERNAL PICTURE IS INTERNAL ZEROED WHEN NULL DISPLAY WHEN ZERO INPUT: JUSTIFY LEFT, UPPER NO, DATA YES, PAD NO OUTPUT: BACKSCAN NO, DATA YES PFLD: AUTOPF00004 AT (12,25) ATTRIBUTES = (NUMERIC,PROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) NODELIMIT LITERAL STRING

PFLD: AUTOPF00005 AT (12,45) ATTRIBUTES = (ALPHANUMERIC,UNPROTECTED,NONDETECTABLE,DISPLAY,NOMDT, NOBLINK,NORMAL-VIDEO,NOUNDERSCORE, NOCOLOR) DELIMIT SKIP DFLD: EMP-PHONE-0415 OF EMPLOYEE HELP SOURCE NONE OPTIONAL EXTERNAL PICTURE IS INTERNAL ZEROED WHEN NULL DISPLAY WHEN ZERO INPUT: JUSTIFY LEFT, UPPER NO, DATA YES, PAD NO OUTPUT: BACKSCAN NO, DATA YES MAP LOAD MODULE GENERATED IN LOAD AREA FOR CEXME028, SIZE = 424 END OF CA IDMS/DC MAP UTILITY