Programming Guide

sm_tm_pset

Sets the value of a string transaction attribute 

#include <tmusubs.h>
int sm_tm_pset(int attribute, char *value);

attribute
Specifies the string attribute of the current transaction to change with one of the constants shown below.

value
attribute's new value.

Returns

Description

sm_tm_pset changes the value of a string attribute of the current transaction. This includes not only data in the current transaction structure itself, but also data that can be found indirectly, such as data relating to the current table view.

Table 5-21 describes the constants, defined in tmusubs.h, that specify the attributes to change with this function.

Table 5-21 Transaction string attributes for sm_tm_pset

Transaction Attribute Description

TM_BUFFER

General purpose string.

TM_MSG_TEXT

Text of sm_tm_command exit message.

TM_PROPOSE_MSG_TXT

Used to conditionally set TM_MSG_TEXT.

TM_SAVE_CURSOR

SAVE or VALIDATION cursor name.

TM_SV_SELECT_CURSOR

SELECT cursor name.

TM_USER_BUFFER

Reserved for user use.

Example

void set_msg_text(msg);
	char *msg;
	{
		/* 
		 * Set the sm_tm_command exit message, possibly overriding
		 *   any previously set message. 
		 */ 
	    sm_tm_pset(TM_MSG_TEXT, msg);
	}

See Also

sm_tm_inquire, sm_tm_pinquire, sm_tm_pcopy, sm_tm_pset