snalu62_get_log_data(3) — Subroutines

Name

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

FORMAT

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

Arguments

resource

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

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 zero 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

Return Values

SNALU62_S_OK
normal 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