Allocations Facility for ISPF

Before you can begin a debugging session, you must allocate the data sets that your program will be using. The allocations facility for TSO/ISPF users provides a number of features that makes this set‑up process easier.

Briefly, the allocations facility lets you to do the following actions:

Create and manage ALIB (Allocations Library) allocations members. ALIB is the internal allocations format for CA InterTest™ Batch. The ALIB is a PDS that consists of members created through the ALIB editor or JCL converter of CA InterTest™ Batch.
You can create new allocations library members, or edit, browse, allocate and free data sets specified in existing members. Once you save an ALIB, you can use its allocations in the future, saving you valuable debugging set‑up time.
Note: The ALIB dataset is optional and is used by the CA InterTest™ Batch foreground testing facility. For more information, see the section Allocate ALIBs (Optional) in the Installation Guide.
Convert allocation lists from ALIB to CLIST format. Although ALIB is an efficient format that is sufficient for most situations, conversion to CLIST is useful in complex allocation situations that are beyond the straightforward free‑and‑allocate capabilities of ALIB (conditional data set allocations, for example). Converting to CLIST may also be necessary if your particular operating environment requires the CLIST format.
Browse existing JCL members in PDS, CA Librarian, and CA Panvalet libraries.
Convert JCL to ALIB format. This feature is useful if you have existing JCL that you would like to use for your allocations. The system's conversion utility fully supports JCL allocation features, and converted JCL is displayed in Edit mode for further processing. You can also use the resulting ALIB on the Execution Control panel to allocate and free the required application DDs. You can convert JCL to CLIST format by first converting it to ALIB format, then converting it from ALIB to CLIST (it is not necessary to save in ALIB format). Using this feature saves you the time needed to key in and debug ALIB or CLIST statements from scratch.

The allocations facility panels conform to ISPF file name and command conventions (for example, the ISPF Locate command).

Note: For more information on how to use the JCL conversion facility, CA Roscoe users should see the chapter "JCL Conversion for CA Roscoe."

This section contains the following topics:

The Allocations Main Menu

Option 1: ALIB (Allocations Library) Functions

Option 2: The JCL Library/Allocations Functions

Option 3: Current Allocations

Option 4: JCL Conversion/Allocation Options

The Allocations Main Menu

Access the Allocations Main Menu by selecting option 3 from the Primary Option Menu. The Allocations Main Menu shown next is the starting point for accessing all of the allocations facility's features:

------------------ CA InterTest™ Batch Allocations Main Menu ------------------ Option ===> 1 ALIB - Process Allocation Library members 2 JCL - Browse and Convert JCL 3 CURRENT - Display and free current allocations 4 OPTIONS - Display and modify options

The fields on the Allocations Main Menu are as follows:

1 ALIB	Create new allocations members, edit and browse existing members, allocate/free data sets specified in members, and convert ALIB members into CLIST format.
2 JCL	Browse existing JCL members in PDS, CA Librarian, or CA Panvalet libraries. You can also select members for conversion from JCL to ALIB format. The converted JCL is displayed in Edit mode for further processing.
3 CURRENT	Display current session allocations and free, browse, or edit allocated data sets.
4 OPTIONS	Specify various JCL conversion options and ALIB member export options, and identify procedure libraries (proclibs) used for expanding JCL procedures found during JCL conversion.

Option 1: ALIB (Allocations Library) Functions

The ALIB library option lets you create new allocations members, edit and browse existing members, allocate/free data sets specified in members, export (convert) ALIB members to CLIST format, and import (convert) JCL members to ALIB format. Selecting this option displays the Allocations Library panel.

Select an ALIB Member from the Allocations Library Panel

The application displays the Allocations Library panel if you select option 1 (ALIB) from the Allocations Main Menu. Use this panel to enter the name of the member you want to edit.

-------------------- CA InterTest™ Batch Allocation Library ---------------------
Command ===> 

Specify Allocation Library (ALIB) name below: 

ISPF library: 
     Project ===> USER1 
     Group   ===> INTBATCH 
     Type    ===> ALIB 
     Member  ===>               (Member name, blank, or pattern) 

Other partitioned data set: 
   Data set name ===> 
   Volume serial ===>          (If not cataloged)

For ISPF library members:The Allocation Library panel has the following input fields:

For ISPF library members:


Project, Group, Type	Required. Enter the three‑level qualifier for standard data set names in ISPF.
Member	Optional. If you do not know the member name, leave this field blank or enter a member name pattern. Valid ISPF wild card member pattern characters are:
	%	Substitutes for any one character. May be the first character.
	*	Substitutes for any number of characters. May not be the first character.

For PDS members:

Data set name	Optional. If your member is not in an ISPF library, enter the actual, cataloged name of the file. The name can be up to 44 characters long, with segments up to eight characters long, separated by periods. You can specify any MVS data set name and use wild card substitutions, as described for the Member field.
Volume serial	Optional. This field identifies the VOLSER of the data set specified in the data set name field and is necessary only when a file is not cataloged.

