asg-job/scan ca-7 for z/os scheduler interface user guide 8

ASG-JOB/SCAN

CA-7 for z/OS Scheduler Interface User GuideVersion: 8.1

Publication Date: August, 2021

© 2021 ASG Technologies Group, Inc. All rights reserved.

The information contained herein is the confidential and proprietary information of ASG Technologies Group, Inc. Unauthorized use of thisinformation and disclosure to third parties is expressly prohibited. This technical publication may not be reproduced in whole or in part, by anymeans, without the express written consent of ASG Technologies Group, Inc.

All names and products contained herein are the trademarks or registered trademarks of their respective holders.

ASG Technologies Worldwide Headquarters Naples Florida USA | asg.com | [email protected]

708 Goodlette Road North, Naples, Florida 34102 USA Tel: 239.435.2200 Fax: 239.263.3692 Toll Free: 800.932.5536 (USA only)

2

ASG-JOB/SCAN CA-7 for z/OS Scheduler Interface User Guide

ContentsPreface 4

Worldwide Customer Support 4

ASG Customer Care Expert Solution Services Portal (ACCESS) 4

Product Support Policy 5

ASG Documentation/Product Enhancements 5

User Information - JOB/SCAN with CA-7 6

Getting Started 7

Usage Scenarios 7

Terminology 7

Using JCA to Validate JCL 9

JCA Edit Macro 9

Using the JCA Edit Macro in ISPF Edit or View 9

Validating Jobs from Foreground 12

Set Up to Use Foreground Validation 12

Validating Members 13

Using CA7SCHD to Validate a CA-7 Schedule 15

Using JSCA7 to Validate a JOB 17

Set up the Batch Job for a SingleMember 17

Run the Batch JOBs 18

JOB/SCAN CA-7 Interface Setup 20

Create a CA-7Working Library 20

Set Site-Specific Values 20

Setting up Pooling (Optional) 21

3

PrefaceWorldwide Customer SupportASG provides support throughout the world to resolve questions or problems regarding installation, operation, or use ofour products. ASG provides all levels of support during normal business hours and emergency support during non-business hours.

You can access support information from ASG’s Support page.

ASG Third-party Support. ASG provides software products that run in a number of third-party vendor environments.Support for all non-ASG products is the responsibility of the respective vendor. In the event a vendor discontinuessupport for a hardware and/or software product, ASG cannot be held responsible for problems arising from the use ofthat unsupported version.

ASG Customer Care Expert Solution Services Portal (ACCESS)The ACCESS Portal provides online support. Log on to the ACCESS with this information:

Email ID = NNNNNNNNN

Site Password = XXXXXXXXXX

where:

NNNNNNNNN is your email ID supplied by ASG Product Distribution.

XXXXXXXXXX is your unique site password supplied by ASG Product Distribution.

If you do not have your logon information, contact your local support center. This table outlines the support responsetimes you can expect:

Severity MeaningExpected Support ResponseTime

1 Production down, critical situation Within 30minutes

2 Major component of product disabled Within 2 hours

3 Problem with the product, but customer has work-aroundsolution

Within 4 hours

4 “How-to” questions and enhancement requests Within 4 hours

4


Product Support PolicyASG fully supports the current release and one previous release of each of its products. ASGwill temporarily support anolder release, for up to six months, to provide time for you to upgrade.

After programming support for a product release is withdrawn, ASGwill no longer supply new fixes for problems noraccept enhancement requests for that release. When a vendor announces the end of support for system software or ahardware configuration on which ASG products rely, ASGwill make a similar announcement regarding the support plansfor its products. ASG’s support for problems affected by system software release levels will terminate when the vendorno longer supports their hardware or software.

Announcements regarding support plans for various products can be found on ASG’s Web site.

ASG Documentation/Product EnhancementsUse ASG’s contact form to submit your product and documentation suggestions. Ensure that you include the name ofthe ASG product you are using.

5

Product Support Policy

https://www.asg.com/en/Contact-Us.aspx

User Information - JOB/SCAN with CA-7This documentation describes the interface between ASG-JOB/SCAN (herein called JOB/SCAN) and the CA-7 Scheduler. Itexplains how to initialize and execute the interface, and provides Edit macro and batch mode instructions.

Topic Description

Getting Started Introduces the facilities of the CA-7 interface.

