addfrub_src

Editar en línea

Finalidad

Concluye una colección de unidades de sustitución de campo (FRU) con un código de referencia del sistema (SRC) específico de la plataforma.

Sintaxis


#include     <diag/da.h>

int addfrub_src (fptr)
struct fru_bucket_src *fptr;

Descripción

La subrutina addfrub_src asocia una colección de FRU con una anomalía detectada por el dispositivo que se está probando actualmente. La clase de objeto TMInput identifica el dispositivo que se está probando actualmente.
Nota: addfrub() debe utilizarse al notificar un número de solicitud de servicio (SRN). Se debe llamar a insert_frub() antes de addfrub() para rellenar algunos de los datos de fru_bucket . addfrub_src() debe utilizarse al notificar un código de referencia del sistema (SRC). A continuación, el llamante debe rellenar todo el contenido de fru_bucket_src antes de llamar a addfrub_src(), por lo que no hay ninguna llamada correspondiente a insert_frub para fru_bucket_src.

Parámetros

Parámetro Descripción
fptr Puntero a una estructura de tipo fru_bucket_src, que se define a continuación. Se debe rellenar toda la estructura antes de llamar a addfrub_src. Los valores opcionales o desconocidos deben establecerse en NULL (0).

struct fru_bucket_src
{
                char  dname[NAMESIZE];  /* Resource Name */
                char  src[RPA_SRC_SIZE_NN];/* Primary reference code */
                unsigned int  refc2;    /* Extended reference code - word 2 */
                unsigned int  refc3;    /* Extended reference code - word 3 */
                unsigned int  refc4;    /* Extended reference code - word 4 */
                unsigned int  refc5;    /* Extended reference code - word 5 */
                unsigned int  refc6;    /* Extended reference code - word 6 */
                unsigned int  refc7;    /* Extended reference code - word 7 */
                unsigned int  refc8;    /* Extended reference code - word 8 */
                unsigned int  refc9;    /* Extended reference code - word 9 */
                int   rmsg;     /* Failure description */
                char  crid[2];  /* Platform error creator id */
                unsigned int  plid;     /* Platform Log Id */
                unsigned int  subsysid; /* Subsystem Id */
                unsigned int  event_sev;/* Event Severity */
                int   action_flags;     /* Error Action Flags */
                int   errlg_seq;        /* Error Log Sequence Number */
                frus_src_t *frus;       /* Linked list of FRUs for SRC */
};
nombre_d Nombra el dispositivo que se está probando.
src Código de referencia del sistema. El código de referencia primario es el 1st 8 caracteres de esta serie de 32 caracteres. El código de referencia primario es obligatorio, el resto de la serie es opcional.
refc2 Palabra de código de referencia ampliado 2 (obligatorio).
refc3 - refc9 Palabras adicionales opcionales del código de referencia ampliado 3-9. Debe ser 0 si no está presente.
msjr Número de mensaje del texto que describe la anomalía. El número establecido del texto está predefinido por el campo PSet en la clase de objeto de recursos de diagnóstico predefinido.
crid Carácter ASCII que representa el subsistema que crea el registro de errores que informa de la anomalía. Utilice NULL (0) si esta anomalía no procede del análisis del registro de errores de la plataforma.
id_plid Identificador exclusivo para esta anomalía.
subsysid ID de subsistema de registro de errores de plataforma; de lo contrario, 0.
sev_suceso Gravedad de registro de errores de plataforma; de lo contrario, 0.
distintivos_acción Marca la definición de la acción de creación de informes para esta anomalía. Los valores pueden estar o pueden estar juntos.
Bit
Acción
RPA_REPORT_EXTERNAMENTE
Notifique esta anomalía a programas externos como Service Focal Point.
RPA_CALL_HOME_REQD
Solo es válido con RPA_REPORT_EXTERNALLY, esta anomalía se debe notificar automáticamente al servicio IBM® .
NO_INDICADOR
Si el plid es cero y este bit está establecido, el indicador de error del sistema no se activará para esta anomalía.
errlg_seq Número de secuencia de registro de errores del error de origen.
frus Lista enlazada opcional de FRU tal como se describe en la estructura siguiente. Esta lista no es necesaria si el SRC describe completamente las acciones de anomalía y resolución.

typedef struct frus_src
{
        int   type;             /* RPA FRU type */
        char  priority;         /* RPA FRU/Procedure Priority */
        char  loc[RPA_LOC_SIZE];/* Physical location code */
        char  pn[RPA_FRU_PN_SIZE];      /* FRU Stocking p/n */
        char  proc_id[RPA_PROC_SIZE];   /* Procedure Id */
        char  ccin[RPA_CCIN_SIZE_NN];   /* CCIN */
        char  sn[RPA_FRU_SN_SIZE_NN];   /* FRU Serial Number*/
        struct frus_src *next_fru;
} frus_src_t;
tipo Tipo de FRU. Uno de los siguientes:
RPA_FRUTYPE_NORMAL
FRU de hardware normal.
CÓDIGO_FRUTYPE_RPA_FRUTYPE_CODE
FRU de código descrita por campo de ID de procedimiento.
RPA_FRUTYPE_C_PROC
Es necesario el procedimiento de configuración.
RPA_FRUTYPE_M_PROC
Se requiere un procedimiento de mantenimiento.
RPA_FRUTYPE_EXT
FRU externa.
CÓDIGO_EXT_FRUTYPE_RPA_FRUTYPE_CODE
FRU de código externo descrita por campo de procedimiento.
RPA_FRUTYPE_TOOL
Una herramienta que necesita otra FRU de la lista.
RPA_FRUTYPE_SYMBOL
ID de procedimiento para adquirir o trabajar con una FRU.
prioridad Sustitución de FRU/Prioridad de procedimiento. Uno de los siguientes:
H
Llamada obligatoria y de alta prioridad. La sustitución de la FRU o la realización del procedimiento es obligatoria. Las llamadas múltiples con prioridad de H deben actuarse como un grupo.
M
Prioridad media. Cada FRU/Procedimiento con prioridad de M debe actuarse, de uno en uno, en el orden indicado.
A
Grupo de prioridad media A. Cada FRU/Procedimiento con prioridad A debe actuarse como un grupo.
B
Grupo de prioridad media B. Cada FRU/Procedimiento con prioridad B debe actuarse como un grupo.
C
Grupo de prioridad media C. Cada FRU/Procedimiento con prioridad C debe actuarse como un grupo.
L
Prioridad baja. Cada FRU/Procedimiento con prioridad L debe actuarse sólo después de que todas las demás llamadas de prioridad no hayan podido resolver el problema.
loc Código de ubicación
pn Número de pieza en existencias de FRU si está disponible, mutuamente excluyente con proc_id.
id_proc ID de procedimiento si está disponible, mutuamente excluyente con pn.
ccin CCIN, si está disponible y sólo si pn está disponible.
sn Número de serie de FRU, si está disponible, y solo si está disponible pn .
fr_siguiente Puntero a la siguiente estructura frus_src .

Valor de retorno

Elemento Descripción
0 Al finalizar correctamente.
-1 Si la subrutina addfrub_src no es satisfactoria.