Step 1: Allocate space for the library (omit if using the default)

By default, HLASM Toolkit Feature is installed into the PRD2.PROD sublibrary for z/VSE. If you decide to install HLASM Toolkit Feature into a sublibrary other than PRD2.PROD then proceed with this step.

Decide where to allocate space for the HLASM Toolkit Feature sublibrary. Identify, on the disk volume (or volumes) to be used for the library, suitable areas of free space. To do this, list the volume table of contents (VTOC) of the disk or disks to be used.

Choose one of the following jobs to list the VTOC:

Use the LVTOC utility program. The sample job shown in Figure 1 shows the JCL needed to list the VTOC for the volume with serial number SYSWK1.
Figure 1. Job to list the contents of a DASD volume
```
// JOB ASMTVTOC    LIST VOLUME TABLE OF CONTENTS
// ASSGN SYS004,DISK,TEMP,VOL=SYSWK1,SHR
// ASSGN SYS005,SYSLST
// EXEC LVTOC
/*
/&
```
Use the DITTO utility program
As an alternative to using the system utility LVTOC, DITTO's Display VTOC (DVT) may be used. Figure 2 shows a sample job.
Figure 2. Job to list the contents of a DASD volume
```
// JOB ASMTDITT    LIST VOLUME TABLE OF CONTENTS
// UPSI 1
// ASSGN SYS001,cuu
// EXEC DITTO,SIZE=512K
$$DITTO DVT INPUT=SYS001,SORTBY=EXTENT
$$DITTO EOJ
/*
/&
```

Use the disk space selected for HLASM Toolkit Feature in the LIBR installation job to allocate the z/VSE Librarian library in the sample job shown in Figure 3.

Figure 3. Job to allocate the HLASM Toolkit Feature library space

// JOB ASMTDEF
*  CREATE A LIBRARY FOR THE High Level Assembler Toolkit Feature
// OPTION LOG
*  Label for the HLASM Toolkit Feature
*  Library                                                          1 
// DLBL HLASMT,'HLASM.TOOLKIT.LIBRARY',99/365,SD
// EXTENT SYS002,SYSWK1,,,rtrk,ntrk
// ASSGN SYS002,DISK,VOL=SYSWK1,SHR
* ------------------------------------------
*  Define the High Level Assembler Toolkit Feature Library          2 
* ------------------------------------------
// EXEC LIBR
 DELETE LIB=HLASMT
 DEFINE LIB=HLASMT
/*
/&

In area 1 change the filename (HLASMT in the example) and file-id (HLASM.TOOLKIT.LIBRARY in the example) of HLASM Toolkit Feature to suit the requirements of your site. Points to consider are:

The variable ntrk indicates the number of tracks or blocks required. See Table 1 for the number of tracks or blocks for your DASD type.
The variable rtrk represents the start position of the extent.

The Librarian job step in area 2 includes a DELETE statement before the DEFINE statement so the job can be rerun. The following informational messages are issued when the job runs for the first time. The job continues to allocate the library.

The messages are:

L101I  LIBRARY HLASMT DOES NOT EXIST
L027I  ABNORMAL END DURING DELETE COMMAND
       PROCESSING
L113I  RETURN CODE OF DELETE IS 8