Program used in STEP4

In the JCL in STEP4, the following program is used:

 

  • System Environment Settings Conversion (XRPRMCNV)

 

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

(1) System Environment Settings Conversion program

The setting values in the System Environment Settings are re-written based on the information described on the XRCRD and converted.

Note

In HULFT Ver.8.4.0 or higher, you can convert only when all of the following conditions are fulfilled:

  • Of the fields of the System Environment Settings, specification of only the following fields:

    • Serial number (SERIALNO)

    • Product key (PRODUCTKEY)

    • Term License Key (TERMLICENSEKEY)

    • Local domain name (DOMAIN)

Program Name

XRPRMCNV

XRCRD definition card

The format for the definition card for conversion of the System Environment Settings is as shown below.

Definition Card Format

  a 
[SERIALNO=xxxxx...xxx] 
  b 
[PRODUCTKEY=xxxxx...xxx] 
  c 
[TERMLICENSEKEY=xxxxx...xxx] 
  d 
[DOMAIN=xxxxx...xxx]

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.

= 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 numerals of 29 bytes.

= 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 numerals of 29 bytes.

= Remarks =

You can also specify the term 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.

= 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.

Example of JCL

[JCL template: HULFT.JCL(XRPRMCNV)]

//XRPRMCNV JOB  CLASS=A,MSGCLASS=B
//XRPRMCNV EXEC PGM=XRPRMCNV,REGION=1024K
//STEPLIB  DD   DISP=SHR,DSN=HULFT.LOAD
//INPRM    DD   DISP=SHR,DSN=HULFT.PARMLIB(HULPRM)
//OTPRM    DD   DISP=SHR,DSN=HULFT.PARMLIB(HULPRM)
//SYSOUT   DD   SYSOUT=*
//SYSUDUMP DD   SYSOUT=*
//XRCRD    DD   *
  SERIALNO=XXXXXXXXXXXXX
  PRODUCTKEY=XXXXXXXXXXXXXXXXXXXXXXXX
* TERMLICENSEKEY=
  DOMAIN=ZOS
//

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

INPRM

HULFT.PARMLIB(HULPRM)

Migration source System Environment Settings file

OTPRM

HULFT.PARMLIB(HULPRM)

Migration destination System Environment Settings file