To select an ALIB Member from the Allocations Library panel:

Enter the ISPF library or PDS information for the member you want to edit.
Press Enter.

If you entered a complete member name, the application displays the Allocations Edit panel. If you entered a partial member name, the application displays the ALIB Member Selection List.

Select an ALIB Member from the ALIB Member Selection List

If you did not specify a complete member name on the Allocations Library panel, the application displays the ALIB Member Selection List panel. This panel lists all the allocations library members or those that match the pattern.

CA InterTest™ Batch ALIB: USER1.INTBATCH.ALIB -------------------------------- Command ===> Scroll ==> PAGE Cmd Name Message VV.MM Created Modified______ Size Init Mods ID NEW 01.02 93.060 93.077 12:47 00090 00090 00000 USER1 PGM1 01.08 92.351 93.077 12:33 00001 00001 00000 USER1 PGM2 01.01 93.077 93.077 14:09 00013 00013 00000 USER1 PGM3 01.08 93.062 93.077 10:27 00002 00002 00000 USER1 TEST1 01.01 93.077 93.077 14:10 00002 00002 00000 USER1 TEST2 01.02 93.078 93.078 10:11 00001 00021 00000 USER1

Enter the following line commands in the Cmd field before each member in the list:

AL	To allocate all the data sets in the ALIB member.
B	To browse the ALIB members. The Allocation List Browse panel displays. From this panel you may view the allocation list in an ALIB. You can scroll through the members and use the ISPF Locate (L) command to locate specific members. The Allocation List Browse panel is identical in format to the Allocations Edit panel, but no edits may be made.
C	To display the Convert to CLIST panel, which lets you convert the selected ALIB member to CLIST format. For more information, see Converting ALIB to CLIST (Exporting ALIB).
E/S	To edit the ALIB member. Issuing this command displays the Allocations Edit panel. For more information, see Editing ALIB Allocations.
F	To free all the ddnames in the ALIB member.

Edit ALIB Allocations

Display the Allocations Edit panel in any one of the following ways:

From the Allocations Library panel by specifying a particular member
From the ALIB Member Selection List panel by entering the line commands E or S next to a member
From the JCL Allocations Step Selection List panel by selecting converted JCL steps for allocation

The Allocations Edit panel lets you create, modify, and manipulate lists of data set allocations. A list may be saved into the ALIB, exported (converted) into a CLIST library, allocated, or freed. JCL may be imported (converted) into ALIB format.

A sample Allocations Edit Panel is shown next:

CA InterTest™ Batch ALIB EDIT: PDS USER1.INTBATCH.ALIB(PGM1) -------------------
COMMAND ===>                                                    SCROLL==> PAGE
LINE COMMANDS - I(NNN), D(NNN), R(NNN), AL(LOCATE), F(REE), S(PACE)            
PRIMARY COMMANDS - ALLOCATE, SAVE, CREATE, RESET, CANCEL, IMPORT, EXPORT,      
 REPLACE, FREE, OPTS, END.  FOR AN EXPLANATION, SEE THE USER GUIDE OR HIT HELP.
CMD  DDNAME   DATA SET NAME                                DISP VOLSER   DCB AL
MSG> Imported from USER1.JCL(PGM1)                                       
MSG> USER1   //USER1R   JOB (42400000),'USER1',CLASS=A,M                      
MSG> RUN     //RUN      EXEC PGM=MAINCOB,REGION=4M,PARM='            RUN       
MSG> ..  MAINCOB                                                               
.... @STEPLIB USER1.LOAD                                   SHR            N    
.... SYSPRINT SYSOUT=X                                     NEW            N    
.... SYSABOUT SYSOUT=X                                     NEW            N    
.... SYSOUT   SYSOUT=X                                     NEW            N   A
.... SYSUDUMP SYSOUT=X                                     NEW            N    
.... CARDIN   USER1.CARDIN.FILE                            NEW            Y    
.... CARDOUT  USER1.SYSOUT                                 SHR            N

Allocations Edit Panel fields are described next:

CMD	Enter all line commands in this area.
DDName	Data definition name. Enter a valid ddname in this field.
Data Set Name	Data set name. Enter a valid data set name in this field. Data set names must be fully qualified and without apostrophes. SYSOUT= and TERMINAL are valid entries.
Disp	The disposition of the data set. Enter the disposition of the data set in this field. Valid dispositions are: OLD SHR NEW Default: SHR.
Volser	The old volume serial, if any, of the data set. You may enter another volume serial on which the data set is to reside.
DCB	Yes DCB information is present No There is no DCB information for the data set
AL	A The ddname is allocated blank The ddname is not allocated.

Primary Commands

