This chapter describes how to use the JCL Conversion facility for CA Roscoe.
The JCL Conversion facility lets you convert JCL to CA Roscoe RPF format so that CA Roscoe can execute it. Use this facility to convert the JCL that performs the allocations required by programs you are testing in foreground with your product.
This section contains the following topics:
Access the JCL Conversion Facility
Specify the JCL Member for Conversion
Review and Edit the Converted JCL
To enter the JCL Conversion facility, enter the following command on the command line:
[xxx.]IBCONV
where xxx is the prefix of the library in which the product is installed. Omit this prefix if the application is installed in a common execution library.
The application displays the JCL Converter panel.
The JCL Converter panel lets you specify the JCL member for conversion:
----------------------- CA InterTest™ Batch JCL Converter ---------------------- Option ===> Select an Option and press ENTER A ‑ AWS.... L ‑ LIB.... D ‑ DSN.... USER01.LIB.CNTL(TEST*) J ‑ JOB...: X ‑ Exit JCL Conversion PROCLIBs: Proclib1... USER01.PROCLIB Proclib2... SYS2.PROCLIB Proclib3... Proclib4... Proclib5... Proclib6... Proclib7...
JCL members are stored in one of the following areas:
|
AWS |
CA Roscoe active working storage |
|
LIB |
CA Roscoe user library |
|
DSN |
Data set (PDS, sequential or CA Librarian) |
|
JOB |
The currently attached job. You cannot change this jobname. |
The information specified in these fields reflects your profile. If you change this information, for example if you change the DSN, application updates your profile, which is stored in your library in member ZZIBOPTS. Follow standard CA Roscoe conventions for specifying the AWS, Library or DSN.
In addition to specifying where the JCL member is stored, you must specify at least one PROCLIB. Each PROCLIB identifies a library where JCL procedures are stored. Even if the JCL member does not use a procedure, one PROCLIB must be specified on the JCL Conversion panel.
To display the JCL member
Result: If you entered a complete AWS, library or DSN name, CA Roscoe displays the JCL member you selected. If you entered a partial name or left the name blank, CA Roscoe prompts you for additional information. See Selecting the JCL Member from a List, which follows, for instructions on specifying that information.
If you selected J (job), CA Roscoe displays file 2 (the JCL file) of the currently attached job.
If you do not specify a complete AWS, library or DSN name on the JCL Converter panel, CA Roscoe prompts you for additional information.
For AWS, CA Roscoe displays a list of members. Enter a to the left of the desired AWS and press Enter to attach and display the member.
For a library:
When CA Roscoe displays the member list, enter a to the left of the library JCL member and press Enter to attach and display a member.
For a DSN:
When CA Roscoe displays the member list, enter a to the left of the data set JCL member and press Enter to attach and display a member.
When the application displays the JCL member you specified on the JCL Converter panel or selected from a list, you can review the member to make sure it is the one you want to convert.
To convert the member
Result: the application converts the JCL member to CA Roscoe RPF format and displays the following message:
RPF generated in AWS xxxx
Where xxxx is the current AWS.
After the JCL member has been converted, enter a to attach and display the converted JCL member.
You can review and, if desired, edit the converted JCL to delete unnecessary steps. Note the following:
Use standard CA Roscoe editing commands to edit the converted JCL. When you finish editing the member, save it in your own CA Roscoe library.
After the JCL member has been saved in your CA Roscoe library, you can execute the converted JCL member at any time to perform the allocations. Before executing a program that you want to test with the application, execute the appropriate RPF member to allocate the files required by the program.
A utility exists, CAMRAUTL, which takes a given JCL member of a PDS and creates an ALIB member from it. Review JCL member CAMRAUTL in CAIPROC. There are three required DDs, shown in the following table:
|
DDname |
Description |
|---|---|
|
JCL |
DD pointing to the JCL member to be used in creating the ALIB. |
|
ALIB |
DD pointing to the ALIB PDS. |
|
SYSPROC |
DD pointing to the PROCLIB concatenation. |
JCL example:
// JOB //******************************************************************** //CRE8ALIB EXEC PGM=CAMRAUTL //STEPLIB DD DISP=SHR,DSN=CAI.CAILIB //SYSPROC DD DISP=SHR,DSN=USER.JCL //JCL DD DISP=SHR,DSN=USER.JCL(TESTJCL) //ALIB DD DISP=SHR,DSN=USER.ALIB //
|
Copyright © 2013 CA.
All rights reserved.
|
|