DIRMIG Program Error Messages [ Migration Process Guide ] MPE/iX 5.0 Documentation
Migration Process Guide
DIRMIG Program Error Messages
Two classes of errors can occur during directory migration:
* Corruption identified within the directory being ported
* Operating system errors
Directory Corruption
Directory corruption errors are posted to DIRLOGnn which contains a
directory path displaying the sector of the corrupt data structure.
If any accounts were not successfully migrated, examine DIRLOGnn.PUB.SYS
for error messages. Each error message is accompanied by a description
of the condition which caused the error, as well as a description of
recommended actions to take for error recovery.
Operating System Errors
Operating system errors generated by the directory service routines will
be posted to DIRLOGnn.
DIRMIG will attempt to provide conclusive error messages if these errors
occur.
If errors occur, the following rules apply:
1. If an error occurs during the creation or altering of an account,
the users and groups will not be migrated. Also, volume set
information will not be saved to PVASSIST.PUB.SYS.
2. If an error occurs during the creation or alteration of a group,
the remaining groups for that account are not migrated. DIRMIG
will attempt to migrate the users, however. Volume set
information for that group and all remaining groups will not be
saved to PVASSIST.PUB.SYS.
3. If an error occurs while DIRMIG is creating a user or altering the
user of an account, the remaining users for that account are not
created.
4. If the account is created or altered successfully, users are
guaranteed to have at least a PUB group. If the account was
created, the user MGR will be on the system. If the account was
altered, it is assumed that previous users will remain on the
system.
Error Recovery
If any corrupted objects exist on the SYSDUMP tape, corrective action
will have to be taken on the MPE V/E system from which the tape was made.
Contact your Hewlett-Packard Support Representative for assistance.
Any object not migrated to the MPE/iX system may be created via MPE/iX
commands. The following MPE/iX and MPE V/E commands are useful for
creating objects not successfully migrated by DIRMIG:
MPE V/E, MPE/iX MPE XL ONLY MPE V/E ONLY
---------------------------------------------------------------------------------------
:NEWACCT :VOLUTIL :SYSDUMP
:ALTACCT :SYSGEN :RELOAD
:NEWGROUP :INSTALL
:ALTGROUP
:NEWUSER
:ALTUSER
:PURGEACCT
:PURGEGROUP
:PURGEUSER
:LISTACCT
:LISTGROUP
:LISTUSER
:FREERIN
:GETRIN
:RELLOG
:GETLOG
:SETCATALOG
* If RESTORE of the MPE V/E COMMAND.PUB.SYS fails, the original
MPE/iX UDC environment, if one existed, will remain intact on the
system. The UDC and user file migration will terminate.
* If the open of COMMAND.PUB.SYS (tape) fails, the MPE/iX UDC
environment will remain intact. If UDC files were successfully
restored, log on to each user, and use :SETCATALOG.
* If RESTORE of UDC files or user files fails, study the SYSLIST for
errors. The original MPE/iX UDC environment will remain intact.
If UDC environment modifications were successful, the UDC files
may be restored when DIRMIG completes execution. If there are
disk space errors, adjustments to the disk space can be made when
DIRMIG terminates. The user can :SETCATALOG as necessary to
complete the UDC migration process.
* If UDC modification not successful, examine the current
DIRLOGnn.PUB.SYS file for additional information. Troubleshoot as
necessary
* If UDC modifications are successful, but the UDC environment does
not exist, the UDC files will probably exist on the system. When
DIRMIG terminates, use :SETCATALOG commands on the MPE/iX-based
system to complete the migration process. Examine the current
DIRLOGnn.PUB.SYS file for additional information. Troubleshoot as
necessary.
Error Messages Returned by DIRMIG
Following is a list of DIRMIG error messages. Each error message is
followed by a description of the condition which causes the error and a
description of the recommended action for the user. The following error
number groupings identify the tasks being performed at the time of the
error.
1001 to 1999 Main DIRMIG Errors
2001 to 2999 SYSDUMP Tape Errors
3001 to 3999 RIN Migration Errors
4001 to 4999 User-Logging ID Migration Errors
5001 to 5999 Directory Migration Errors
6001 to 6999 Private Volume Migration Errors
7001 to 7999 UDC Migration Errors
NOTE Error messages 5020, 5021, and 5022 are multi-line directory
migration errors that provide special detail. They are described
in the following section "Directory Corruption Error Messages".
1001 MESSAGE LOGON MUST BE MANAGER.SYS,PUB.(DIRERR 1001)
CAUSE The user is not logged on as MANAGER.SYS,PUB.
ACTION The user should log on as MANAGER.SYS,PUB, and run
DIRMIG.PUB.SYS again.
1002 MESSAGE THIS PROGRAM REQUIRES SYSTEM SUPERVISOR (OP) CAPABILITY.
(DIRERR 1002)
CAUSE The user does not have System Supervisor (OP) capability.
ACTION The user should provide MANAGER.SYS,PUB with OP capability and
run DIRMIG.PUB.SYS again.
1003 MESSAGE ALL JOBS AND SESSIONS MUST BE LOGGED OFF.(DIRERR 1003)
CAUSE With the exception of MANAGER.SYS,PUB, all jobs and sessions
are not logged off.
ACTION The user should log off all jobs and sessions, and run
DIRMIG.PUB.SYS again.
1004 MESSAGE UNABLE TO OBTAIN NEXT LOGFILE SEQUENCE NUMBER FOR
DIRLOGnn.PUB.SYS.(DIRERR 1004)
DIRMIG LOGGING FACILITY DISABLED. CONTINUE (YES/[NO]) ? >>
CAUSE DIRMIG increments the current log file sequence number with
each run. In this case, a file system error occurred while
determining the next log file sequence number from the existing
log files.
ACTION DIRMIG is unable to create a log file for tracking the
migration process. The user has the option of (not) continuing
with the migration. If the user enters YES, DIRMIG will
continue. Messages normally logged to DIRLOGnn.PUB.SYS will be
displayed to $STDLIST. If the user enters NO, DIRMIG will
terminate. The user should note the file system error message
displayed and troubleshoot accordingly.
Table G-0. (cont.)
1005 MESSAGE CURRENT LOGFILE SEQUENCE NUMBER EQUALS MAXIMUM SEQUENCE
NUMBER ALLOWED (99) FOR DIRLOGnn.PUB.SYS. (DIRERR 1005) DIRMIG
LOGGING FACILITY DISABLED. CONTINUE (YES/[NO]) ? >>
CAUSE DIRMIG increments the current log file sequence number with
each run. The sequence numbers range from 01 through 99. In
this case, DIRLOG99.PUB.SYS exists on the system and DIRMIG is
unable to increment the sequence number.
ACTION DIRMIG is unable to create a log file for tracking the
migration process. The user has the option of (not) continuing
with the migration. If the user enters YES, DIRMIG will
continue. Messages normally logged to DIRLOGnn.PUB.SYS will be
displayed to $STDLIST. If the user enters NO, DIRMIG will
terminate. The user should then remove all DIRLOGnn files from
PUB.SYS running DIRMIG again.
1007 MESSAGE UNABLE TO DISPLAY LISTING OFFLINE LIST FILE NOT SUCCESSFULLY
OPENED (DIRERR 1007)
CAUSE DIRMIG did not successfully open file LIST for redirecting
output offline. Device class LP does not exist and the user
did not redirect file LIST to a configured device or class; or
the user entered an invalid equation for LIST.
ACTION Before running DIRMIG, the user should configure device class
LP or issue a valid file equation for the formal file
designator LIST.
1016 MESSAGE UNABLE TO OBTAIN JOB/SESSION INFORMATION. JOBINFO INTRINSIC
ERROR:#n (DIRERR 1016)
CAUSE DIRMIG is unable to check number of jobs and sessions logged on
to an error return from the JOBINFO intrinsic.
ACTION The user should look up the JOBINFO intrinsic error return in
the MPE/iX Intrinsics Reference Manual (32650-90028) and
troubleshoot accordingly.
1017 MESSAGE UNABLE TO OBTAIN DATE AND TIME INFORMATION. (DIRERR 1017)
NLFMTDATE INTRINSIC ERROR:#n.
CAUSE DIRMIG calls the NLFMTDATE intrinsic to display date and time
in the appropriate language.
ACTION The user should look up the indicated NLFMTDATE intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
Table G-0. (cont.)
1018 MESSAGE UNABLE TO OBTAIN NATIVE LANGUAGE SUPPORT LANGUAGE ID.
(DIRERR 1018) NLGETLANG INTRINSIC ERROR #n. NATIVE-3000
LANGUAGE ID WILL BE USED''
CAUSE DIRMIG calls the NLGETLAND intrinsic to obtain the
user-interface language ID. This error usually occurs when the
NLUSERLANG JCW is set to a language that is not configured on
the MPE/iX system.
ACTION The user should look up the indicated NLGETLANG intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
1019 MESSAGE UNABLE TO OBTAIN NATIVE LANGUAGE INFORMATION. (DIRERR 1019)
NLINFO INTRINSIC ERROR: #n.
CAUSE DIRMIG is unable to obtain the appropriate NLS upshift
information table (NLINFO item number 15) or the appropriate
YES/NO language string (NLINFO item number 8).
ACTION The user should look up the NLINFO intrinsic error reported in
the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
1020 MESSAGE DIRMIG INTERNAL ERROR WHILE READING INPUT. (DIRERR 1020).
NLSCANMOVE INTRINSIC ERROR:#n.
CAUSE DIRMIG attempts to upshift user input using the NLSCANMOVE
intrinsic and bad status was returned.
ACTION The user should look up the indicated NLSCANMOVE intrinsic
error in the Native Language Programmer's Guide (32650-90022)
and troubleshoot accordingly.
Table G-0. (cont.)
1021 MESSAGE UNABLE TO REPLACE UNPRINTABLE CHARACTERS WITH '' (DIRERR
1021) NLREPCHAR INTRINSIC ERROR:#n.
CAUSE DIRMIG calls the NLREPCHAR intrinsic to replace unprintable
characters with a period ('.') within a string before the
string is printed. NLREPCHAR is called before printing or
logging a string suspected of being corrupt.
Note: DIRMIG verifies strings of alphanumeric names such as
RIN entries, user-logging identifiers, and all
directory-related names before performing their migration.
ACTION The user should look up the indicated NLREPCHAR intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
(logged only)
1022 MESSAGE UNABLE TO CREATE STORE.PUB.SYS PROCESS. (DIRERR 1022)
CREATEPROCESS INTRINSIC ERROR:#n
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
create the STORE.PUB.SYS process.
ACTION The user should look up the indicated CREATEPROCESS intrinsic
error in the Intrinsics Reference Manual (32650-90028) and
troubleshoot accordingly.
(logged only)
1002 MESSAGE UNABLE TO LOG MESSAGE SET=set# ,MSG=msg#. (DIRERR 1031)
CATREAD INTRINSIC ERROR:#n.
CAUSE DIRMIG is unable to log the message desired because a read
error occurred on the DIRMIG catalog file; the set or message
number specified was not found in the file; or an internal
message facility error occurred.
ACTION The user should look up the indicated CATREAD intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
Table G-0. (cont.)
1032 MESSAGE UNABLE TO DISPLAY MESSAGE:SET=set#,MSG=msg#. (DIRERR 1032)
CATREAD INTRINSIC ERROR:#n.
CAUSE DIRMIG is unable to display the message desired because a read
error occurred on the DIRMIG catalog file; the set or message
number specified was not found in the file; or an internal
message facility error occurred.
ACTION The user should look up the indicated CATREAD intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
(hardcoded message)
1033 MESSAGE UNABLE TO OPEN DIRMIG CATALOG FILEfilename. (DIRERR 1033)
NLAPPEND INTRINSIC ERROR;#n.
CAUSE DIRMIG is unable to append the NLS language ID (nnn) to the
catalog file name, so it is unable to open the appropriate
message catalog file.
ACTION The user should look up the indicated NLAPPEND intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
(hardcoded message)
1034 MESSAGE UNABLE TO CLOSE DIRMIG CATALOG FILE filename. (DIRERR 1034)
CATALOG INTRINSIC ERROR:#n.
CAUSE DIRMIG is unable to close the message catalog file,
DRCATnnnPUB.SYS.
ACTION The user should look up the indicated CATCLOSE intrinsic error
in the Native Language Programmer's Guide (32650-90022) and
troubleshoot accordingly.
(hardcoded message)
Table G-0. (cont.)
1042 MESSAGE UNABLE TO OBTAIN VIRTUAL ADDRESS OF DST. (DIRERR 1042).
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
migrate system table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
(logged only)
1043 MESSAGE UNABLE TO OBTAIN RIN TABLE SIR. (DIRERR 1043)
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
migrate system table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
(logged only)
1044 MESSAGE UNABLE TO OBTAIN DST SIZE. (DIRERR 1044).
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
migrate system table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
(logged only)
1045 MESSAGE UNABLE TO ALTER DST SIZE. (DIRERR 1045).
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
migrate system table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
(logged only)
Table G-0. (cont.)
1046 MESSAGE UNABLE TO RELEASE RIN TABLE SIR. (DIRERR 1046).
CAUSE An MPE/iX internal error occurred while DIRMIG was trying to
migrate system table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
2001 MESSAGE INVALID FILE SPECIFICATION FOR"MIGTAPE". (DIRERR 2001)
UNABLE TO CONTINUE WITH MIGRATION.
CAUSE The user did not specify a file equation for MIGTAPE and device
TAPE does not exist, or the user has specified a file equation
for MIGTAPE with invalid parameters.
ACTION The user should configure device class TAPE for a magnetic tape
or issue a valid file equation for MIGTAPE.
2002 MESSAGE INVALID MPE SYSDUMP TAPE - INVALID CHECKSUM. (DIRERR 2002)
UNABLE TO CONTINUE WITH MIGRATION.
CAUSE The tape mounted by the user is not a valid MPE V/E SYSDUMP
tape. It could be a scratch tape or a bad SYSDUMP tape.
ACTION The user should make sure the correct MPE V/E SYSDUMP tape is
mounted, or the user should mount a different MPE V/E SYSDUMP
tape.
2003 MESSAGE DIRECTORY INFORMATION NOT FOUND ON TAPE. (DIRERR 2003)
MIGRATION NOT POSSIBLE FROM THIS TAPE SET.
CAUSE The MPE V/E SYSDUMP tape does not contain accounting structure
information because a carriage-return SYSDUMP was performed to
create the tape.
ACTION The user should mount a different MPE V/E SYSDUMP tape making
sure it is a full or partial backup SYSDUMP tape (that is,
ensure that the tape is not a carriage-return SYSDUMP tape).
Table G-0. (cont.)
2004 MESSAGE MPE SYSDUMP TAPE IS NOT FROM AN MPE V/E-BASED SYSTEM. (DIRERR
2004) MIGRATION NOT POSSIBLE FROM THIS TAPE SET.
CAUSE The MPE V/E SYSDUMP tape was generated on a system which is not
running the appropriate MPE V/E-based software defined as the
base for migration to MPE iX.
ACTION The user should update their system to the appropriate MPE
V/E-based version and generate a new MPE V/E SYSDUMP tape to be
used by DIRMIG. Contact your Hewlett-Packard Support
Representative for alternatives and for information about
migration consulting services.
2005 MESSAGE INCONSISTENT DIRECTORY SIZES FOUND ON MPE SYSDUMP TAPE.
(DIRERR 2005)
CAUSE DIRMIG performs an integrity check on the configuration value
for the directory size and found inconsistent values,
signifying possible tape corruption.
ACTION The user should mount a different MPE V/E SYSDUMP tape.
(logged only)
2006 MESSAGE ERROR OCCURRED WHILE READING MPE SYSDUMP TAPE. (DIRERR 2006)
UNABLE TO CONTINUE WITH MIGRATION. REFER TO DIRLOGnn.PUB.SYS.
CAUSE A file system error occurred while reading the MPE V/E SYSDUMP
tape.
ACTION The user should check the indicated log file for the exact file
system error message and troubleshoot accordingly.
2007 MESSAGE ERROR OCCURRED WHILE CREATING DIRINFO.PUB.SYS. (DIRERR 2007)
UNABLE TO CONTINUE WITH MIGRATION. REFER TO DIRLOGnn.PUB.SYS
CAUSE A file system error occurred while creating DIRINFO.PUB.SYS,
the temporary file built by DIRMIG to hold the directory
information migrated. DIRMIG was unable to open, close, or
write the directory information to DIRINFO.PUB.SYS, or a file
system error occurred reading directory information from the
MPE V/E SYSDUMP tape.
ACTION The user should check the indicated log file for the exact file
system error message and troubleshoot accordingly.
Table G-0. (cont.)
2008 MESSAGE ERROR OCCURRED WHILE CREATING DIRMIG TABLES. (DIRERR 2008)
UNABLE TO CONTINUE WITH MIGRATION. REFER TO DIRLOGnn.PUB.SYS
CAUSE DIRMIG was unable to allocate the temporary table space it
required for the MPE global RINs or the MPE user-logging IDs.
ACTION The user should check the indicated log file for the specific
error and refer to the action recommended for that error.
Report the MPE/iX error information to your Hewlett-Packard
Support Representative and troubleshoot accordingly.
2009 MESSAGE UNABLE TO CREATE TEMPORARY RIN TABLE OBJECT. (DIRERR 2009)
CAUSE An MPE/iX internal system error occurred while DIRMIG was
trying allocate temporary space it required for MPE V system
table information.
ACTION The user should report the error message and MPE/iX status
information to their Hewlett-Packard Support Representative.
(logged only)
MPE/iX 5.0 Documentation