The Allocations Edit Panel primary commands, which you enter on the COMMAND ===> line, are shown next.

ALLOCate	Allocates all the allocations listed on the screen. Note: If the ddname is currently allocated and if you use the product to reallocate this DD, the existing allocation is not preserved. Do not override ddnames that other applications may be relying on.
SAVE	Saves any changes made to the list of allocations in the current ALIB member.
CREate	Writes the list of allocations to a new ALIB member. Issuing this command displays the Copy to Allocation Library panel.
RESet	Removes all non-relevant MSG lines created during JCL conversion or during allocation.
CANcel	Exits without saving any changes and redisplays the Member Selection List panel from which you entered the editor. All changes to the member that were not saved are discarded.
IMPort	Invokes the JCL Converter to convert raw JCL into ALIB format. Import JCL from a PDS, CA Librarian, CA Panvalet, and current session allocations libraries. The application displays the JCL Import Specifications panel. For more information, see Converting JCL to ALIB (Importing JCL).
EXPort	Converts the current ALIB member into CLIST format. For more information, see Converting ALIB to CLIST (Exporting ALIB).
REPlace	Replaces a member with the contents of the current member. Issuing this command displays the Copy to Allocation Library panel.
END	Ends the current Edit session and displays the Member Selection List panel from which you entered the editor. The member is automatically saved if it was modified.
FREE	Frees all ddnames in the current member.
OPTS	Lets you change conversion and allocation options. Invoking this command displays the JCL Conversion/Allocation Options panel. For more information, see Option 4: JCL Conversion/Allocation Options.

Line Commands

Enter line commands in the Cmd field next to the ddname:

Innn	Inserts one or more blank edit lines. nnn is the number of lines to insert. The default is 1 and the maximum is 999. Any blank edit line with no data on it is deleted the next time you press Enter. Example: I3 Inserts 3 blank lines.
Dnnn	Deletes one or more edit lines. nnn is the number of lines to delete. The default is 1 and the maximum is 999. Example: D Deletes this line.
Rnnn	Repeats (duplicates) the line nnn times. The default is 1 and the maximum is 999. Example: R99 Duplicates this line 99 times.
AL	Allocates the data set. If the allocation succeeds, an A appears in the AL field. If the allocation fails, one or more messages will be inserted after the line. Example: AL Allocates this data set. Note: If the ddname is currently allocated and if you use the product to reallocate this DD, the existing allocation is not preserved. Do not override ddnames that other applications may be relying on.
C	Changes the current line to a comment. Note: Once a DD is converted to a comment, it can no longer be edited.
F	Frees (deallocates) the data set specified in the line. Upon deallocation, the A in the AL field disappears. Example: F Frees this data set.
S	Displays the Data Set Attributes panel, which contains DCB and space information, and extended (SMS) attributes.

Dataset Attributes Panel

The Dataset Attributes panel lets you review and change the data set attributes including DCB information, space information, and extended (SMS) attributes. This panel displays when you select a ddname on the Allocations Edit panel.

-------------------- CA InterTest™ Batch Dataset Attributes --------------------
COMMAND ===>                                                                   
                                                                               
Attributes for dataset &T004                                                   
                                                                               
DCB Attributes:        Space Attributes:             Extended Attributes:      
 LRECL   ===> 0          SPACE UNIT  ===> BLK          DATACLAS ===>           
 BLKSIZE ===> 0          PRIMARY     ===> 0            STORCLAS ===>           
 RECFM   ===>            SECONDARY   ===> 0            MGMTCLAS ===>           
 DSORG   ===>            DIRECTORY   ===> 0            DSNTYPE  ===>           
                         RLSE        ===> N  (Y/N)     RECORG   ===>           
Other Attributes:                                      AVGREC   ===>    (U/K/M)
                                                       KEYOFF   ===> 0         
 UNIT    ===>                                          KEYLEN   ===> 0         
 VOLSER  ===>                                                                  
                                                                               
Or allocate like DSNAME or (DDNAME)                                            
===>                                                                           
                                                                               
                                                                               
ENTER END to save DCB information and return                                   
ENTER CANCEL to ignore this data and return

Dataset Attributes Panel: Fields

The following table describes the Dataset Attributes Panel fields:


LRECL	The logical record length of the data set.
BLKSIZE	The block size of the data set.
RECFM	The record format of the data set. Valid formats are:
	F	Fixed
	FB	Fixed blocked
	FBA	Fixed blocked with carriage control character
	V	Variable
	VB	Variable blocked
	U	Undefined
	Default: the current record format of the data set.
DSORG	The organization of the data set. Valid organizations are:
	PO	Partitioned Organization (PDS)
	PS	Sequential
SPACE UNIT	The space unit used by the data set for primary and secondary storage. Valid space units are:
	BLK	Blocks
	TRK	Tracks
	CYL	Cylinders
	Default: the current space unit of the data set.
