Batch Processing (SARBCH)

CA View provides batch retrieval facilities with its SARBCH program. SARBCH performs these functions in batch.
view
CA View provides batch retrieval facilities with its SARBCH program. SARBCH performs these functions in batch.
Note:
SARBCH does not utilize the online access mode filters defined for users. To prevent a user from accessing a SYSOUT or DISTID that is not seen when online filters are applied, you must define security rules either to prevent user access to a specific resource, or to ensure that the user is unable to run SARBCH.
Contents
Job Control Statements
A Sample execution JCL can be found in member HAEXBCH in your CVDEJCL data set.
The following job control statements are required to execute SARBCH:
  • JOB
    Initiates the job.
  • EXEC
    Specifies the program name (PGM=SARBCH) and, optionally, the high-level name of the product database as the PARM parameter (PARM='VIEW.SYSTEM1').
  • STEPLIB DD
    Defines the load library containing SARBCH.
    If the program resides in a link list library, omit this statement.
  • SYSPRINT DD
    Defines the sequential output data set (normally SYSOUT) used for listing the control statements and messages.
    If you are not defining a SYSOUT data set, you must code DCB=BLKSIZE=nnn, where nnn is a multiple of 133.
  • REPORT DD
    Defines an output data set (normally SYSOUT) into which SYSOUT listing from the LIST function is written.
    This statement can be omitted if no LIST control statements are input to the program. If you are not defining a SYSOUT data set, you must code DCB=BLKSIZE=nnn, where nnn is a multiple of 133.
  • SARLOAD DD
    Defines a user-maintained, sequential data set into which the LOAD function is to load the SYSOUT.
    This statement is optional, but, if you omit it, the product temporarily loads the SYSOUT to its database. Multiple SARLOAD DD statements with the FREE=CLOSE parameter can be used to load multiple SYSOUT groups to different user-defined data sets.
  • SYSIN DD
    Defines a card image data set that contains the control statements to be input.
  • DDNAME DD
    Defines a data set to which a SYSOUT group can be written.
    Note
    : For more information about this dataset, see the LOAD and PRINT SARBCH control statements.
  • CTLCARDS DD
    Optional DD, used with the LISTDEV, LISTFILT, and LISTVIEW parameters to create DEFDEV, DEFFILT, and DEFVIEW statements that can later be used to define new or modify existing devices, filters, and logical views. This dataset is to have the following JCL attributes:
    RECFM=FB
    LRECL=80
SARBCH Examples
Example 1
The two most recent generations of archived SYSOUT are listed.
//EXAMPLE1 JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARBCH //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSPRINT DD SYSOUT=* //REPORT DD SYSOUT=* //SYSIN DD * /DBASE NAME=VIEW.SYSTEM1 /LIST /LIST GEN=-1 /*
Example 2
The most recent SYSOUT group for job A0627WE is printed to special forms 2PT.
//EXAMPLE2 JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARBCH //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSPRINT DD SYSOUT=* //SYSIN DD * /DBASE NAME=VIEW.SYSTEM1 /PRINT ID=A0627WE FORM=2PT /*
Example 3
The report having a SYSOUT ID of M35AST03R1 created two generations ago is loaded to existing data set USER.M35AST03.R1.
//EXAMPLE3 JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARBCH,PARM='VIEW.SYSTEM1' //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SARLOAD DD DSN=USER.M35AST03.R1,DISP=OLD //SYSPRINT DD SYSOUT=* //SYSIN DD * /LOAD ID=A35AST03R1 GEN=-2 /*
Example 4
This example builds the control records that let users use JOB mode to access all occurrences of job TESTJOB1 that were run between March 1, 2015 and April 1, 2015.
//EXAMPLE3 JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARBCH,PARM='VIEW.SYSTEM1' //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSPRINT DD SYSOUT=* //SYSIN DD * /ADDJOB JOBNAME=TESTJOB1 DATE=03/01/2015:04/01/2015 /*