beautypg.com

Rockwell Automation 6008-SI IBM PC I/O SCNNR 6008-SI User Manual

Page 90

background image

Chapter 7

Scanner Management

7-23

xlat_flt

Translate a fault information byte to English. Note that this function
returns correct information only if the SL_IN_SCAN bit is set in the
configuration byte for the same adapter.

Calling sequence:

explan = xlat_flt(

fault

);

Arguments:

fault:

a byte from the array returned by an autoconfigure or link status

call, possibly extracted by the flt_info routine.

Returned values:

a

character

pointer whose object is a string of 28 characters (27 plus the

terminating zero byte) suitable for printing. This pointer points to an
internal buffer whose contents are destroyed by subsequent calls to
xlat_flt.

If the SF_ON_LINE field is nonzero, the first seven characters of the
returned string contain “on_line”; otherwise the string begins with
“faulted”. A space follows either message.

If the SF_IN_FGRP bit is set, the SF_GRP_NUM field is extracted
and the next ten characters of the string contain “flt_grp_#n” where n is
the extracted group number; otherwise the next ten characters contain
“no_flt_grp”.

If the SF_GRP_FLT bit is set, the final nine characters contain a space
and “grp_fltd”; otherwise they are blank.

No tabs or newlines are ever included in the returned string.