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

By default, High Level Assembler is installed into the PRD1.BASE sublibrary for z/VSE. If you decide to install High Level Assembler into a sublibrary other than PRD1.BASE then proceed with this step.

Decide where to allocate space for the High Level Assembler 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 ASMAVTOC    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 ASMADITT    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 High Level Assembler in the LIBR installation job to allocate the VSE Librarian library in the sample job shown in Figure 3.

Figure 3. Job to allocate the High Level Assembler library space

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

In area 1 change the filename (HLASM in the example) and file-id (HLASM.LIBRARY in the example) of High Level Assembler to suit the requirements at your site. Points to consider are:

The variable ntrk indicates the number of tracks required; see Table 1 for the number of tracks 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. This means the following messages are issued when the job runs for the first time; however these may be treated as informational and ignored. The job continues to allocate the library.

The messages are:

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