In this topic, we described about the Introduction with detailed example.
IEBGENER is for copying Physical Sequential filesand members of PDSs or PDSEs. IEBGENER can be used to convert sequential files to PDS and PDS to sequential. IEBGENER copy can handle the record lengths up to 32760 bytes.
If the record length is greater than 32760, records will be truncated. The below are the list of tasks can be done by IEBGENER,
- Create a backup copy of a sequential data set, a member of a PDS or PDSE or a HFS file(z/OS UNIX).
- Produce a PDS or PDSE, or a member of a PDS or PDSE, from a sequential data set or a z/OS UNIX file.
- Expand an existing PDS or PDSE by creating partitioned members and merging them into the existing data set.
- Produce an edited sequential or PDS or PDSE.
- Manipulate data sets containing double-byte character set data.
- Print sequential data sets, members of PDS or PDSEs or z/OS UNIX files.
- Reblock or change the logical record length of a data set.
- Copy user labels on sequential output data sets.
If the DFSORT product installed, ICEGENER can be an alternative to IEBGENER when making an unedited copy of a data set or member.
IEBGENER returns a code in register 15 to indicate the results of program execution. The return codes and their meanings are:
|00 (X'00')||Successful completion.|
|04 (X'04')||Successful completionwith a warning message.|
|08 (X'08')||DBCS error was encountered.|
|12 (X'0C')||An unrecoverable error exists or a DBCS error was encountered.|
Job execution will be stopped
|16 (X'10')||A user specified return code. |
The utility execution ends.
IEBGENER uses input input is either a sequential data set or a member of a PDS or PDSE. IEBGENER uses the output data set can be either a new data set or an existing data set.
The dataset can be a sequential data set or a PDS or PDSE that will be expanded. The below are the tasks that can be done by IEBGENER and will discuss in detail.
- Control Statements
- Creating a Backup Copy
- Producing a PDS or PDSE from Sequential Input
- Adding Members to a PDS or PDSE
- Producing an Edited Data Set
- Changing Logical Record Length