Version 4.3.2
 —  Using Batch Facilities  —

Batch Processor Job Control Requirements

This document covers the following topics:


For OS/390 or z/OS Environments

The job shown below is contained in member REVIEWB of the Adabas Review source library and can be used to execute the Adabas Review processor in batch.

Start of instruction setTo modify the job before submitting it

  1. Change "vrs" to the current version, revision, and system maintenance level of the product.

  2. Modify the job card, if necessary.

  3. Modify the DD statement for RVUSEQ as necessary. Point to a command log file generated by Adabas or Adabas Review.

  4. Add any additional RVUPRTxx or RVUCOPxx DD statements as necessary depending on your report definitions (where "xx" is a value 01 through 99).

    //REVIEWB  JOB 
    (LOCATION),`REVIEW',MSGCLASS=X,CLASS=A
    //*
    //REVIEWB  EXEC PGM=REVIEWB,REGION=512K
    //STEPLIB  DD DISP=SHR,DSN=REVIEW.Vvrs.LOAD
    //         DD DSN=SHR,DSN=ADABAS.Vv.LOAD
    //*
    //RVUSEQ   DD DSN=SHR,DSN=ADABAS.COMMAND.LOG.FILE.
    //         DCB=(RECFM=VB,BLKSIZE=10000)
    //RVUFLD   DD DSN=SHR,DSN=REVIEW.Vvrs.SOURCE(USRPARM)
    //*
    //RVUPRT00 DD SYSOUT=X,LRECL=80
    //RVUPRT01 DD SYSOUT=X,LRECL=133
    //RVUPRT02 DD SYSOUT=X,LRECL=133
    //SYSUDUMP DD SYSOUT=X
    //TRACEOUT DD SYSOUT=X,LRECL=133
    //*
    //RVUPARM  DD *
    INPUT   FILETYPE=SEQUENTIAL,LIMIT=1000
    *
    REPORT  TYPE=SUMMARY,TITLE=`SAMPLE REPORT'
    AVERAGE DURATION,ASSO-IO,DATA-IO,CMDRESP
    MINIMUM DURATION,ASSO-IO,DATA-IO,CMDRESP
    MAXIMUM DURATION,ASSO-IO,DATA-IO,CMDRESP
    DISPLAY JOB
    *
    /*

The following DD statements are required, or optional where noted, for executing the Adabas Review processor in interactive or batch mode:

DD Statement Description
RVUPARM A dataset of control statements that specify input report parameters. These statements can be generated by the GENCARD command and copied from the resulting RVUCARD output into the RVUPARM dataset. LRECL=80.
RVUSEQ Sequential dataset containing command log records: RECFM=VB,LRECL=9996,BLKSIZE=10000
RVUCOPxx (Optional) Copied output logs; same format as RVUSEQ (where "xx" is 01-99).
RVUPRTxx Review logical printers (where "xx" is 01-99). LRECL is required. It may be in the range of (72-4080); LRECL=133 is typical.
RVUALT Alternate sequential file used to save history information if the Adabas Review processor, either interactively or in batch, receives an Adabas response code 148 (Adabas not active) when attempting to save history data. This file should be allocated using the following DCB attributes: RECFM=VB,LRECL=9996,BLKSIZE=10000
RVUAUT1 (Optional in batch mode) Parameter card images for autostarted reports; LRECL=80.
RVUAUT2 (Optional in batch mode) Parameter card images for autostarted reports; LRECL=80.

Note:

Adabas Review uses two parameter files for the report definition control statements and alternates between them by writing to the older file. See the section Autostarted Reports on page .

RVUFLD Parameter card images; LRECL=80. Parameters to describe user-defined fields.

Top of page

For VSE/ESA Environments

The job shown below is contained in member REVIEWB of the Adabas Review source library and can be used to execute the Adabas Review processor in batch.

Start of instruction setTo modify the job before submitting it

  1. Change "vrs" to the current version, revision, and system maintenance level of the product.

  2. Modify the job cards, if necessary.

  3. Modify the job control statement for RVUSEQ as necessary. Point to one of the command log files.

  4. Add any additional RVUPRTxx or RVUCOPxx job control statements as necessary, depending on your report definitions (where "xx" is a value 01 through 99).

    //  JOB REVIEWB                             sample
    Review job
    //  EXEC  PROC=REVvrs                       Review private libraries
    //  ASSGN SYS005,SYSIPT                     RVUPARM - cards
    //  ASSGN SYS006,DISK,VOL=VVVVVV,SHR        RVUSEQ - tape
    //  ASSGN SYS007,IGN                        MAY be IGN for batch
    //  ASSGN SYS020,PRINTER                    RVUPRT0 - printer
    //  ASSGN SYS021,CUU                        RVUPRT1 - printer
    //  DLBL RVUSEQ, 'ADABAS.Vvr.COMMAND.LOG'   RVUSEQ - command
    log
    //  EXTENT SYS006,VVVVVV
    //  EXEC REVIEWB,SIZE=(AUTO,64K)
    INPUT    FILETYPE=SEQUENTIAL,LIMIT=1000
    REPORT   TYPE=SUMMARY,TITLE='SAMPLE REPORT'
    AVERAGE  DURATION
    MINIMUM  DURATION,ASSO-IO,DATA-IO,CMDRESP
    MAXIMUM  DURATION,ASSO-IO,DATA-IO,CMDRESP
    DISPLAY  JOB
    /*

    Note:
    The logical units shown in the example above may be reassigned if there are conflicts with your site-specific logical units. Refer to the Adabas Review Installation and Operations (VSE/ESA) documentation for more information.

The following job control statements are required, or optional where noted, for executing the Adabas Review processor in interactive mode or batch mode:

Job Control Statement Logical Unit(s) Description
RVUPARM SYS005 Parameter card images; 80-byte records.

RVUPARM is a dataset of control statements that specify input report parameters. These statements can be generated by the GENCARD command and copied from the resulting RVUCARD output into the RVUPARM dataset.

RVUSEQ SYS006 Sequential dataset containing command log records: Record Format = VB,
Record Length = 9996,
Block Size = 10000.
RVUCOPx SYS031-39 (Optional) Copies output logs; same format as RVUSEQ (where "x" is 1-9).
RVUPRTx SYS020-29 Review logical printers (where "x" is 0-9).
RVUALT SYSxxx* Alternate sequential file used to save history information if the Adabas Review processor, either interactively or in batch, receives an Adabas response code 148 (Adabas not active) when attempting to save history data. This file should be allocated using the job DBFILES in the Adabas Review source library. * May be any unused value.
RVUAUT1 / RVUAUT2 SYS007 (Optional in batch mode) Parameter card images for autostarted reports. Adabas Review uses two parameter files for the report definition control statements and alternates between them by writing to the older file.

Note:
SYS007 may be assigned to IGN when running Adabas Review in batch mode.

Top of page

For BS2000 Environments

The job shown below is contained in member P.REVBATCH of the Adabas Review source library and can be used to execute the Adabas Review processor in batch.

Start of instruction setTo modify the job before submitting it

  1. Set &ADAL to the Adabas Library

  2. &BATCH to the output file prefix

  3. &CLOG to the command log generated by Adabas or Adabas Review &REVL to the Adabas Review Library

  4. modify the parameters following the '/STA-EDT' card to those required for the job

    /BEGIN-PROC C,PROC-PAR=( -
    / &ADAL=$SAG.ADABAS.MOD,-
    / &BATCH=BATCH,-
    / &CLOG=$SAG.DB00099.CLOGR1,-
    / &DUMP=YES,-
    / &REVL=$SAG.REVIEW.MOD -
    / ),ESC-CHAR='&'
    /REMARK
    /REMARK          ****************************************************
    /REMARK          *    START REVIEW BATCH                            *
    /REMARK          ****************************************************
    /REMARK
    /MOD-TEST        DUMP=&DUMP
    /DEL-FI #RVUPARM
    /SET-JOB-STEP
    /SET-FILE-LINK    EDTSAM,#RVUPARM ,REC-FORM=F(REC-SIZE=80)
    /MOD-J-SW ON=(4,5)
    /ASS-SYSDTA *SYSCMD
    /STA-EDT
    INPUT  FILETYPE=SEQUENTIAL,LIMIT=1000
    REPORT TYPE=SUMMARY,TITLE='SAMPLE REPORT'
    AVERAGE DURATION,ASSO-IO,DATA-IO,CMDRESP
    MINIMUM DURATION,ASSO-IO,DATA-IO,CMDRESP
    MAXIMUM DURATION,ASSO-IO,DATA-IO,CMDRESP
    DISPLAY JOB
    @W '#RVUPARM' O
    @H
    /SET-JOB-STEP
    /MOD-J-SW OFF=(4,5)
    /SET-JOB-STEP
    /ASS-SYSLST   L.REV&BATCH..L
    /ASS-SYSDTA *SYSCMD
    /SE-F-LI         RVUAUT1,*DUMMY
    /SE-F-LI         RVUAUT2,*DUMMY
    /SE-F-LI         RVUPRT00,&BATCH..RVUPRT00
    /SE-F-LI         RVUPRT01,&BATCH..RVUPRT01
    /SE-F-LI         RVUPRT02,&BATCH..RVUPRT02
    /SE-F-LI         RVUSEQ,&CLOG
    /SE-F-LI         RVUPARM,#RVUPARM
    /SE-F-LI         COMPRINT,#COMPRINT,REC-FORM=F(REC-SIZE=80)
    /REMA
    /SE-F-LI         DDLIB,&ADAL
    /SE-F-LI         BLSLIB00,&REVL
    /SET-JOB-STEP
    /STA-PROGRAM   (&REVL,REVBATCH),RUN-M=ADV(A-L=YES)
    /ASS-SYSLST *PRIM
    /ASS-SYSDTA *PRIM
    /END-PROC

The following Link statements are required (or are optional where noted), for executing the Adabas Review processor in interactive or batch mode:

Link Statement Description
RVUPARM Parameter card images; REC-FORM=FIXED(REC-SIZE=80).

RVUPARM is a dataset of control statements that specify input report parameters. These statements can be generated by the GENCARD command and copied from the resulting RVUCARD output into the RVUPARM dataset.

RVUSEQ Sequential dataset containing command log records
RVUCOPxx (Optional) Copied output logs; same format as RVUSEQ (where 'xx' is 01-99).
RVUPRTxx Review logical printers (where 'xx' is 01-99). Sequential file with REC-FORM=FIXED(REC-SIZE=133).
RVUALT Alternate sequential file used to save history information if the Adabas Review processor, either interactively or in batch, receives an Adabas response code 148 (Adabas not active) when attempting to save history data.
RVUAUT1 (Optional in batch mode) Parameter card images for autostarted reports; REC-FORM=FIXED(REC-SIZE=80).
RVUAUT2 (Optional in batch mode) Parameter card images for autostarted reports; REC-FORM=FIXED(REC-SIZE=80).

Note:
Adabas Review uses two parameter files for the report definition control statements and alternates between them by writing to the older file. See the section Autostarted Reports. RVUFLD Parameter card images; REC-FORM=FIXED(REC-SIZE=80). Parameters to describe user-defined fields.

Top of page

For z/VM Environments

The Adabas Review processor is executed in batch mode using the REVBATCH EXEC provided on the Adabas Review installation tape. The only parameter required is the name of the file containing the Review input parameters. The FILETYPE of the input parameters must be "REVPARMS". For example, the following runs Adabas Review in batch mode using the report parameters found in "SAMPLE1 REVPARMS":

REVBATCH SAMPLE1

The following filedef statements are required, or optional where noted, for executing the Adabas Review processor in interactive mode or batch mode:

Filedef Statement Description
RVUPARM Parameter card images; LRECL=80.
RVUSEQ Sequential dataset containing command log records: ( RECFM VB LRECL 9996 BLOCK 10000 )
RVUCOPxx (Optional) Copied output logs; same format as RVUSEQ (where "xx" is 01-99).
RVUPRTxx Review logical printers (where "xx" is 01-99). LRECL is required. It may be a value in the range 72-408; LRECL=133 is typical.
RVUALT Alternate sequential file used to save history information if the Adabas Review processor, either interactively or in batch; receives an Adabas response code 148 (Adabas not active) when attempting to save history data. This file should be allocated using the following DCB attributes: ( RECFM VB LRECL 9996 BLKSIZE 10000 )
RVUAUT1 RVUAUT2 (Optional in batch mode) Parameter card images for autostarted reports; LRECL=80.

Note:

Adabas Review uses two parameter files for the report definition control statements and alternates between them by writing to the older file. See the section Autostarted Reports on page .

Top of page