PRIME SIZE	The primary storage.
SECONDARY	The secondary storage.
DIRECTORY BLOCKS	The number of directory blocks.
RELEASE	Whether unused storage should be released. Valid values are:
	Yes	Release unused storage
	No	Do not release unused storage
	Default: No
UNIT NAME	The unit name.
VOLUME SERIAL	If you entered a VOLSER on the Allocations Edit panel, it is displayed here. If this field is blank or you want to change the VOLSER, enter the new VOLSER.
OR ALLOCATE LIKE DDNAME OR DSNAME	Use this field to obtain DCB information from another data set or ddname. Enter a valid ddname in parentheses (for example,INT1LOAD), or a fully qualified data set name.
STORCLAS	The SMS storage class.
DATACLAS	The SMS data class.
MGMTCLAS	The SMS management class.
DSNTYPE	One of the following valid data set types: LIBRARY PDF PIPE HFS
RECORG	One of the following valid record organizations:
	KS	Keyed sequential file
	ES	Entry-sequenced file
	RR	Relative record file
	LS	Linear space file
AVGREC	Allocate space by records using one of these valid specifications:
	U	Unit is one record
	T	Unit is one thousand records
	M	Unit is one million records
KEYOFF	Identifies the offset within the record where the key resides, for keyed files only.
KEYLEN	Identifies the length of the key.

To change DCB information

Enter the DCB information in the appropriate fields.
Enter END on the command line and press Enter, or press the End key.

Result:

The application saves the DCB information and redisplays the Allocations Edit panel.

Note: Enter CANCEL to ignore the DCB information and to redisplay the Allocations Edit panel.

Copy to Allocation Library Panel

The application displays the Copy to Allocation Library panel whenever the ALIB editor needs the name of the ALIB data set and member in order to write the allocations list. The application displays this panel if you issue a Replace or Create command from the Allocations Edit panel.

---------------- CA InterTest™ Batch - Copy to Allocation Library --------------
Command ===>       
                                                                             
Specify Allocation Library (ALIB) and member:

ISPF library: 
         Project  ===>                                                        
         Group    ===>                                                     
         Type     ===>                                                    
         Member   ===>                                                   
                                                                              
Other partitioned data set:                                                   
    Data set name ===>                                                        
    Volume serial ===>        (If not cataloged)

Replace like-named member ===>       (Yes or No)

To specify the ALIB data set name

Note: Saving the ALIB data set is optional. If your installation is not using an ALIB data set no entry is required on this panel. Press PF3 several times until you return to the CA InterTest™ Batch PRIMARY OPTION MENU. For more information, see the section Allocate ALIBs (Optional) in the Installation Guide.

If the data set to which you are writing is an ISPF library, complete the information for the ISPF Library fields (Project, Group, Type, and Member). For more information on these fields, see Selecting an ALIB Member from the Allocations Library Panel.
If the data set to which you are writing is not an ISPF library, complete the information for the Other partitioned data set fields (Data set name, Volume serial). For more information on these fields, see Selecting an ALIB Member from the Allocations Library Panel.
Enter Yes in the Replace like‑named member field if you want the editor to overwrite members by the same name in the library (the default is No).
Press Enter.

Result:

The application creates or replaces the ALIB data set and redisplays the Allocations Edit panel.

Convert ALIB to CLIST (Export ALIB)

Access the Convert to CLIST Options panel in one of these ways:

From the ALIB Member Selection List panel by entering the line command C (Convert to CLIST) next to the member to convert.
From the Allocations Edit panel by entering the primary command EXP (Export) on the command line.

A sample Convert to CLIST Options panel follows:

--------------------- CA InterTest™ Batch Convert to CLIST ----------------------
Command ===> 

Specify "TO" dataset and options below, then press ENTER 

ISPF Library: 
     Project ===> USER1   
     Group   ===> INTBATCH 
     Type    ===> CLIST 
     Member  ===> PGM1 

Other partitioned data set: 
     Data set name ===> 
     Volume serial ===>               (If not cataloged) 

     Replace ?     ===> YES           (Yes or No) 

     Edit CLIST ?  ===> YES           (Yes or No)

If your allocation situation is too complex for the limitations of the ALIB format (for instance, if you need conditional allocations or need to use other TSO commands beyond simple free‑and‑allocate statements), you may find it useful to translate your ALIB statements to CLIST.

The ISPF library and Other partitioned data set fields, in which you specify your destination (TO) data set, are the same as those on the Allocations Library panel.

The other fields are as follows:


Replace ?	Determines if the target CLIST library is to be replaced.
	Yes	Replace the target CLIST library
	No	Do not overwrite the existing CLIST library. After you press Enter, the cursor is placed in the Data Set Name field and you can specify a new name
Edit CLIST ?	Determines if the ISPF editor will be invoked to edit the converted member.
	Yes	The ISPF editor will be invoked to edit the converted member
	No	The ISPF editor will not be invoked

