Components of a VSE Batch Job Stream

Running in a Batch Environment › Components of a Batch Job Stream › Components of a VSE Batch Job Stream

Components of a VSE Batch Job Stream

You can use CA Ideal members to build and store job streams (JCL records and CA Ideal commands) online and to submit job streams. You can submit JCL for batch CA Ideal through any other means suitable for batch job submission. See Data Members for a complete description of the CA Ideal member.

The following standard JCL records are used in a VSE environment to execute CA Ideal in batch.

* $$ JOB JNM=IDBATCH,PRI=n,USER='username',DISP=D
* $$ LST DISP=D,CLASS=L,LST=cuu...
* $$ LST DISP=D,CLASS=L,LST=cuu...
* $$ LST DISP=D,CLASS=L,LST=cuu...
* $$ LST DISP=D,CLASS=L
// JOB IDBATCH
// OPTION LOG,NODUMP
// EXEC PROC=IDLPROC
*****************************
* Assignments for sequential file dataviews and work areas
* for sorted reports. 
*****************************
// ASSGN SYS...,cuu
// ASSGN SYS...,cuu
// ASSGN SYS...,cuu
// EXEC IDBATCH,SIZE=80K,PARM='NOPRINT'
SIGNON PERSON username PSW psword 
COMPILE pgmname
RUN pgmname
OFF
/*
// EXEC LISTLOG
/*
/&
* $$ EOJ

There are three types of instructions in this job stream: operating system commands, spooling system commands, and CA Ideal commands.

VSE JOB control instructions all begin with the characters // . VSE JOB control interprets the commands beginning with an asterisk and followed immediately by a space (* ) as comments. POWER is the VSE JOB Input/Output spooling system. JOB Entry Control Language (JECL) commands all begin with the * $$ character string.

$$ JOB JNM=IDBATCH, PRI=n, USER='username', CLASS=c,DISP=D

This statement identifies the job to POWER.

JNM=IDBATCH: This job stream is identified to POWER as IDBATCH.
PRI=n: Dispatching priority of this job is n.
USER='username': Used for accounting purposes. If your site uses external security to control access to CA Ideal, this parameter provides a security ID for the job stream.
CLASS=c: Defines which VSE partition this job stream can execute in.
DISP=D: Defines the disposition in the reader spool for the job stream. D submits the job stream for execution immediately and does not retain it in the reader queue (spool) after execution.

$$ LST DISP=D,CLASS=L

This statement defines the output parameters for the VSE system log file.

DISP=D: This parameter defines the disposition of the output in the POWER list queue. As in the DISP option for the JOB command, D releases the job stream immediately and does not retain it in the queue.
CLASS=L: This parameter organizes the LIST queue. Use it with subsequent * $$ LST statements to logically separate the various CA Ideal outputs.

// JOB IDBATCH

This is the first VSE job control command of the job stream. The job stream is identified as IDBATCH. All references to the JOB on the operator's console are to IDBATCH (not the POWER jobname).

// OPTION LOG,NODUMP

The OPTION command sets execution options for this jobstep and all following jobsteps until a contrary option command is issued. LOG sets the request for all job control statements to list with the output; NODUMP suppresses the DUMP option.

// EXEC PROC=IDLPROC

This statement copies a JCL procedure into the job stream. IDLPROC is an installed procedure to define all CA Ideal and user system files for batch.

* $$ LST DISP=D, CLASS=L,LST=cuu...

These POWER statements keep CA Ideal outputs logically separated. An execution of batch CA Ideal has two or more outputs:

CA Ideal session output. This file shows a simulated session of CA Ideal commands and the resulting panels and messages.
CA Ideal error log
If a RUN command is issued in the batch run, then you must make additional * $$ LST entries for LIST statement output and for each application report.
DISP=D This parameter defines the disposition of the output in the POWER list queue. As in the DISP option for the JOB command, D releases the job stream immediately and does not retain it in the queue.
CLASS=L This parameter organizes the LIST queue. These statements are used with other * $$ LST statements to logically separate the various CA Ideal outputs.
LST=cuu... Indicates the logical printer defined for the various output files. See your systems programmer for the actual logical unit assignments for these files.
```
***************************
*Assignments for sequential file dataviews and work areas
*for sorted reports
***************************
```

These comments show where sequential dataview files and sorted report work files go. Since they are not needed on every batch CA Ideal run, they are not included in the IDLPROC procedure.

// EXEC IDBATCH, SIZE=80K,PARM='NOPRINT'

IDBATCH is the CA Ideal batch processing program. The size parameter sets the amount of storage allocated to the program for execution. The rest of the partition is used for processing other CA Ideal routines.

The parameter PARM='NOPRINT' is optional. If you omit this parameter or specify it with a null value (''), a simulated CA Ideal session is printed. Specifying the parameter with the value NOPRINT suppresses all SYSPRINT output except the commands entered and the messages produced. The simulated CICS session is not printed.

The statements that follow the EXECUTE command are CA Ideal commands.

SIGNON PERSON username PSW password PRODUCT IDEAL
COMPILE pgmname
RUN pgmname
OFF

The statements follow the same format as an online session.

/* This is a JOB step delimiter.
// EXEC LISTLOG LISTLOG is a VSE utility that adds all operator console messages associated with the job stream to the end of the output for the job stream.
/& VSE job delimiter.
$$ EOJ POWER job delimiter.