Using JCA to Validate JCL Describes the Edit Macro validation function.

Validating Jobs from Foreground Describes how to resolve variables and validate JCL through theISPF panels.

Using CA7SCHD to Validate a CA-7 Schedule Describes validating schedules through batch.

Using JSCA7 to Validate a JOB Describes validating a member so that variables are resolved.

JOB/SCAN CA-7 Interface Setup Describes the installation of the interface.

6


Getting StartedASG provides this handbook to IT professionals who work with JCL members containing CA-7 #Jx control statements andCA-Driver procedures. The crucial need is for CA-7 and CA-Driver to resolve the CA-7 control statements in the JCL beforevalidation by JOB/SCAN.

The facilities provided through JOB/SCAN support these requirements, enhancing the overall quality and efficiency of theJCL processing at sites using CA-7 Job Management and CA-Driver software.

n Usage Scenarios

n Terminology

Usage ScenariosThis JOB/SCAN CA-7 scheduler interface resolves CA-7 #Jx control statements and CA-Driver variables before JOB/SCANvalidation. The JOB/SCAN CA-7 interface has two approaches to validating JCL:

l Use thematerial in this documentation when you havemembers that contain both CA-Driver and CA-7variables and want to validate them through batch, ISPF panels, or Edit macro modes.

l Use thematerial in the topic:Scheduler Interfaces in Reference Information when you have legacy batchprocesses utilizing the previous JOB/SCAN-CA-7 interface. These remain supported without modification toyour supporting jobs. See the topic: CA-7 Scheduler Interface in Reference Information for informationabout this interface.

TerminologyTerminology

The following terms are used in this documentation:

CA-7 # Control Statements

The statements that CA-7 interprets to dynamically change job stream contents. Among these are #ARF, #HLD, #JI, #JO,#MNT, #XI,and #XO.

CA-Driver Procedures

The procedures CA-Driver expands into the job stream at job submission time.

Catalog (Run-Time) Simulation

Thorough validation of production JCL requires that the JCL be analyzed on multiple levels to identify potential problems:

l On themost basic level, JOB/SCAN ensures that the JCL is syntactically correct.

l At the run-time level, JOB/SCAN identifies:

o environmental errors, such as security violations and programs not found.o dataset disposition errors.

7

Getting Started

Whether processing a single JCL member or a sequence ofmembers, JOB/SCAN uses its powerful z/OScatalog simulation facility to ensure that the JCL steps will create, use and delete datasets asexpected.

See User Documentation for a thorough description of JOB/SCAN's z/OS simulation.

8


Using JCA to Validate JCLJOB/SCAN's Edit macro takes the JCL in the Edit workspace, gives it to CA-7 to process and then validates the resultingJCL.

This topic consists of following topics:

n JCA Edit Macro

n Using the JCA Edit Macro in ISPF Edit or View

JCA Edit MacroThe purpose of the Edit macro is to validate a single member. JCA supports these special command-line parameters:

Parameter Description

SJOB Member name under which JOB/SCAN stores the JCL in the CA-7 JCL library.

SDATE Scheduled Run date; default is current date. Format is: YYMMDD

STIME Scheduled Run time; default is current time. Format is: HHMM

SCHID Three character schedule ID; default is 001.

DEBUG Displays temporary files as they are used.

RESET Resets the Schedule Criteria panel for display (unsuppresses it).

For more information about other parameters for JOB/SCAN's Edit macros, see User Documentation or ReferenceInformation.

Before using any function in this documentation, ask your administrator to be sure to followinstallation and activation instructions in JOB/SCAN CA-7 Interface Setup.

Using the JCA Edit Macro in ISPF Edit or ViewTo use this method, you Edit/View a member in an ISPF EDIT/VIEW session. To achieve themost accurate validation ofJCL members with JOB/SCAN, the CA-7 # control statements must be resolved before validation. The JCA Edit macro firstresolves CA-7 # control statements and CA-Driver procedures, then validates the JCL.

To validate JCL from within an EDIT/VIEW session

1. Bring the JCL member into ISPF EDIT.

9

Using JCA to Validate JCL

2. Type JCA and any optional parameters on the command line. JOB/SCAN displays the CA-7 Schedule Criteriapanel.