To convert from ALIB to CLIST

Specify the destination (TO) data set in either the ISPF library or the Other partitioned data set fields. Modify the member name, if necessary.
Enter Yes or No in the Replace? and Edit CLIST? fields.
Press Enter.

Result:

The application performs the conversion. If you entered Yes in the Edit CLIST field, the application invokes the ISPF editor to allow you to further modify the CLIST. If you entered No in the Edit CLIST field, the application redisplays the panel from which the converter was invoked.

Convert JCL to ALIB (Import JCL)

The application displays the JCL Import Specifications panel when you use the Import command on the Allocations Edit Panel. Use this panel to enter the name and type of the JCL library member from which you want to import JCL for conversion.

------------------------ CA InterTest™ Batch Import JCL -------------------------
Option ===> 

        Blank   PDS 
            L   CA Librarian 
            P   CA Panvalet 
            S   Current session allocations 

Specify JCL library name and options below: 

ISPF Library: 
     Project ===> USER1   
     Group   ===> INTBATCH 
     Type    ===> JCL 
     Member  ===>              (Member name, blank, or pattern) 

Other data set: 
   Data set name ===> 
   Volume serial ===>          (If not cataloged) 

Options: 
   CA Librarian index type ===> Q        (Quick or Short)

The ISPF library and Other data set fields are the same as those on the Allocations Library panel. The other fields are as follows.


Option	The data set format of the data set you want to import for conversion.
	Blank	The member is in a PDS.
	L	The member is in a CA Librarian library.
	P	The member is in a CA Panvalet library.
	S	Import the currently allocated data set list (current session allocations). No other fields on this panel need to be completed if you choose this option.
CA Librarian index type	When converting CA Librarian members, determines the amount of directory information displayed.
	Q	Quick. Displays the member name only and takes less time than the S (Short) option.
	S	Short. Displays more information on the selected member than the Q (Quick) option.

To convert from JCL to ALIB

Enter the data set format of the JCL member you want to import for conversion.
In either the ISPF library or the other partitioned data set fields, specify the source (FROM) data set that contains the JCL you want to import for conversion.
Press Enter.

Result:

If you have requested the JCL Conversion/Allocations Options Panel, it will be displayed next. Otherwise, the JCL member selection panel is displayed.

Option 2: The JCL Library/Allocations Functions

Option 2 (JCL) on the Allocations Main Menu panel lets you select existing JCL members for conversion to ALIB format. PDS, CA Librarian, and CA Panvalet libraries are supported. Use the resulting ALIB member on the Execution Control Panel to allocate and free DDs.

Specify the JCL to Convert

The application displays the JCL Library panel when you select the JCL option from the Allocations Main Menu. Use this panel to specify the name and type of the JCL member you want to convert.

------------------------- CA InterTest™ Batch JCL Library ---------------------
Option ===> 

        Blank   PDS 
            L   CA Librarian 
            P   CA Panvalet 


Specify JCL library name and options below: 

ISPF Library: 
     Project ===> USER1   
     Group   ===> INTBATCH 
     Type    ===> JCL 
     Member  ===>              (Member name, blank, or pattern) 

Other data set: 
   Data set name ===> 
   Volume serial ===>          (If not cataloged) 

Options: 
   CA Librarian index type ===> Q        (Quick or Short)

Complete the following input fields:


Option	The format of the data set you want to import for conversion.
	Blank	The member is in a PDS.
	L	The member is in a CA Librarian library.
	P	The member is in a CA Panvalet library.

For ISPF Library members:


Project, Group, Type	Required. Enter the three‑level qualifier for standard data set names in ISPF
Member	Optional. If you do not know the member name, leave this field blank or enter a member name pattern. Valid ISPF wild card member pattern characters are:
	%	Substitutes for any one character. May be the first character.
	*	Substitutes for any number of characters. May not be the first character

For PDS members:


Data set name	Optional. If your member is not in an ISPF library, enter the actual, cataloged name of the file. The name can be up to 44 characters long, with segments up to eight characters long, separated by periods. You can specify any MVS data set name. You can use wild card substitutions, as described for the Member field.
Volume serial	Optional. This field identifies the VOLSER of the data set specified in the Data set name field and is necessary only when a file is not cataloged.
CA Librarian index type	Used only when converting CA Librarian files. Determines the amount of directory information the application displays.
	Q	Quick. Displays the member name only and takes less time than the S (Short) option.
	S	Short. Displays more information on the selected member than the Q (Quick) option.

To specify a JCL member for conversion:

Enter the ISPF library or PDS information.
If you are converting a CA Librarian member, enter the CA Librarian index type you desire.
Press Enter.
The application displays the JCL Member Selection List panel.

Use the JCL Member Selection List

After specifying a partial or complete member name on the JCL Library panel, the application displays the JCL Member Selection List panel.

