Program used for the generation of installation JCLs

In the JCL for the execution of the Installation JCL Generator (XRJCLGEN), the following program is used:

 

  • Installation JCL Generator (XRJCLGEN)

 

Even if you do not use the installation command, you can use the above program as necessary.

(1) Installation JCL Generator

Based on the information described in the definition card, generate the installation JCLs and the installation JCL library.

Program Name

XRJCLGEN

XRCRD definition card

The format for the definition card for generation of the installation JCLs and the installation JCL library is as shown below.

Definition Card Format

  a 
SERIALNO=xxxxx...xxx 
  b 
PRODUCTKEY=xxxxx...xxx 
  c 
[TERMLICENSEKEY=xxxxx...xxx] 
  d 
[DOMAIN=xxxxx...xxx] 
  e 
LOAD=xxxxx...xxx 
  f 
INJCL=xxxxx...xxx 
INPNLJ=xxxxx...xxx 
INPNLE=xxxxx...xxx 
INMSGJ=xxxxx...xxx 
INMSGE=xxxxx...xxx 
INPRM=xxxxx...xxx 
  g 
OUTJCL=xxxxx...xxx,xxxxx 
OUTPNL=xxxxx...xxx,xxxxx 
OUTMSG=xxxxx...xxx,xxxxx 
OUTPRM=xxxxx...xxx,xxxxx 
  h 
XRLOG=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRLOG1=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRLOG2=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRFILE=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRHOST=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRQUE=xxxxx...xxx,xxxxx,xxx,9999,9999 
XRCNTL=xxxxx...xxx,xxxxx,xxx,9999,9999

Definition card contents

a. Serial number

Specify the serial number of the product in the format "XXX-XXXX-XXXXXX" using "-" (hyphen) and numerals of 15 bytes. You cannot omit the specification.

= Remarks =

You can also specify the serial number in the format "XXXXXXXXXXXXX" without "-" (hyphen) in 13 bytes.

b. Product key

Specify the product key of the product you acquired from http://www.hulft.com/ in the format "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" using "-" (hyphen) and alphanumeric characters of 29 bytes. You cannot omit the specification.

= Remarks =

You can also specify the product key in the format "XXXXXXXXXXXXXXXXXXXXXXXXX" without "-" (hyphen) in 25 bytes.

c. Term License Key

Specify the term license key in the format "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX" using "-" (hyphen) and alphanumeric characters of 29 bytes.

= Remarks =

You can also specify the license key in the format "XXXXXXXXXXXXXXXXXXXXXXXXX" without "-" (hyphen) in 25 bytes.

d. Local domain name

Specify the local domain name (the local host name that is announced to remote machines) within 50 bytes.

e. HULFT load module library

Specify the HULFT load module library (installation destination file). You cannot omit the specification.

Specify a library name in compliance with the naming conventions of the operating system.

f. Installation library name

Specify the HULFT installation library name. You cannot omit the specification.

Specify a library name in compliance with the naming conventions of the operating system.

g. Installation destination library name

Specify the HULFT installation destination library name. You cannot omit the specification.

Specify a library name in compliance with the naming conventions of the operating system.

h. HULFT system file name

Specify the name of the HULFT system file to be created at installation. You cannot omit the specification.

Specify the HULFT system file name in compliance with the naming conventions of the operating system.

When you specify the file name, take into account the ".DATA" portion of the name when you determine the number of bytes.

= Remarks =

  • If the first line begins with "*," the line is treated as a comment line, and skipped when reading.

  • You cannot include spaces between the tags and specification values. All of the specification following a space is treated as a comment.

  • The record start position is your choice.

  • If the specification meets any of the following conditions, an error will occur, and all records following will not be read.

    • When an invalid tag is specified

    • When a tag is repeated

    • When there is an error in the specification method

    • When there is an extra tag or a tag is missing

  • You cannot make a specification across multiple records.

  • When you specify the installation destination file name, use the format below for the specification.

    Example: OUTJCL=HULFT.V8INS.JCL,HUL001

    OUTJCL=:

    Tag name

    HULFT.V8INS.JCL:

    Installation destination file name

    HUL001:

    Volume serial

    "," is the delimiter for the installation destination file name and the volume serial.

    Specify in the order described above. You cannot change the order. You also cannot make omissions.

  • When you specify the HULFT system file name, use the following format for the specification.

    Example: XRLOG=HULFT.V8 TEST.LOG,HUL001,CYL,5[,1]

    XRLOG=:

    Tag name

    HULFT.V8 TEST.LOG:

    HULFT system file name

    HUL001:

    Volume serial

    CYL:

    Capacity [CYL|TRK]

    5:

    1ST Extent (from 1 to 9999)

    1:

    Secondary (from 0 to 9999)

    If you omit this specification, "0" is set.

    "," is the delimiter for the HULFT system file name and the volume serial.

    Specify in the order described above. You cannot change the order.

Example of JCL

[JCL template: HULFT.JCL(XRJCLGEN)]

//XRJCLGEN JOB  CLASS=A,MSGCLASS=B
//XRJCLGEN EXEC PGM=XRJCLGEN,REGION=1024K
//STEPLIB  DD   DISP=SHR,DSN=HULFT.LOAD
//WRKINST  DD   DISP=(NEW,CATLG,DELETE),DSN=HULFT.SETUP.JCL,
//             UNIT=SYSALLDA,VOL=SER=HUL001,
//             DCB=(LRECL=80,BLKSIZE=6160,RECFM=FB,DSORG=PO),
//             SPACE=(CYL,(1,0,10))
//SYSOUT   DD   SYSOUT=*
//SYSUDUMP DD   SYSOUT=*
//XRCRD    DD   *
  SERIALNO=XXXXXXXXXXXXX
  PRODUCTKEY=XXXXXXXXXXXXXXXXXXXXXXXXX
* TERMLICENSEKEY=
  DOMAIN=ZOS
*
  LOAD=HULFT.LOAD
*--------------------< HULFT INSTALLATION FILE >---------------------
  INJCL=HULFT.V8.JCL
  INPNLJ=HULFT.V8.JPN.PANEL
  INPNLE=HULFT.V8.ENG.PANEL
  INMSGJ=HULFT.V8.JPN.MSG
  INMSGE=HULFT.V8.ENG.MSG
  INPRM=HULFT.V8.PARMLIB
*---------------< HULFT INSTALLATION DESTINATION FILE >--------------
  OUTJCL=HULFT.JCL,HUL001
  OUTPNL=HULFT.PANEL,HUL001
  OUTMSG=HULFT.MSG,HUL001
  OUTPRM=HULFT.PARMLIB,HUL001
*-----------------------< HULFT SYSTEM FILE >-----------------------
  XRLOG=HULFT.LOG,HUL001,CYL,5,1
  XRLOG1=HULFT.LOG.PATH1,HUL001,CYL,5,1
  XRLOG2=HULFT.LOG.PATH2,HUL001,CYL,5,1
  XRFILE=HULFT.FILE,HUL001,CYL,1,1
  XRHOST=HULFT.HOST,HUL001,CYL,1,1
  XRQUE=HULFT.QUEUE,HUL001,CYL,1,1
  XRCNTL=HULFT.SYSCNTL,HUL001,CYL,1,1
//

Parameter

Value

Description

UNIT

SYSALLDA

UNIT

VOL=SER

HUL001

Volume name

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

WRKINST

HULFT.SETUP.JCL

Installation JCL library