Operation of HULFT in an SMS-managed environment
HULFT can send an SMS-managed file, and receive data in an SMS-managed file.
This section describes points to be noted when HULFT operates in an SMS-managed environment.
In this section, the following terms are used:
-
SMS-managed volume
A volume that is registered in a POOL-type storage group.
-
SMS-managed file
A file on a volume that is registered in a POOL-type storage group.
Sending SMS-Managed Files
Send files must be allocated to a volume belonging to the unit group that is specified as the default for the system.
Direct Transfer
When you use the Direct Transfer, note the following:
System Environment Settings
UNIT Name of Send Files and Receive Files (INIT-UNIT)
When you dynamically specify an SMS-managed file to send, the unit information that is registered in the storage group overrides the value that is specified for the UNIT Name
of Send Files and Receive Files (INIT-UNIT).
Send Management Information
Volume Serial (VOL)
When you send an SMS-managed file, do not specify the Volume Serial (VOL).
UNIT (UNIT)
When you send an SMS-managed file, the unit information that is registered in the storage group overrides the value that is specified for the UNIT (UNIT).
Work File Transfer
When you use the Work File Transfer, note the following in addition to the notes on the Direct Transfer:
System Environment Settings
First Modifier of Send Work Files (PREFIX)
When you create a Send work file on an SMS-managed volume, carry out the following:
-
Specification of a modifier for the First Modifier of Send Work Files (PREFIX) in the System Environment Settings
-
Definition of ACS routines in order for data sets whose names start with the first modifier that is specified above to be created on an SMS-managed volume
UNIT Name of Send Work Files (UNIT)
When you create a Send work file on an SMS-managed volume, the unit information that is registered in the storage group overrides the value that is specified for the UNIT Name of Send Work Files (UNIT).
Work Volume Mode (WORKVOLMODE)
When you create a Send work file on an SMS-managed volume, the unit information that is registered in the storage group overrides the value that is specified for the Work Volume Mode (WORKVOLMODE).
Send Management Information
Work Volume Serial (WORK-VOL)
When you create a Send work file on an SMS-managed volume, do not specify the Work Volume Serial (WORK-VOL).
For information about how to create a Send work file on an SMS-managed volume, refer to the note in this section on the First Modifier of Send Work Files (PREFIX) in the System Environment Settings.
UNIT Quantity (UNIT-CNT)
When you create a send work file on an SMS-managed volume, a multi-volume file is created according to the setting value of UNIT Quantity (UNIT-CNT) in the Send Management Information.
However, when UNIT Quantity (UNIT-CNT) is specified as "1", the multi-volume file is created according to the setting for "volume count" of the data class.
Receiving in SMS-Managed Files
System Environment Settings
First Modifier of Receive Work Files (RPREFIX)
When you create work files for the Multiple Receive on an SMS-managed volume, carry out the following:
-
Specification of a modifier for the First Modifier of Receive Work Files (RPREFIX) in the System Environment Settings
-
Definition of ACS routines in order for data sets whose names start with the first modifier that is specified above to be created on an SMS-managed volume
UNIT Name of Send Files and Receive Files (INIT-UNIT)
When you receive data in an SMS-managed file, the unit information that is registered in the storage group overrides the value that is specified for the UNIT Name of Send Files and Receive Files (INIT-UNIT).
Receive Management Information
Volume Serial (VOL)
When you receive data in an existing SMS-managed file, the value that is specified for the Volume Serial is not used. Receive files are created on the volumes defined in the storage group that is defined on the operating system.
Volumes defined in the storage group must belong to the unit group that is specified as the default for the system.
Work Volume Serial (WORK-VOL)
When you create work files for the Multiple Receive on an SMS-managed volume, do not specify the Work Volume Serial (WORK-VOL).
When you create work files for the Multiple Receive on an SMS-managed volume, refer to the note in this section on the First Modifier of Receive Work Files (RPREFIX) in the System Environment Settings.
Multivolume (VOL-TYPE)
It is possible to create a new multi-volume file and receive data in it when all of the following conditions are met:
-
The Receive file is an SMS-managed file
-
The value of the volume count in the defined data class for the Receive file is 2 or higher
When all of the following conditions are met, specify 'A' (Automatic) for the Multivolume (VOL-TYPE) in the Receive Management Information, because the Receive file may be changed to a multi-volume file.
-
Data is received in existing SMS-managed files
-
The value of the Dynamic Volume Count in the defined data class is 2 or higher.
When you receive data in an existing SMS-managed Receive file, it is recommended that you specify 'A' (Automatic) for the Multivolume (VOL-TYPE) in the Receive Management Information. By doing so, you can receive data regardless of whether the Receive file is a single-volume file or a multi-volume file.
UNIT (UNIT)
When you receive data in an SMS-managed file, the value that is specified for the UNIT (UNIT) is not used, because the Receive file is created on a volume that is set for the storage group.
Error Handling (ABNORMAL)
When you specify 'R' (Restore) for the Error Handling (ABNORMAL), specify classes with the same attributes as the Receive file for the following fields in the Receive Management Information:
-
Storage Class (STORCLAS)
-
Management Class (MGMTCLAS)
-
Data Class (DATACLAS)
Catalog Operation (CATALOG)
When you create a new Receive file on an SMS-managed volume, the file is cataloged regardless of the specification of the Catalog Operation (CATALOG).
Handling of Inter-Mainframe Receiving (MFRCVORG)
When the Send file is an SMS-managed file, the class attributes of the Send file are not used for the Receive file.
Data Class (DATACLAS)
When you create a new Receive file on an SMS-managed volume, specify the Data Class (DATACLAS) to suit your environment.
When you specify the Data Class (DATACLAS) in the Receive Management Information and create a new Receive file to receive data, if you omit the following fields or specify 'No' for the fields, the values in the data class that is specified for the Data Class (DATACLAS) are applied for the Receive file.
-
Record Format (RECFM)
-
Record Length (LRECL)
-
Block Size (BLOCKLEN)
-
Print Character (PRINT-CNTL)
-
Capacity (CYL|TRK)
-
1ST Extent (CYL|TRK)
-
Secondary (CYL|TRK)
Even if a data class where the Override Space is specified as 'Y' is used to create the Receive file, the settings of the Receive Management Information override the settings of the data class. Omit the fields when you want to use the values of the data class.
Storage Class (STORCLAS)
When you create a new Receive file on an SMS-managed volume, specify the Storage Class (STORCLAS) to suit your environment.
Management Class (MGMTCLAS)
When you create a new Receive file on an SMS-managed volume, specify the Management Class (MGMTCLAS) to suit your environment.
Creation of backups of operation logs
System Environment Settings
Command Execution Log Backup Output Volume Name (OPLCMDBKVOL)
When you specify the Command Execution Log Backup Output Data Set Name (OPLCMDBK) and the generation files are to be created on an SMS-managed volume, the files will be created on a volume that belongs to the target storage group instead of the volume that you specified for the Command Execution Log Backup Output Volume Name (OPLCMDBKVOL).
File Access Log Backup Output Volume Name (OPLFILEBKVOL)
When you specify the File Access Log Backup Output Data Set Name (OPLFILEBK) and the generation files are to be created on an SMS-managed volume, the files will be created on a volume that belongs to the target storage group instead of the volume that you specified for the File Access Log Backup Output Volume Name (OPLFILEBKVOL).
UNIT Name of Operation Log Output Data Set (OPLUNIT)
When you specify the Command Execution Log Backup Output Data Set Name (OPLCMDBK) or the File Access Log Backup Output Data Set Name (OPLFILEBK) and the generation files are to be created on an SMS-managed volume, the unit information that is registered for the storage group overrides the value that is specified for the UNIT Name of Operation Log Output Data Set (OPLUNIT).
Usage of environment variables in Post-receive Job
&VOL
When you receive data in an SMS-managed file, this variable of the Post-receive Job inherits the value that is specified for the Volume Serial (VOL) in the Receive Management Information.
The description in this section is based on the assumption that the Guaranteed Space is NO (default) in the storage class.
When the Guaranteed Space is YES, if you specify a specific volume serial number, files will be created on that volume.