CA InterTest™ Batch JCL: PDS USER1.INTBATCH.JCL---------------------------------- Command ===> Scroll ==> PAGE Enter B to Browse member, S to select member for JCL conversion Cmd Name Message VV.MM Created Modified______ Size Init Mods ID ABSDUMP 01.00 92.325 92.325 15:47 00006 00006 00000 USER1 ASMHAL 01.00 92.154 92.154 11:40 00015 00015 00000 USER1 TESTX 01.02 91.008 92.211 15:47 00043 00022 00027 USER1 TEST2 01.03 92.188 93.062 09:13 00005 00005 00000 USER1 TEST3 01.00 92.188 92.188 10:34 00007 00007 00000 USER1

This panel displays the JCL members that match the member name or wild card pattern specified in the Member field on the JCL Library panel. If you made no entry in the Member field, the application displays all the members of the library.

Enter the following line commands in the Cmd field before each member in the list:

To browse the JCL library member. the application displays the JCL Browse panel.

To select the JCL member for conversion to ALIB format. Once the JCL conversion has ended, the application displays the JCL Allocations Step Selection List panel. Note that if you have not set the option to suppress the Conversion/Allocation Options panel, it is displayed before converting the JCL and displaying the JCL Allocations Step Selections Panel. For more information, see Option 4: JCL Conversion/Allocation Options.

The JCL Browse Panel

The application displays the JCL Browse panel when you use the Browse command on the JCL Member Selection List panel.

Use the JCL Browse panel to check the contents of a member selected for conversion and to determine the STEP names. Scroll through the member to find the STEPs you want to use. Entering an END command or pressing the End key redisplays the JCL Member Selection List panel.

CA InterTest™ Batch Browse JCL: PDS USER1.INTBATCH.JCL --------------------------
Command ===>                                                   Scroll ==> PAGE 
Cmd __________________________________ JCLs __________________________________ 
    //USER01C  JOB (12300000,76),'RUN',CLASS=A,MSGCLASS=Z,        
    //    NOTIFY=USER01 
    //PROCLIB  DD  DISP=SHR,DSN=USER01.PROCLIB 
    //QDD1     EXEC  COB,N=QDD 
    //COB.SYSIN DD   DISP=SHR,DSN=USER01.QDD.COBOL 
    //QEE2     EXEC  COB,N=UXX 
    //COB.SYSIN DD   DISP=SHR,DSN=SYS2.ROSCOE56.DAILY.BKUP(‑5)

Select Converted JCL Steps for Allocation

The application always displays the JCL Allocation Step Selection List panel after JCL conversion, if there were multiple steps in the JCL. The panel lists all JCL EXEC cards in the member:

CA InterTest™ Batch JCL: PDS USER1.INTBATCH.JCL(TEST3) ------------------------- 
Command ===>                                                   Scroll ==> PAGE 
    Enter S beside step to select, or press END key to select all 
Cmd‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ Steps ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ 
    DELETE    //DELETE  EXEC PGM=IEFBR14 
    C         //C       EXEC PGM=IKFCBL00,REGION=4M, 
    LKED      //LKED      EXEC PGM=IEWL, 
    PRINTIT   //PRINTIT   EXEC PGM=IEBGENER,REGION=1024K 
    DELETE    //DELETE  EXEC PGM=IEFBR14 
    C         //C       EXEC PGM=IKFCBL00,REGION=4M, 
    LKED      //LKED      EXEC PGM=IEWL, 
    PRINTIT   //PRINTIT   EXEC PGM=IEBGENER,REGION=1024K

Note: If you have not set the option to suppress the Conversion/Allocation Options panel, it displays before converting the JCL and displaying the JCL Allocations Step Selections Panel. For more information, see Option4: JCL Conversion/Allocation Options.

To select converted JCL steps for allocation

On the JCL Allocation Step Selection List panel, enter S next to the steps whose data set allocations you want to use or enter the END command (or press the END key) to use all the steps. The steps you select form your allocation list.
Press Enter (unless you used an END key instead of entering the END command in step 1).
The application displays the Allocations Edit panel so you may edit the newly created Allocation List, saved in an allocation library or converted to CLIST format.

For more information on working with allocation libraries, see Editing ALIB Allocations.

The Conversion Process

When you select JCL for conversion to ALIB format, the JCL converter checks the JCL for syntax. If the JCL executes procedures and PROCLIBs were specified on the Conversion/Allocation Options panel, the JCL converter expands the procedures found in the PROCLIBs, substitutes parameters, and performs step overrides. If the JCL executes a procedure that is not found in a PROCLIB, a WARNING panel is displayed and JCLCHECK message CAY6027E is included in the ALIB member, indicating the name of the procedure that was not found.

