Librarian LIBRCOPY is failing with message LIBC011E

Products

• Librarian

Issue/Introduction

Cannot find any information on the LIBRCOPY error message LIBC011E -

       LIBC011E FAIROPN FAILED FOR DESTMAST; RC = 11  

 

 

Environment

Release 4.4 

Resolution

LIBRCOPY is an User Contributed Routine (UCR) and its messages are not documented in the Librarian guides.

However, the LIBC011E message indicates that the problem is in the FAIROPN routine and reason for the failure is given in the RC which is documented is in "FAIROPN Result Area (OPENRES)" in the Librarian "File Access Interface Routines" section of the doc.

Here is a sample of how to interpret the RC.

For message: LIBC011E FAIROPN FAILED FOR DESTMAST; RC = 11 -

First, the RC has to be split  into the OPENRET and OPENREA values. 

The first digit is OPENRET and the second digit is OPENREA.

In this case, both are 1 -  OPENRET =1   and OPENREA = 1

Here is the relevant part from   "FAIROPN Result Area (OPENRES)" :

...                                                                   
00  OPENRET  One byte indicating how FAIROPN processing ended. The possible
             values are:              
...
             = C'1' FAIROPN found that the master file was invalid or the
             user is not authorized.
...
01  OPENREA  One byte indicating the reason for any failure of FAIROPN
             processing. The caller uses this digit only if the digit at
             OPENRET is C'1' or C'2'. If it is not, then FAIR sets this field
             to C'0'.
             If the value of OPENRET is C'1', the possible values for OPENREA
             are:
...
             = C'1' FAIROPN tried to open a disk master file, but the master
             file format was invalid.
...

 

The Master file being opened is not a valid Librarian Master file.