EDIT ASGUSR.JCL(TEST) - 01.00 Columns 00001 00072Command ===> JCA stime(1220) Scroll ===> CSR000001 //PC28002A JOB (PRV1PD,132900,DSS,37),PC28002,MSGCLASS=X000002 /*ROUTE PRINT PRV103000003 //S1 EXEC PGM=IEFBR14, !:20021(&3:0000)000004 // REGION=000005 #JI,SCHID=002000006 //DD1 DD DSN=PRV1.SMS.PC28002A,000007 // DATACLAS=SRCFLIB,000008 // LRECL=80,RECFM=FB000009 //* !:29936 !:29937 !:20097 !:20112 !:20053 !:20054000010 //DD2 DD DSN=PRV1.SMS.PC28002B,000011 // DATACLAS=SRCFLIB,000012 // LRECL=80,RECFM=FB000013 //* !:29936 !:29937 !:20097 !:20112 !:20053 !:20054000014 #JEND000014 #JO,SCHID=002....

Invoking the JOB/SCAN CA-7 interface with the JCA Edit macro

3. Input member or JOB name, schedule ID and simulation date and time into the fields.

ASG-JOB/SCAN -------------- CA-7 SCHEDULE CRITERIA --------------------COMMAND ===>

SPECIFY SCHEDULE SIMULATION INFORMATION

MEMBER/JOB NAME ===> TESTSCHEDULE ID ===> 001

SIMULATION DATE ===> 12/07/05 (MM/DD/YY)SIMULATION TIME ===> 11:13 (HH:MM)

_ To suppress this panel in the future.

REVIEW VALUES AND PRESS ENTER TO CONTINUE OR END TO RETURN.

Specifying parameters for the JOB/SCAN CA-7 interface

Field Description

MEMBER/JOB NAME The name of the Job. The default value is themember name in Edit or View.

SCHEDULE ID A valid three-digit schedule ID; 001 is the default.

SIMULATIONDATE A valid date. Current date is the default.

SIMULATION TIME A valid time. Current time is the default.

Suppress Enter X to suppress the displaying of this panel. Use the RESET parameter with theJCA command to redisplay this panel.

10


4. Press Enter. JOB/SCAN displays the SJL report.

11

Using the JCA Edit Macro in ISPF Edit or View

Validating Jobs from ForegroundYou can use JOB/SCAN's foreground processing to validate jobs that use the CA-7 variables. This topic explains theprocedure to process jobs in foreground mode.

n Set Up to Use Foreground Validation

n Validating Members

Set Up to Use Foreground Validation


To set up JOB/SCAN to validate JCL from foreground

1. Set the Scheduler detail statement of the Run Options statement in JSOPT02 as shown in the below figure.

** JSOPT02 ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **** **** JSOPT02 OPTIONS MAY BE OVERRIDDEN BY CORRESPONDING OPTIONS **** CODED IN JSOPT03 OR JSOPTEM. **** **** NOTE!!! IF USING "&UID", "&PF", OR "&GRP" IN THE DATA SET NAMES **** OF THE DDNAMES "JLOPE" OR "JLJPWOE", THE FOLLOWING **** "RUN OPTIONS" SHOULD BE CODED ===> PRIOR <=== TO THE **** "FILE ALLOCATIONS STATEMENTS": **** RUN OPTIONS **** USER ID =USERID OVERRIDE SECURITY USERID **** GROUP ID=GROUPID OVERRIDE SECURITY GROUPID **** PREFIX =PREFIX OVERRIDE TSO PREFIX **** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ***...RUN OPTIONSSCHEDULER=(CA7,SCAN)PROGRAM PRODUCT INTERFACE=IDCAMSCATALOG ACCESS =YES,VTOC,PDSMEMACCESS CONTROL CARDS =YES,LIMIT=99SECURITY EXIT =SAF2...

Setting the Run Options for the CA-7 scheduler interface

2. Turn on scheduler processing:

a. Select JCL Validation panel command P.

12


---------------------- ASG-JOB/SCAN - JCL VALIDATION -----------------------COMMAND ===> P

F - Foreground execution mode P - Processing OptionsB - Batch execution mode E - Edit JCL memberS - Submit After Validation BR - Browse JCL member

Input Library ===> ASGUSR.JCL...

Turning on Scheduler Processing

b. Type Y in the Use SCHEDULER interfaces field.

--------------------- ASG-JOB/SCAN PROCESSING OPTIONS ------------------------COMMAND ===>