CA InterTest™ Batch ALIB EDIT: PDS CAI.CAISRC(DEMOJCL)                    ----
COMMAND ===>                                                    SCROLL==> PAGE
LINE COMMANDS - I(NNN), D(NNN), R(NNN), AL(LOCATE), F(REE), S(PACE)            
PRIMARY COMMANDS - ALLOCATE, SAVE, CREATE, RESET, CANCEL, IMPORT, EXPORT,      
 REPLACE, FREE, OPTS, END.  FOR AN EXPLANATION, SEE THE USER GUIDE OR HIT HELP.
CMD  DDNAME   DATA SET NAME                                DISP VOLSER   DCB AL
MSG> Imported from CAI. CAISRC(DEMOJCL)                    
MSG> DEMOJCL //DEMOJCL  JOB (124400000),'INTBAT80 DEMOJCL                      
MSG> STEP1   //STEP1    EXEC PGM=CAMRCOBB,REGION=4M                  STEP1     
MSG> ..  .CA                                                                   
.... @STEPLIB USER1.LOAD                                   SHR            N    
.... SYSPRINT SYSOUT=X                                     NEW            N    
.... SYSOUT   SYSOUT=X                                     NEW            N    
.... REPORT   SYSOUT=X                                     NEW            N    
******************************** BOTTOM OF DATA *******************************

To save the created ALIB member

Place the cursor on the command line and type in 'SAVE' to save the ALIB version of the JCL.

The following screen opens:

--------------- CA InterTest™ Batch - Copy to Allocation Library ---------------
 Command ===>                                                                   
                                                                                
 Specify Allocation Library (ALIB) and member:                                  
                                                                                
 ISPF library:                                                                  
      Project ===>                                                              
      Group   ===>                                                              
      Type    ===>                                                              
      Member  ===>                                                              
                                                                                
 Other partitioned data set:                                                    
    Data set name ===>                                                          
    Volume serial ===>          (If not cataloged)                              
                                                                                
 Replace like-named member ===>          (Yes or No)

Fill in the library and member name where your ALIB member is to be saved and press Enter.
The ALIB member is saved.

Special Considerations

There are some special conversion considerations for certain types of DD statements. The application allocates DD statements to a particular TSO session by using SVC 99, which performs dynamic allocation. SVC 99 does not allow the following four DD statements to be dynamically allocated:

STEPLIB
JOBLIB
STEPCAT
JOBCAT

The application changes STEPLIB to @STEPLIB and JOBLIB to @JOBLIB.

JCL Keywords Supported for Conversion

The JCL converter supports the following JCL keywords and positional operands. The degree of converter support is noted.

JCL Keywords	Description
DSN=	Fully supported.
DISP=	All operands except conditional dispositions are supported. If a DD with a conditional disposition is passed, the third sub parameter is ignored.
DCB=	The DCB keywords supported are: RECFM= BLKSIZE= LRECL= DSORG=
HOLD=	Ignored.
SYSOUT=	Fully supported. Only the CLASS parameter is used.
UNIT=	Fully supported.
VOL=	Fully supported. Only the VOLSER parameter is used.
SUBSYS=	Fully supported. Check with the vendor to make sure that a DD can be allocated for this subsystem with SVC 99.
SPACE=	Fully supported.
STORCLAS=	Fully supported.
DATACLAS=	Fully supported.
MGMTCLAS=	Fully supported.
DSNTYPE=	Fully supported.
RECORG=	Fully supported.
AVGREC=	Fully supported.
KEYOFF=	Fully supported.
KEYLEN=	Fully supported.
LIKE=	Fully supported.
REFDD=	Fully supported.

JCL Keywords Not Supported for Conversion

The JCL converter does not convert all JCL keywords because many parameters in batch JCL are not supported in TSO CLISTs. The converter ignores backward references and keywords that it does not convert.

The following DD statement keywords are not converted.

AMORG=	FLASH=
BURST=	FREE=
CHARS=	LABEL=
CHKPT=	MODIFY=
CNTL=	MSVGP=
COPIES=	OUTLIM=
DDNAME=	OUTPUT=
DEST=	PROTECT=YES
DLM=	QNAME=
DSID=	UCS=
FCB=

Option 3: Current Allocations

The application displays the Current Allocations panel when you select option 3 (CURRENT) from the Allocations Main Menu panel. The current allocations option displays current session allocations and lets you free, browse, or edit allocated data sets.

The Current Allocations panel lists currently allocated data sets, which may have been previously allocated in TSO Logon Procedures (such as STEPLIB), by a CLIST, or by the Allocation Facility. A sample Current Allocations List panel follows:

