User`s manual

.DIAGFCN

5-79

.DIAGFCN

Name

.DIAGFCN - Diagnostic routine

Code

$0074

Description

.DIAGFCN is a system-call-like routine, for the diagnostics. This

system call provides the debugger and external software (operating

systems) with a single-point-of-entry to information maintained by

the Þrmware diagnostics.

The .DIAGFCN system call requires a single argument, which is a

pointer to a diagfcn struct. This struct contains an Õunsigned intÕ

which is the number of the diagnostic routine being requested, and

a pointer to arguments for the routine to be executed:

unsigned int DIAGFCN number to execute

char * pointer to function arguments

This system call implements four diagnostic functions:

01: .CHKFCN (check function)

02: .TESTSTAT (output test status report)

03: .MEMSTAT (memory status)

04: .ST_NMLIST (selftest name list)

01: .CHKFCN (check function)

The purpose of this function is to determine whether a given

diagfcn is present in this revision of Þrmware. The argument

pointer in the diagfcn struct simply points to an unsigned int

variable, containing the diagfcn number to test for. If it exists, the

syscall will return zero.