Use Error Table ===> N (Y/N)Condition Code Processing ===> N (Y/N)Catalog Access ===> Y (Y/N)VTOC Access ===> Y (Y/N)PDS Member Verification ===> Y (Y/N)Security Exit DSNAME Check ===> N (Y/N)Program Checking ===> Y (Y/N)Disable SMS Processing ===> N (Y/N)IDCAMS Processing ===> Y (Y/N)Use SCHEDULER interface ===> Y (Y/N)

...


c. Press PF3 (END) to return and enable scheduler interfaces.

Validating Members

To validate member in foreground

1. Set up JOB/SCAN according to Validating Members.

2. At the JCL Validation panel, use the F command.

--------------------- ASG-JOB/SCAN - JCL VALIDATION --------------------------COMMAND ===> F

F - Foreground execution mode P - Processing OptionsB - Batch execution mode E - Edit JCL memberS - Submit After Validation BR - Browse JCL member

Input Library ===> ASGUSR.JCLInput Type ===> J (J - JOB JCL, P - PROC, or L - Selection List)Library Type ===> PDS (PDS, PAN, LIB, LIB-3, or SEQ)Select Members ===> BR1*Exclude Members ===>

First Proclib ===>Proclib Type ===> (PDS, PAN, LIB, or LIB-3)

...


13

Validating Members

If you input more than one member name (with list, range, and/or masks) JOB/SCAN displays theCA-7 Schedule Criteria panel for each one.

3. Press Enter. JOB/SCAN displays the CA-7 Schedule Criteria panel.

4. Input member or JOB name, schedule ID and simulation date and time into the fields.

ASG-JOB/SCAN ---------- CA-7 SCHEDULE CRITERIA ------------------COMMAND ===>

SPECIFY SCHEDULE SIMULATION INFORMATION

MEMBER/JOB NAME ===> BR14JOBSCHEDULE ID ===> 001

SIMULATION DATE ===> 08/04/29 (YY/MM/DD)SIMULATION TIME ===> 17:49 (HH:MM)

_ Enter "X" to suppress this panel in the future.

Review values and press ENTER to continue or END to return.

Specifying parameters for the JOB/SCAN CA-7 interface

where:

Field Description

MEMBER/JOB NAMEThe name of the job. The default value is themember name from the Select Membersfield from the JCL Validation panel.

SCHEDULE ID A valid three-digit schedule ID; 001 is the default.

SIMULATIONDATE A valid date. Current date is the default.

SIMULATION TIME A valid time. Current time is the default.

Suppress Enter X to suppress the displaying of this panel.

Use the Reset parameter of the JCA command to redisplay this panel.

5. Press Enter. JOB/SCAN displays the SJL report.

14


Using CA7SCHD to Validate a CA-7 ScheduleBefore using any function in this documentation, ask your administrator to be sure to followinstallation and activation instructions in JOB/SCAN CA-7 Interface Setup.

The batch job CA7SCHD:

l Retrieves a list of jobs from CA-7 based on your forecast parameters.

l Extracts the JCL and prepares it for validation.

l Executes JOB/SCAN to validate the jobs in run-time order.

To set up the batch job modify these statements in the CA7SCHD member in the SJJSSAMP library

1. JOB card. Modify according to local preferences and requirements.

2. CA-7 generic user ID. This might be optional; consult with local System Administrator.

3. CA-7 password for the ID. If the generic user ID is optional, so is this password.

4. SASSBSTR parameter.

5. Dataset name of the JOB/SCAN SJJSCLST library.

6. The unit name for new datasets.

7. The release number for CA7. If the number is less than 11 JOB/SCAN expects the CA-7 release 10 format forthe FJOB report; otherwise, it expects release 11 format.

8. Actual dataset name for the CA-7 Command file.

9. Alternate CA-7 Command file. If this DD is used, then enter NULLFILE in step 8.

10. CA-7 batch input files; use NULLFILE if pooling is used.

11. CA-7 batch output files; use NULLFILE if pooling is used.

12. Provide the location of the JS6PROC (if it is not in an accessible PROCLIB) by uncommenting this statementand put the dataset namewhere the JS6PROC is a member.

13. Modify or add forecast parameters to define the jobs you want to have validated.

14. (Optional) To provide the location of the CA-7 LOAD library, uncomment this statement and replace CA7LOAD LIBRARYwith the actual dataset name of the library.

