beautypg.com

Error codes and messages -3, Error codes and messages, Table 7-2 fal error codes – HP XP20000XP24000 Disk Array User Manual

Page 191

background image

Troubleshooting

7-3

Hitachi USP V Cross-OS File Exchange User’s Guide

Error Codes and Messages

The error information returned by the datasetGetLastError function includes
the FAL error information defined in the dataset.h file. Table 7-2 lists and

describes the FAL error codes and provides instructions for resolving each
error condition. In Table 7-2, the error codes marked by an asterisk (*) may
also be reported when I/O access contention occurs. If the cause of the error

cannot be identified as described in Table 7-2, check for illegal I/O access
contention for the FX volume between the z/OS and open-system hosts.

The FAL error logs for UNIX are /tmp/fal_error and /tmp/fal_error.bak,

and /tmp/fal_dump and /tmp/fal_dump.bak. The FAL logs for Windows
2000/2003/Windows NT systems are c:\fal_error and c:\fal_error.bak, and
c:\fal_dump and c:\fal_dump.bak.

Note: Error codes with a negative value are FAL errors. Error codes with a

positive value are system errors. UNIX system error codes are defined in the
standard error file errno.h.

Table 7-2

FAL Error Codes

Error

Code

Error Message and Description

Recommended Action(s)

-7* DATASET_ERROR_INVALID_VOLUME

The actual VSN and the VSN specified in the FX

volume definition file do not match.

Make sure that the VSN in the FX volume
definition file is correct.

-8 DATASET_ERROR_DATASET_NOT_FOUND

The target dataset was not found.

Make sure that the actual dataset name and the
specified dataset name are the same. You can
use the MF-File list command in the FCU HELP
menu, or VTOC dump data on the z/OS host, to
check the dataset name.

-9 DATASET_ERROR_NOT_SUPPORTED

The data format is not supported.

Make sure that the dataset was created correctly
on the z/OS host.

-10* DATASET_ERROR_DEVICE_TYPE_NOT_SUPPORTED

The device emulation type is not supported.

Make sure that the device emulation type (LVI)
is correct in the FX volume definition file. The
supported LVIs are 3390-3A, -3B and -3C.

-11 DATASET_ERROR_DSORG_NOT_SUPPORTED

The dataset organization type is not supported.

Check the DO type using the MF-File list
command in the FCU HELP menu, or VTOC
dump data on the z/OS host.

-12 DATASET_ERROR_RECFM_NOT_SUPPORTED

The record format is not supported.

Check the RF type using the MF-File list
command in the FCU HELP menu, or VTOC
dump data on the z/OS host.

-13* DATASET_ERROR_INVALID_DATA

The data in the VTOC or the dataset is invalid.

Make sure that the VTOC and dataset were
created correctly on the z/OS host.

-14* DATASET_ERROR_VOLUME_DEFINITION_INVALID

The format of volume definition file is invalid.

Make sure that the FX volume definition file was
created correctly.

-15 DATASET_ERROR_DATASET_NOT_OPENED

An attempt was made to read the dataset without

opening it.

Make sure that the datasetOpen function is
called before the datasetGet function.