----------------- CA InterTest™ Batch Current Allocations List ------------------ Command ===> Scroll ==> PAGE Line commands: F ‑ Free, B ‑ Browse, E ‑Edit. Cm DDName Disp Dataset Name Volser ISP10155 SHR USER1.INTBATCH.ISPMLIB OSI011 ISPPROF SHR USER1.ISPF.ISPPROF CAI801 SYSPRINT TERM SYSTERM TERM SYSOUT TERM SYSUDUMP JES SYSIN TERM SYS00001 SHR SYS1.BRODCAST MVSLIB ISPALIB SHR ISP.V3R2M0.ISPALIB MVXAD1 ISRCFIL SHR ISR.ISPFLMF.CFIL MVS003 SYSHELP SHR SYS2.HELP MVSLIB SHR SYS1.HELP MVXAD1 SHR USER.HELP CAI800 ISPTABL SHR USER1.ISPF.ISPPROF CAI801 ICQTABL SHR ICQ.ICQTLIB MVXAD1 SYSPROC SHR SYS2.CLIST MVSLIB SHR ICQ.ICQCCLIB MVXAD1 SHR ICQ.ICQACLIB MVXAD1 SHR ISR.V3R2M0.ISRCLIB MVXAD1 SHR SYS1.RMFCLS MVXAD1

You may scroll through the list and enter the following line commands next to any data set in the list:

F/S	Free the data set/ddname.
B	Browse the data set. This is an ISPF function and operates only if it is supported by your ISPF installation.
E	Edit the data set. This is an ISPF function, and operates only if it is supported by your ISPF installation.

Option 4: JCL Conversion/Allocation Options

The application displays the JCL Conversion/Allocation Options panel when you select option 4 (OPTIONS) from the Allocations Main Menu panel.

Use the Options option to specify JCL conversion and ALIB member export options and Proclibs (procedure libraries) used for expanding JCL procedures found during JCL conversion. A sample Conversion/Allocation Options panel follows:

------------- CA InterTest™ Batch JCL Conversion/Allocation Options -----------
Command ===> 

JCL conversion options: 
  Proclib 1        ===> 
  Proclib 2        ===> 
  Proclib 3        ===> 
  Proclib 4        ===> 
  Proclib 5        ===> 
  Proclib 6        ===> 
  Proclib 7        ===> 
  Pre‑allocated DD ===> 
  EASYPROCLIB ?    ===> NO    (Yes or No) 

Conversion to CLIST options: 
  CLIST 'Control'  ===> NOMSG 
  DCB info on      ===> ATTR      (Attr, Alloc) 
  If allocated     ===> FREE      (Reuse, Free ) 
  If exists        ===> DELETE    (Delete, Use ‑ for new datasets only) 

  Suppress this panel during JCL conversion? ===> NO    (Yes or No)

The Current Allocations/Options fields are described next:


Proclib 1‑7	The procedure library names you want to use for expanding procedures found in JCL during conversion. When your JCL job stream executes procedures, assign the procedures a procedure library to be used during the conversion process. Enter up to seven procedure library names. If you require more than seven procedure libraries, use a pre‑allocated DDname instead.
Pre‑allocated DD	If your procedure libraries are pre‑allocated (for example, in the TSO logon procedures or custom CLISTs), enter the name of a pre‑allocated DDname here.
EasyProclib	For EasyProclib users, this field specifies whether the JCL conversion facility uses private JCL procedure libraries identified by the //PROCLIB ddname in the job stream.
	Yes	The JCL conversion facility uses private JCL procedures using the //PROCLIB ddname in the job stream.
	No	The JCL conversion facility will not use private JCL procedures using the //PROCLIB ddname in the job stream.
	Default:	No
CLIST 'Control'	Whatever you enter here appears in the CLIST control statement when you convert from ALIB to CLIST (for example, NOMSG and NOLIST). For more information on valid CLIST control statements, see the IBM publication TSO Command Language Reference Manual.
DCB info on (Attr, Alloc)	Determines whether DCB information appears on the attribute statement or the allocate statement in your CLIST when you convert from ALIB to CLIST. The choice is mainly dictated by user‑preference.
	ALLOC	Put DCB information on the generated ALLOC statement.
	ATTR	Generate DCB information on a separate ATTRIB statement.
	Default:	Attr
If allocated (Reuse, Free)	Controls the allocation process during CLIST conversion. If the data set is already allocated:
	R	The application tries to reuse the allocation. The REUSE statement is generated on the allocations card.
	F	The application frees the data set before allocation. The FREE statement is generated on the allocations card.
	Default:	Free
If exists (Delete, Use ‑ for new data sets only)	Used for allocating a new, non‑temporary data set. Generates a DELETE statement in the CLIST to prevent a Duplicate Data Set Name error.
	DELETE	Generates a DELETE statement in the CLIST. This deletes any existing data set allocated with the same name.
	USE	A Duplicate Data Set Name error is generated if there is an existing data set allocated with the same name.
	Default:	USE
Suppress (Yes or No)	Indicates whether or not this panel should be suppressed when converting JCL. Once this option is set to Yes, this panel only displays when choosing option 4 from the Allocations Main Menu.