15. Replace the@with a digit from 1-9 in the DD name only if line 8 contains a dataset name for the batch inputfile.

16. Replace the@with a digit from 1-9 in the DD name only if line 9 contains a dataset name for the batchoutput file.

15

Using CA7SCHD to Validate a CA-7 Schedule

1. //CA7SCHD JOB (ACCT),'PROGRAMMER NAME'//*********************************************************************//* SYSID=//* INTERFACE TO CA-7 SCHEDULER & CA-DRIVER//* REF: SJJSSAMP(CA7SCHD)//*//* NOTE: MODIFY JOB STATEMENT AND ITEMS INDICATED BY ARROWS <==//*********************************************************************

2. // SET ID= <== GENERIC USER3. // SET PASSWORD= <== PASSWORD

// SET CA7PGM='CAL2X2WB' <== USE CAL2X2WB ! SASSBSTR4. // SET PARM= <== PARM FOR CA7PGM5. // SET EXECLIB ASGJJS.ASGJSXXX.SJJSCLST <== ASG-JOB/SCAN CLIST LIB6. // SET SYSDA=SYSDA <== VALID UNIT7. // SET CA7REL=11 <== CA-7 RELEASE LEVEL

//* THE FOLLOWING SET STATMENTS MAY BE REQUIRED WHEN CA7PGM='SASSBSTR'8. // SET CA7CMDS=NULLFILE <== CA-7 COMMAND FILE9. // SET UCC7CMDS=NULLFILE <== ALTERNATE CA-7 CMD10. // SET BATCHIN=NULLFILE <== CA-7 BATCH INPUT FILE11. // SET BATCHOUT=NULLFILE <== CA-7 BATCH OUTPUT FILE

//*//* <== FOR JS6PROC

12. //*PROCLIB JCLLIB ORDER=ASGJJS.ASGJSXXX.SJJSSAMP <== (UNCOMMENT)//*//***** WRITE CA-7 FJOB CONTROL STATEMENT TO A TEMPORARY DATA SET//*//SAVECTL EXEC PGM=IRXJCL,PARM='J00CCTL &ID &PASSWORD'//*-----------------------------------------------------------------*//* MODIFY THE FOLLOWING FJOB STATEMENT TO DEFINE THE SCHEDULE *//* TO BE VALIDATED BY ASG-JOB/SCAN. <==MODIFY THE FOLLOWING FJOB *//* STATEMENT OR ADD STATEMENTS AS REQUIRED: *//CCTLIN DD *

13. FJOB,SYS=GG,FROM=(MMDDYY,HHMM),TO=(MMDDYY,HHMM)//*------¬¬----- ¬¬¬¬¬¬ ¬¬¬¬ ¬¬¬¬¬¬ ¬¬¬¬ <== MODIFY PREVIOUS-*//CCTLOUT DD DSN=&&CCTL,DISP=(,PASS),// SPACE=(TRK,(1,1)),UNIT=&SYSDA,// DCB=(RECFM=FB,LRECL=80,BLKSIZE=800)//SYSEXEC DD DSN=&EXECLIB,DISP=SHR//SYSTSPRT DD SYSOUT=*//*//BATCHCA7 PROC SYSDA=&SYSDA//CA7PGM EXEC PGM=&CA7PGM,PARM='&PARM'

14. //*STEPLIB DD DSN=CA7 LOAD LIBRARY,DISP=SHR <== CA7 LOAD(UNCOMMENT)//CA7CMDS DD DSN=&CA7CMDS,DISP=SHR CA-7 CMD FILE//UCC7CMDS DD DSN=&UCC7CMDS,DISP=SHR CA-7 CMD FILE

15. //BTERM0@I DD DSN=&BATCHIN,DISP=SHR <== CA-7 BATCH INPUT FILE16. //BTERM0@O DD DSN=&BATCHOUT,DISP=SHR <== CA-7 BATCH OUTPUT FILE

Modifying the CA7SCHD member for processing a CA-7 schedule

17. Save and run the batch job by the usual means of submitting batch validation jobs at your site.

18. Use your site's usual method of printing or saving output for batch jobs (for example, the SDSF outputqueue) to review the results of the JOB/SCAN validation.

16


Using JSCA7 to Validate a JOBThe batch job JSCA7 performs these tasks:

l Retrieves a job from the specified JCL Library.

