snalu62_get_log_data(3) — Subroutines

NAME

snalu62_get_log_data − Returns the log data that can accompany an error message received from a remote transaction program.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_get_log_data(
       RES_ID resource,
       STATUS_VEC status_vec,
       UINT32 ∗sense_code,
       BUFFER ∗log_data
       );

Valid Conversation States

HDX: All

FDX: All

SUPPLIED PARAMETER

resource

A RES_ID structure specifying the resource ID assigned to the conversation by the interface. The interface returns this ID on the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb.

RETURNED PARAMETERS

status_vec

A pointer to a STATUS_VEC array to receive the completion status information.

sense_code

A pointer to a UINT32 location to receive the sense code associated with log data.

log_data

A pointer to a BUFFER structure to receive the log data, in binary (EBCDIC) format. The buffer contains a single logical record. The logical record consist of a 2-byte length field followed by a data field. The high-order bit of this length field is not used. The remaining 15 bits contain the length of the record (including the 2-byte length field). Therefore, the maximum length of the data field is 32,765 bytes and logical-record length values of 0 and 1 are invalid. The data field is optional, that is, the data field can consist of 0 bytes.

The interface allocates the memory referenced by the BUFFER structure. The transaction program must deallocate this memory by using the snalu62_free_mem verb.

DESCRIPTION

The transaction program can call this verb after it receives any of the following return codes:

•SNALU62_S_DEABPR

•SNALU62_S_DEABSVC

•SNALU62_S_DEABTIM

•SNALU62_S_PRERNTR

•SNALU62_S_PRERPU

•SNALU62_S_PRERTR

•SNALU62_S_RESFNO (mapped conversations only)

•SNALU62_S_SVCERPU

•SNALU62_S_SVCERTR

RESTRICTIONS

None

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation cancelled

SNALU62_S_LOGDATA_TRUNC
returned log data was truncated

SNALU62_S_NLOGDATA
no log data available

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

ERRORS