YY.DDD IBM DISKETTE CONVERSION UTILITY DISKETTE DRIVE NAME:

RPG Conversion is selected by a Yes to the prompt.

ARE THESE RPGn FILES? YIN

The required service is selected in response to the next query.

SERVICE? F=FORMAT. T=TRANSFER:

12-2 Digital Systems Division

c

•

II>

~---

^~946258-9701 . When format is selected, no further interaction is necessary. The format process is executed to completion and the following messages are displayed.

FORMAT IN PROGRESS.

FORMAT COMPLETE.

The utility will then request the IBM diskette drive name again.

When one of the transfer services is selected, the IBM diskette is checked for proper format and a list of the labels is displayed. When the IBM format is found to be incorrect, a message is displayed and the diskette name request is repeated. (Operator responses are underlined; (C/R) represents a carriage return). Upon responding with a "T" for the transfer function, the following messages are output:

or,

FILEI FILE2

FILE3

All dataset labels on the IBM format diskette are listed.

NOTE

While listing the dataset labels of the IBM formatted diskette, blanks are printed when a dataset is encountered in which the label contains all blanks.

**

DISKETTE NOT IBM FORMAT

**

Specified diskette is not an IBM formatted·

diskette.

At this point, if the format is correct, the program is ready to perform the transfer operation.

The direction of transfer is established by response to the next query.

FUNCTION? F=FILE TO DATASET, D=DATASET TO FILE:

E

12.

Whether or not an "F" or a "D" is selected, the next question asked is:

CHARACTERS PER RECORD? 2 MIN. - 128MAX: 80(C/R)

When only a carriage return is entered, the default value is 80 characters per record, and the prompts for packed decimal are skipped.

ARE THERE ANY PACKED DECIMAL DATA FIELDS? YIN: y n

This prompt appears if the DATASET TO FILE function was selected.

12-3 Digital Systems Division

~---

^~946258-9701 SPECIFY STARTING POSITION IN

RECORD:

SPECIFY ENDING POSITION IN RECORD:

These two prompts appear only as a result of a Y response to the packed decimal prompt. The user inputs the leftmost and rightmost character posi-tion of the packed decimal field. The utility then repeats these prompts until a null value is entered.

Numeric values in the range of 0-128 inclusive are permitted. Numbers need not be justified. Leading and trailing blanks are acceptable.

The field selected here will not be converted by the utility. Binary fields should also be specified.

The TX990 user file pathname and IBM dataset names are requested next:

USER FILE PATHNAME: DSC2:S0URCE/ABC(C/R) DATASET NAME: SOURCE(C/R)

FILE TRANSFER IN PROGRESS ...

Pathname can be defaulted to the first six characters of the dataset name when transfer is dataset , to file; or when transfer is file to dataset, the dataset name can be defaulted to the file name portion of the pathname. The default substitute is specified by a carriage return (C/R) response to the query. Pathnames that are preceded by a colon are defaulted to the system diskette drive. . . When the IBM diskette is not filled at the completion of converting the specified file, IBMUTL requests the record size again.

MOUNT NEXT VOLUME, REPLY "C" WHEN READY: c

TRANSFER COMPLETE:

When reading multivolume diskettes, this message appears at the end of any volume expecting a continuation of another volume. Reply after changing the diskette. Multivolume diskettes cannot be created with this utility.

Many of the preceding prompts will be requested for succeeding volumes.

Indicates successful completion of the transfer function. The utility then prompts for the number of characters per record for the next dataset.

When it is desired to reverse the transfer function or change the drive on which datasets are being accessed, an ampersand (&) symbol reply returns the program to the point where the diskette name is requested:

USER FILE PATHNAME: . &(C/R)

12-4 Digital Systems Division

."-.

c

• c

~---

^~946258-9701 Responding with an ampersand (&) returns program control to the initial user prompt:

DISKETTE DRIVE NAME:

If the user enters an asterisk (*), IBMUTL terminates with the following message;

UTILITY SERVICE TERMINATED 12.6 ERROR REPORTING AND RECOVERY

Errors encountered during execution of IBMUTL are reported to the operator in accordance with table 12-1. Whenever recovery from such errors is possible, the program returns to a logical restart point and continues its function.

12-5 Digital Systems Division

-

a..

Table 12-1. IBMUTL Error Messages Meaning

Specified diskette is not an IBM format diskette.

megal pathname has been entered.

An attempt to exceed the maximum number of datasets (19) allowable per IBM formatted diskette.

Data capacity of IBM format diskette has been exceeded. Last fIle is labeled as an empty dataset and transfer is terminated.

Bad diskette.

Error encountered while accessing TX990 user file. Refer to Error Appendices for error code nn.

Error encountered while accessing IBM dataset.

Refer to Error Appendices for error code nn.

I/O error encountered during program execution.

Refer to Error Appendices for error code nn.

Specified dataset name not found on diskette.

Recovery

Insert a properly formatted diskette in specified drive, or return to diskette name request (enter

"&") and input correct drive name.

Validate pathname and reenter.