l Interfaces with CA-7 to resolve statements.

l Executes JOB/SCAN to validate.

Do the following to validate a JOB using JSCA7:

n Set up the Batch Job for a SingleMember

n Run the Batch JOBs

Set up the Batch Job for a Single Member


Modify these statements in the JSCA7member in the SJJSSAMP library:

1. JOB card. Modify according to local preferences.

2. CA-7 JCL library dataset name. Replace the XXXX.XXXX.XXXX with the actual dataset defined in JOB/SCANCA-7 Interface Setup.

3. Dataset name for the CA-7 Command file. Replace XXXX.XXXX with the actual dataset name.

4. Alternate CA-7 command file. Replace NULLFILE with the actual dataset name, and place NULLFILE in thedataset name in step 3.

5. CA-7 batch input file. Use NULLFILE if pooling is used. See JOB/SCAN CA-7 Interface Setup.

6. CA-7 batch output file. Use NULLFILE if pooling is used. See JOB/SCAN CA-7 Interface Setup.

7. The unit name for new datasets.

8. (Optional) The location of the JS6PROC (if not in an accessible PROCLIB). ReplaceASGJJS.ASGJSXXX.SJJSSSAMP with the actual dataset name and uncomment the statement.

9. Replace the@with a digit from 1-9 in the DD name only if line 5 contains a dataset name for the batch inputfile.

10. Replace the@with a digit from 1-9 in the DD name only if line 6 contains a dataset name for the batchoutput file.

11. CA-7 parameters. Use the comments in the next several lines as a guide to providing parameters to CA-7.

l A valid schedule ID.

l A valid JOB name.

l A valid date.

17

Using JSCA7 to Validate a JOB

l A valid time.

For example:CA7 SCHID(101) -

SJOB(MYJOB) -SDATE(080501) -STIME(2153)

12. JOB/SCAN parameters. Place the dataset name, member, dataset type.

Run the Batch JOBsUse the usual means of submitting batch validation jobs at your site.

Use your site's usual method of printing or saving output for batch jobs (for example, the SDSF output queue) to reviewthe results of the JOB/SCAN validation.

18


1. //JSCA7 JOB (ACCT),'PROGRAMMER NAME'//*********************************************************************//* EXECUTE JOB/SCAN (MVS SYSTEMS) WITH CA-7 BATCH PROCESSING//* REF: SJJSSAMP(JSCA7)//*//* NOTE: MODIFY JOB STATEMENT AND ITEMS INDICATED BY ARROWS <==//** REXX EXEC J00CAVAL SHOULD BE MODIFIED BEFORE RUNNING THIS JOB **//*********************************************************************

2. // SET CA7LIB=XXXX.XXXX.XXXX <== CA-7 JCL LIBRARY NAME3. // SET CA7CMDS=XXXX.XXXX.COMMAND <== CA-7 COMMAND FILE4. // SET UCC7CMDS=NULLFILE <== ALTERNATE CA-7 CMD5. // SET BATCHIN=NULLFILE <== CA-7 BATCH INPUT FILE6. // SET BATCHOUT=NULLFILE <== CA-7 BATCH OUTPUT FILE7. // SET SYSDA=SYSDA <== VALID UNIT8. //*PROCLIB JCLLIB ORDER=ASGJJS.ASGJSXXX.SJJSSAMP <== (UNCOMMENT)

//*//JSSTEP1 EXEC JS6PROC,PRM=S//JLRCL DD DISP=SHR,DSN=ASGJJS.ASGJSXXX..SJJSPARM(&OPT01)// DD DISP=SHR,DSN=ASGJJS.ASGJSXXX..SJJSPARM(&OPT02)// DD DISP=SHR,DSN=ASGJJS.ASGJSXXX..SJJSPARM(&OPT0N)// DD DDNAME=SELIN ** CANNOT USE SYSIN HERE **//SYSEXEC DD DISP=SHR,DSN=ASGJJS.ASGJSXXX..SJJSCLST FOR REXX EXEC'S//JLSCHO DD SYSOUT=* TO DISPLAY THE JLSCH CA7 STATEMENT//JLSCHR DD DISP=(,PASS),SPACE=(TRK,(1,10)),UNIT=&SYSDA FOR JOB/SCAN//SYSTSPRT DD SYSOUT=* FOR REXX ERROR & DEBUG MESSAGES//SYSOUT DD SYSOUT=* FOR MESSAGES FROM SASSBSTR//ERRORS DD SYSOUT=* FOR ERRORS FROM SASSBSTR//SYSPRINT DD DISP=(,PASS),SPACE=(TRK,(1,10)),UNIT=&SYSDA FOR SASSBSTR//SYSIN DD DISP=(,PASS),SPACE=(TRK,(1,10)),UNIT=&SYSDA FOR SASSBSTR//JLCA7LB DD DISP=SHR,DSN=&CA7LIB CA-7 LIBRARY FOR ASG//CA7CMDS DD DISP=SHR,DSN=&CA7CMDS CA-7 CMD FILE FOR SASSBSTR//UCC7CMDS DD DISP=SHR,DSN=&UCC7CMDS ALT. CA-7 CMD FILE FOR SASSBSTR

