DSM/Tape Catalog Management Programming Manual

RPC Event Messages
DSM/Tape Catalog Management Programming Manual—520481-003
B-14
6 ZRPC-EVT-CREATE-ERR
ZRPC-TKN-NEWPROC-TYPE
indicates the type of process that the PROCESS_CREATE call was attempting to
create:
ZRPC-VAL-BACKUP
indicates that the PROCESS_CREATE call was attempting to create a backup
process for fault tolerance.
ZRPC-VAL-REMOTE
indicates that the PROCESS_CREATE call was attempting to create a remote
process to handle RPC broadcast requests.
ZRPC-VAL-PRIMARY
indicates that the PROCESS_CREATE call was attempting to create a primary
process.
ZRPC-TKN-CREATE-ERR
indicates the PROCESS_CREATE error code, as described in the Guardian
Procedure Calls Reference Manual.
In the message text, proctype corresponds to the value in ZRPC-TKN-NEWPROC-
TYPE. objectfile corresponds to the value in ZCOM-TKN-SUBJ-FILE. create-
err corresponds to the value in ZRPC-TKN-CREATE-ERR. error corresponds to the
Z-ERROR field in ZSPI-TKN-ERROR within the error list. errortext is the error text
that corresponds to the value of the Z-ERROR field in ZSPI-TKN-ERROR within the
error list.
Cause. The most likely cause is that resources were unavailable in the CPU in which
the new process was trying to start. Check the value of ZRPC-TKN-CREATE-ERR for
the specific cause.
Effect. If backup process creation fails, the portmapper continues to run without a
backup. If coprocess creation fails, the RPC broadcast request is dropped.
Recovery. In most cases, the portmapper logs the event and continues running.
Check the value of ZRPC-TKN-CREATE-ERR for the specific cause. Recovery
depends on the cause of the error:
•
If creation of the backup process failed, correct the problem and restart the
portmapper process.
•
If creation of a remote process failed, correct the problem to eliminate future errors.
Restarting the portmapper process should not be necessary.