SHARED PROCESSOR MAINTENANCE
OHSP COMMAND SUMMARY
Table 41 contains a summary of commands for the DRSP pro-cessor. The left-hand column specifies the format and the right-hand column defines the function.
Table 39. DRSP Error Messages is entered/replaced on non-" PERM" basis.
104 Shared Processor Maintenance
Table 39. DRSP Error Messages (cont.)
Message Meaning
DONIT USE COMMAND ON ENTER or DELETE commands must not specify the proname ITELI or ICCII.
TEL/CCI
DRSP I/O ERROR IN READING Error detected in reading DRSP command.
COMMAND
DRSP I/O ERR/ ABN (CLOSE) Error or abnormal condition detected at CLOSE of output file. The processor is entered/replaced on non-" PERM" basis.
DRSP M:BO ERROR (PERM) I/O error detected while writing or closing the output file in :SYS. The processor is entered/replaced on non-" PERM" basis.
DRSP M:EI ERROR (PERM) I/O error detected while reading file fide The processor is entered/replaced on non-" PERM" basis.
DRSP M:EI ERROR I/O error detected while reading fid for writing on the swap disk.
(WRITESWAP)
DRSP PROGRAM ERROR DRSP detected contradictory conditions during processing. Requires system (SHOULDN'T HAPPEN) programmer intervention.
ERR MSG NOT FOUND. No error message corresponds to the error code xxxxxx generated. Please KEY
=
xxxxxx report thi s system error.FID IS NOT A LOAD MOD ULE Error or abnormal return executed while trying to read the TREE record of the load module specified by fide
FILE STORAGE LIMIT IN When writing the load module into the :SYSaccount for the PERM option, the SYSTEM ACCOUNT file space for that account is exceeded.
ILLEGAL COMMAND Command entered is not defined in DRSP.
ILLEGAL COMMAND OPTION An optional parameter typed in the command is not recognized.
ILLEGAL INDEX RANGE Index specified in LIST/LISTALL command not within legal range of processor name table.
ILLEGAL" LMN (LOAD Illegal load bias detected when processor written to swap disk.
BIAS CHECK)
ILLEGAL PRONAME, NOT A processor flagged as a publ ic library must conform to the name format :Pnn.
:PNN FORMAT
ILLEGAL PROTECTION TYPE The load module for a publ ic library must be root only and procedure only.
FOR PUBLIC LIBRARY
INCORRECT FID The fid specified exceeds the field maximum for name (15 characters) or account (8 characters) or password (8 characters).
INSUFFICIENT MEMORY TO DRSP has failed to acquire enough memory to read the largest record of the READ MAX RECORD OF FID load module specified as fide
INSUFFICIENT MEMORY Memory space available to user is not sufficient to process the load module TO READ TREE specified in the ENTER or REPLACE commands.
INSUFFICIENT PRIVILEGE The user must have a privilege level of 80 or greater to execute any DRSP
FOR DRSP USAGE commands~
Shared Processor Me i ntenance 105
Table 39. DRSP Error Messages (cont.)
Message Meaning
INSUFFICIENT PRIVILEGE The user does not have sufficient privilege of CO to process ENTER, REPLACE, LEVEL TO PROCESS THIS and DELETE commands.
COMMAND
INSUFFICIENT SPACE ON The disk space allotted for new or replaced load modules is too small for the
SWAP RAD load module specified.
INS UFFICIE NT VIRTUAL There are not enough virtual pages to allow DRSP to access the monitor.
MEMORY TO EXECUTE DRSP
NO ERRORS No errors were encountered during command execution.
NO PRONAME SLOTS AVAILABLE The number of extra processor name table entries is exhausted.
NO SUCH PROCESSOR The proname entered cannot be found in the processor tables.
ONLY ONE LEVEL OF OVERLAYS When analyzing the load module TREE record, more than one level of processor FOR SHARED PROCESSORS overlay was indicated.
ONL Y PROCEDURE IS ALLOWED DRSP checks a load module specified as an overlay for procedure only.
IN A PROCESSOR OVERLAY
OVLY LINK EXCEEDS TABLE A system error to be reported.
LIMIT
PROCESSOR OVERLAY SLOTS There are not enough empty processor overlay locations in the name table to EXHAUSTED fill the load module requirement. This check on the name table occurs during
the write to the swap disk.
PROCESSOR/OVERLA Y User tried to ENTER a processor or overlay name that exists in the table.
ALREADY EXISTS
PRO NAME IS ILLEGAL Some routine cannot be entered or replaced with DRSP (e. g., XDEL TA, RECOVER, GHOSTl, ALlOCAT, M:DUMlM).
PRONAME REQUIRED A program must be specified with the ENTER, REPLACE, and DELETE commands.
RAD OVERFLOW Disk space allotted for the shared processors is exhausted.
READ ERROR READING I/O error detected while trying to read the processor for the copy into the
FID (COPY) system account.
SWAP I/O ERROR (QUEUE) I/O error detected while writing processor to the swap disk.
WRITE ERROR WRITING I/O error detected while trying to write the processor into the system account.
FID (COPY) The processor is entered/replaced on non-II PERMII basis.
WRITE RAD FILE I/O ERRORS I/O error detected while writing the processor to the swap disk.
Table 40. DRSP Information Messages
Message Meaning
DRSP HERE Routine title typed when user first enters DRSP.
DRSP INHIBIT SET Another user is manipulating the shared processor tables and prevents any other user executing the ENTER, REPLACE, and DELETE commands. However, the LIST and LISTALL commands can be executed at any time.
106 Shared Processor Maintenance
Table 40. DRSP Information Messages (cont.)
Message Meaning
fid NEEDS xxxx GRANULES If DRSP cannot find sufficient disk space in any available slot, it feeds back to the user the number of granules required to enter/replace the new load module.
proname REPLACED IN RAD While exercising the II PERMII option, the proname in slot #x has been SLOT #x replaced by the proname specified in the current command.
PRO NAME FOUND ON RAD The proname already exists in the disk version of the processor tables when DRSP tries to execute the ENTER, PERM option. The II PERMII function is completed for the new copy.
PRONAME NOT FOUND ON RAD The proname cannot be found in the disk version of the processor tables when DRSP tries to execute the REPLACE, PERM option. The II PERMII function is compl eted for the new copy.
USERS ASSOCIATED DRSP attempts to replace TEL or CCI but finds there are users associated. The message is repeated periodically as long as users remain associated.
Table 41. DRSP Command Summary
Command Description
D[ELETE] proname ,[PERM] Prevents further user association with a processor.
END Exits normally from DRSP.
[FROM}
01
E[NTER] proname WITH fld Ente~s a new shared processor into the system.
[, optionI, option][, option]
L[IST]{proname} Lists the processor name, the name table index, and the amount of disk
#xx[-yy]
space occupi ed by the processor.
LISTALL{proname}
#xx[-yy] Lists each shared processor name and its entries in certain tables.
R[ EPLAC EJ proname [{
:~~}
fid] Replaces an existing shared processor with a new shared processor.[, option][, option][, option]
? Requests a detai led error message when an error has been noted by DRSP.
Shared Processor Maintenance 107
8. ON-LINE PERIPHERAL DIAGNOSTIC FACILITIES
INTRODUCTION
This chapter describes the system faci lities that are designed for use by Xerox in the development of peripheral hardware diagnostic programs. The system procedures and the Diag-nostic DCB described in this chapter should never be used in any user-written programs. Their description is included in this manual only for completeness of documentation. Any program that uses them may seriously affect the operation and integrity of the system.
The facilities described in this chapter are used in the fol-lowing types of Xerox processors:
• Functional tests for peripheral devices that isolate hard-ware problems to the lowest possible level.
• Exercisers that verify that the peripherals are operat-i ng correct I y •
• Preventive maintenance tests that reduce the amount of time that peripherals are down for repair.
These tests and exercisers may be run at an on-line terminal while the CP-V system is in normal operation.
The facilities described in this chapter include one assem-bler directive, the special Diagnostic DCB (DDCB), and eight system procedures. The assembler directive allows the user to specify that a control section is to begin at a page boundary. The Diagnostic DCB is a data area that allows the user to issue his own I/O commands.
These eight procedures reside in SYSTEM DIAG along with two other system procedures - M:D PART and D :DRET.
(M:DPART and M:DRET are described in the SYSCON chap-ter in the CP-VjSM Reference Manual, 90 1674, because they are used by SYSCON.) The eight system procedures perform the following functions:
Procedure M:DDCB
Function
Generates a diagnostic data control block.
M:DOPEN Opens the device associated with the Diagnostic DCB for diagnostic purposes.
M:DCLOSE Terminates and inhibits all I/O associated with the Diagnostic DCB.
108 On-Line Peripheral Diagnostic Facilities
Procedure
Converts a specified virtual address to a physical address or a specified physical address to a virtual address.
Obtains the controller model number, the device model number, and the type mnemonic associated with a given de-vice address.
RESTRICTIONS
For both security and system performance reasons, there are certain restrictions on the use of the facilities described in this chapter. These restrictions are:
1. The system manager must give approval before the
The PSECT directive specifies that the control section which follows is to begin on a page boundary. This directive allows diagnosticians to ensure that such things as the Diagnostic DCB and buffers do not cross page boundaries. The PSECT directive is described in detai I in the Meta-Symbol/LN, OPS Reference Manual, 900952.