9. //BTERM0@I DD DISP=SHR,DSN=&BATCHIN <== CA-7 BATCH INPUT FILE10. //BTERM0@O DD DISP=SHR,DSN=&BATCHOUT <== CA-7 BATCH OUTPUT FILE

//JLSCH DD *11. CA7 SCHID(XXX)

//* MODIFY THE PRECEDING LINE <== CA-7 PARAMETERS//* USE THE FOLLOWING ON CA7 STMT: THE VALUE MUST BE WITHIN ().//* *** ALL PARAMETERS EXCEPT CA7 ARE OPTIONAL ***//* SCHID- 1 TO 3 BYTES LONG. DEFAULT - 001//* SJOB - 1 TO 8 BYTES LONG. DEFAULT - VALIDATION MEMBER NAME//* SDATE- 6 BYTES FORMAT YYMMDD. DEFAULT - CURRENT DATE//* STIME- 4 BYTES FORMAT HHMM. DEFAULT - CURRENT TIME//*//SELIN DD * *** THIS IS NORMALLY SYSIN ***

12. INPUT SELECTIONDSN=YOUR.JCLLIB <== INPUT JCL LIBRARYSELECT=YOURJOB <== MEMBER TO SCANSOURCE TYPE=PDS <== TYPE OF INPUT LIB

REPORT OPTIONSOPTIONS IN EFFECT =PRINT <== PRINT OPE REPORT?STRUCTURED JCL LISTING=PRINT <== PRINT SJL REPORT?

RUN OPTIONSSCHEDULER=(CA7,SCAN)

Modifying the JSCA7 member for processing one JCL member at a time

19

Run the Batch JOBs

JOB/SCAN CA-7 Interface SetupThis topic describes about the installation of the interface and it consist of following topic:

n Create a CA-7Working Library

n Set Site-Specific Values

n Setting up Pooling (Optional)

Create a CA-7 Working LibraryCreate a CA-7 JCL library where the JCA Edit macro, foreground panels, and the batch jobs may write records prior to theLJCK request to resolve CA-7 # control statements and CA-Driver procedures. Use either of two methods to make thislibrary available to CA-7; both require a dataset name and an INDEX value compliant with CA-7 rules. The same datasetname and INDEX are required in Create a CA-7Working Library and in batch job JCL in Using CA7SCHD to Validate a CA-7Schedule and in Using JSCA7 to Validate a JOB.

Method 1: To define the library immediately and temporarily to CA-7, use the CA-7 JCL command to define the librarydynamically. Consult the CA-7 documentation for details about this command. If the CA-7 started task is restarted for anyreason, reissue this command.

Method 2: Defines the library permanently to CA-7.

To define library permanently

1. Add the following to the CA-7 INIT deck as a valid JCL library:

JCL,DSN=XXXX.XXXX.XXXX,INDEX=YYY,DYN=2

2. Substitute a dataset name and INDEX for XXXX.XXXX.XXXX and YYY respectively.

3. Restart the CA-7 started task with the new INIT deck.

Set Site-Specific Values

To set required values for your site, modify member J00CAVAR in the SJJSCLST library

1. Replace ASGJJS.ASGJSXXXwith the name of the JOB/SCAN product high-level qualifier.

2. Set the LIBDEF switch for the JCA Edit macro. Use YES to automatically allocate ISPLLIB, ISPPLIB, andISPMLIB using LIBDEF. Use NO to require that each TSO/ISPF session preallocate these libraries before usingthe JCA Edit macro.

