Method 3: Install HLASM Toolkit Feature using a batch job

Edit online

The batch installation job stream for installing HLASM Toolkit Feature uses the MSHP system history file that already exists as part of the z/VSE® system. This system history file might already be defined in the system standard labels; if not, make sure that DLBL and EXTENT statements, with the necessary information for the system history file, are included in the job stream.

Depending on how you request the HLASM Toolkit Feature product you might receive different installation tapes. One could contain only the HLASM Toolkit Feature product (V1 Format tape), the other might be a V2 Format tape containing one or more optional program products. The job shown in Figure 1 handles both types of tape (V2 Format and V1 Format).

Create and tailor the following job stream, mount the distribution tape, and run the installation job.

Figure 1 provides the JCL required to install HLASM Toolkit Feature. Tailor this JCL to suit the requirements at your site.

As many as five modifications might be required to tailor the JCL. The keys in Figure 1 are explained individually and refer to the sections that accompany the JCL description.

Figure 1. Job to install HLASM Toolkit Feature

// JOB ASMTINST
*  INSTALL THE High Level Assembler Toolkit Feature LIBRARY
// OPTION LOG
*  Label for High Level Assembler Toolkit Feature Library    1 
*  Assign  install tape as SYS006                            2 
// ASSGN SYS006,cuu
// MTC REW,SYS006
* ----------------------------------------
*  This step installs High Level Assembler Toolkit Feature
*  from the distribution tape
*  using the VSE system history file                         3 
* ----------------------------------------
// EXEC MSHP,SIZE=900K,PARM='PIDSTACKED'
 INSTALL PROD FROMTAPE ID='HLASM.TLKT.1.6.0' -
    PROD INTO=PRD2.PROD
/*
* ----------------------------------------
*  List the High Level Assembler Toolkit Feature Library     4 
* --------------------------------------
// EXEC LIBR
 LISTDIR SUBLIB=PRD2.PROD  -
     OUTPUT=NORMAL -
     UNIT=SYSLST
/*
* ------------------------------------------
*  Retrace the High Level Assembler Toolkit Feature product  5 
* ------------------------------------------
// EXEC MSHP,SIZE=900K
RETRACE COMPONENT IDENTIFIER=5696-234-01
/*
// MTC RUN,SYS006
/*
/&

Specify the Label Information
In area 1 , if you are installing HLASM Toolkit Feature into a sublibrary other than the default then insert DLBL, EXTENT, and ASSGN information as specified in Figure 3. The library name must match the name used in the allocation job in Figure 3.

There is no DLBL statement for the system history file. Typically it has a permanent system standard label for this, with IJSYSHF as the file name. (IJSYSHF is the default file name that MSHP looks for in a label statement.)
Assign the Distribution Tape
Assign the distribution tape in area 2 to logical unit SYS006. Replace cuu with the address of the tape drive on which the distribution tape is mounted. Alternatively you may use the generic tape assignment:
```
// ASSGN SYS006,TAPE
```
Install HLASM Toolkit Feature
Area 3 of the job calls MSHP to install HLASM Toolkit Feature into the sublibrary identified on the INTO operand of the INSTALL statement. If you are installing HLASM Toolkit Feature into a sublibrary other than the default, then change the name of the sublibrary on the INTO operand of the INSTALL statement to reflect this sublibrary. For more information about the install options, see Maintain System History Program (MSHP) in z/VSE: System Control Statements.
List the Directory Entries
The step in area 4 of the job lists the directory entries of the sublibrary where HLASM Toolkit Feature was installed. Remove this step if a directory list is not required. If you have installed HLASM Toolkit Feature into a sublibrary other than the default, then the name of the sublibrary must be changed to reflect the value you specified in area 3 .
Entries for HLASM Toolkit Feature have a three character prefix of ASM to distinguish them from other products; there are three exceptions to this rule:
- HD2346IM.Z
- $SVAASMT.PHASE
- $SVAASMT.OBJ
Retrace the HLASM Toolkit Feature product in the system history file.
The final step in area 5 of the job prints the component records from the system history file for HLASM Toolkit Feature. Remove this step if a retrace listing is not required.

If this job has to be run again, remember first to restore the system history file, which should have been backed up before running this install job, and second to run the library allocation step again, if applicable.