Generating a parameter file from management information

The parameter file (definition card) to be used by the Management Information Batch Registration command (UTLIUPDT) can be generated from the registered management information.

Note

If your configuration does not meet one of the following, HULFT does not generate a parameter file properly.

When you run command from command line

Ensure that the CCSID (Coded Character Set Identifier) settings of your emulator (Host Code-Page), the job that executes this command, and the parameter file satisfy one of the following conditions:

[Configuration 1]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Setting the CCSID (Coded Character Set Identifier) of the job to 65535
Complete agreement of CCSID (Coded Character Set Identifier) settings between the parameter file and HULFT Character Set in the System Environment Settings file

[Configuration 2]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
Setting the CCSID (Coded Character Set Identifier) of the job to 65535
Setting the CCSID (Coded Character Set Identifier) of the parameter file to 65535

[Configuration 3]

Complete agreement of CCSID (Coded Character Set Identifier) settings between your emulator and HULFT Character Set in the System Environment Settings file
CCSID (Coded Character Set Identifier) is set to the same value as HULFT Character Set in the System Environment Settings file
Selecting the CCSID (Coded Character Set Identifier) of the parameter file at user's discretion

When you run command as a batch job

Ensure that the CCSID (Coded Character Set Identifier) settings of the batch job that executes this command and the parameter file satisfy one of the following conditions:

[Configuration 1]

Complete agreement of CCSID (Coded Character Set Identifier) settings between the batch job and HULFT Character Set in the System Environment Settings file
Selecting the CCSID (Coded Character Set Identifier) of the parameter file at user's discretion

[Configuration 2]

Setting the CCSID (Coded Character Set Identifier) of the batch job to 65535
Complete agreement of CCSID (Coded Character Set Identifier) settings between the batch job and HULFT Character Set in the System Environment Settings file

(1) Management Information Parameter File Generation command

Program interface

CALL library name/UTLIGEN PARM(['LIB=library name']
   'F=filename' 'I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}' ['ID=id']
   ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

F=filename

Parameter file name (Mandatory)

Specify this parameter in the format of Library name/File name(Member name).

If the file does not exist, a new file is created. When the file already exists, the existing file is overwritten.

I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}

Selects a type of management information to generate a parameter file. (Mandatory)

SND :: Send Management Information
RCV :: Receive Management Information
JOB :: Job Information
HST :: Host Information
TGRP :: Transfer Group Information
FMT :: Format Information
MFMT :: Multi Format Information

ID=id

Target ID or Host Name for which a parameter file is generated (Optional)

When omitted, a parameter file that includes all records of the specified management information is created.

Specify the ID as an alphanumeric character string of 50 bytes or less, except for in the Host Information. Specify Host Name in the Host Information as an alphanumeric character string of 68 bytes or less.

Using an asterisk (*) allows you to retrieve prefix matches of the ID.

G

Control of error messages that the Management Information Parameter File Generation command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Management Information Parameter File Generation command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Management Information Parameter File Generation command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must immediately follow the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

Note

For a parameter file, use the file that can accept a double-byte character set, of which record length is 224 bytes at least. If the file does not meet the condition, an invalid parameter file may be generated.

= Remarks =

By repeating the parameters "I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}" and "ID=id", a parameter file that includes various types of management information can be generated.

Command interface

UTLIGEN PARMFILE( ) PARMMBR( ) FILETYPE((i id)) LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

PARMFILE

Library name and file name of the parameter file (Mandatory)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

If the file does not exist, a new file is created. When the file already exists, the existing file is overwritten.

PARMMBR

Member name of the parameter file ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

FILETYPE

Information for which a parameter file is generated (Mandatory)

i

Select management information for which a parameter file is generated.

SND :: Send Management Information
RCV :: Receive Management Information
JOB :: Job Information
HST :: Host Information
TGRP :: Transfer Group Information
FMT :: Format Information
MFMT :: Multi Format Information

id

Target ID or Host Name for which a parameter file is generated

Specifying *ALL creates a parameter file that includes all records of the specified management information.

Using an asterisk (*) allows you to retrieve prefix matches of the ID.

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

= Remarks =

Repeating the description of "(i id)" within "FILETYPE" allows you to generate a parameter file that includes multiple records of management information.

(2) Description example

CALL HULFT/UTLIGEN PARM('F=MYLIB/IGEN(TEST)' 'I=SND' 'ID=S*' 'I=RCV' 'ID=RCV00001')

The above example generates a parameter file "MYLIB/IGEN(TEST)" from all File IDs starting with "S" that are registered in the Send Management Information and the file ID "RCV00001" registered in the Receive Management Information.

(3) Note on changing Forced Strong Key mode

When you change Forced Strong Key Mode (STRONGKEYMODE) between "1" (Enabled) and "0" (Disabled) in the System Environment Settings, follow the steps below to revise settings in the parameter file:

Generate the parameter file before changing Forced Strong Key Mode (STRONGKEYMODE) in the System Environment Settings.
Change the cipher key to the type of key that can be used after Forced Strong Key Mode (STRONGKEYMODE) is changed.
Register the parameter file with Forced Strong Key Mode (STRONGKEYMODE) changed.

If you attempt to generate the parameter file only with changing Forced Strong Key Mode (STRONGKEYMODE) without following the above steps, "%ERROR" is output into the cipher key.