3. Insert CA-7 generic user ID. This might be optional; consult with local System Administrator.

4. Insert CA-7 password for the ID. If the generic user ID is optional, so is this password.

5. Replace xxxx.xxxx.xxxxwith the dataset name of the working library created in JOB/SCAN CA-7 InterfaceSetup.

6. Replace yyywith the INDEX of the working library created in JOB/SCAN CA-7 Interface Setup.

20


7. Enter the name of the CA7 program based on the interface you use: for CAICCI, use CAL2X2WB; for the CA7Batch Terminal interface, use SASSBSTR.

8. Enter the SASSBSTR parameters.

9. Replace VVVVVVVwith the volume name for newwork files.

10. Enter the actual dataset name for the CA-7 Command file.

11. Replace CA7CMDSwith the DD name of the CA-7 Command file.

12. If the BTI DD is used, replace the@with a digit from 1-9 in the quoted DD name:BTERM0@I = 'BTERM0@I'

13. Insert the name of the BTI dataset.

14. If the BTO DD is used, replace the@with a digit from 1-9 in the quoted DD name:BTERM0@O = 'BTERM0@O'

15. Insert the name of the BTO dataset.

/*************** REXX for CA-7 JCL validation ***************//* Member J00CAVAR *//* ASG-JOB/SCAN CA-7 JCL Validation - define variables *//************************************************************//* TRACE RESULTS *//************************************************************//*** MANUALLY SET THE FOLLOWING VALUES ***//************************************************************/

1. djsname = 'ASGJJS.ASGJSXXX' /* ASG-JOB/SCAN HIGH LEVEL *//* QUALIFIER */

2. libdef = 'YES' /* USE LIBDEF IN JCA PROCESSING */3. ca7id = '' /* GENERIC CA-7 USER ID */4. ca7pd = '' /* PASSWORD FOR CA-7 USER ID */5. ca7lib = 'XXXX.XXXX.XXXX' /* CA-7 JCL LIBRARY NAME */6. index = 'YYY' /* CA-7 JCL LIBRARY INDEX */7. ca7pgm = 'CAL2X2WB' /* USING THIS CA-7 PROGRAM */

/* SPECIFY CAL2X2WB OR SASSBSTR */8. parm = '' /* PARAMETER PASSED TO ca7pgm */9. vol_space = 'VOLUME(VVVVVV) SPACE(3,3) CYL' /*new work files*/

/* *//* The following may be required when ca7pgm = 'SASSBSTR' *//* */

10. command = 'NULLFILE' /* CA-7 COMMANDS DATA SET NAME */11. ucc7cmds = 'CA7CMDS' /* DDNAME FOR CA-7 COMMANDS DD */12. BTERM0@I = 'BTERM0@I' /*DD NAME - BATCH TERMINAL INPUT */13. BTIDSN = 'NULLFILE' /* DATA SET NAME for BTI */14. BTERM0@O = 'BTERM0@O' /*DD NAME - BATCH TERMINAL OUTPT */15. BTODSN = 'NULLFILE' /* DATA SET NAME for BTO */

Setting up the JCA Edit Macro

Setting up Pooling (Optional)ASG recommends using pooling so that the Edit macro and batch jobs can use the next available batch terminal datasetsin the pool. With pooling disabled, specific batch terminal datasets will have to be hardcoded.

The default name of the procedure is CA7BTI (see the below figure for a sample of this PROC). Consult CA-7 and CA-7Driver product documentation for the location, use and possible modification of job to establish pooling.

21

Setting up Pooling (Optional)

//CA7BTI PROC ID=0,POOL='1-8',DSNPFX=,OPT=,PG=SASSBSTR//BTERM EXEC PGM=&PG,// PARM='&ID,POOL=(&POOL),DSNPFX=&DSNPFX,&OPT'//STEPLIB DD DISP=SHR,DSN=cai.ca7.loadlib//UCC7CMDS DD DISP=SHR,DSN=cai.ca7.commds//SYSPRINT DD SYSOUT=*,DCB=BLKSIZE=133//ERRORS DD SYSOUT=*,DCB=BLKSIZE=133//SYSUDUMP DD SYSOUT=*

CA-7 Batch Terminal Interface JCL Procedure (CA7BTI)

22


asg-job/scan ca-7 for z/os scheduler interface user guide 8

Documents