NAME

snalu62_define_tp − Defines a transaction program and initializes or changes parameters that control the operation of the transaction program. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_define_tp(
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       TP_NAME ∗tpn,
       UINT32 status,
       UINT32 conversation_type,
       UINT32 sync_level,
       UINT32 security_required,
       SECUR_ACC_INFO ∗security_access,
       PIP_INFO ∗pip,
       UINT8 data_mapping,
       UINT32 privilege,
       UINT32 instance_limit,
       ATTACH_MGR ∗attach_mgr_info,
       SRV_INFO ∗server_info
       );
 
 
 
 

SUPPLIED PARAMETERS

 
 

local_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the local LU with which this transaction program is associated. 
 
 

tpn

A pointer to a TP_NAME structure specifying the transaction program name being defined. The translate field of the TP_NAME structure specifies whether the interface needs to translate the transaction program name from ASCII to EBCDIC. If the name is already defined, this verb changes the other parameter values. 
 
 

status

A UINT32 value specifying the status that the interface returns to a remote transaction program when the local LU receives an allocation request naming this program.  Specify one of the following values:
 
 
 
 

•SNALU62_C_ENABLE (the default)

Specifies that the interface should accept the allocation request and, if no errors occur, should return a success status to the remote transaction program. 
 

•SNALU62_C_TEMP_DISABLE

Specifies that the interface should return an indication to the remote program that the requested local program is temporarily unavailable. The remote program can retry the request later. 
 

•SNALU62_C_PERM_DISABLE

Specifies that the interface should return an indication to the remote program that the requested local program is permanently unavailable. The remote program should not retry the request. 
 
 
 
 

conversation_type

A UINT32 value specifying the type of conversations that this transaction program allows on allocation requests.  Create this value from zero or more of the following mask values:
 
 
 

•SNALU62_M_TP_BASIC
 

•SNALU62_M_TP_MAPPED
 

•SNALU62_M_TP_FDX_BASIC
 

•SNALU62_M_TP_FDX_MAPPED
 

To allow all conversation types, specify SNALU62_M_TP_ANY. 
 
 

sync_level

A UINT32 value specifying the type of synchronization levels that the transaction program allows on allocation requests.  Create this value from zero or more of the following mask values:
 
 
 
 

•SNALU62_M_TP_SYNC_NONE

Specifies that this program supports conversations with no synchronization. 
 
 

•SNALU62_M_TP_SYNC_CONFIRM

Specifies that this program supports conversations with confirmation synchronization. 
 

•SNALU62_M_TP_SYNC_SYNCPT

Specifies that this program supports conversations with sync-point synchronization. 

The interface provides you with the capability to write transaction programs that process raw sync-point information. The interface does not support the following functions:
 

 
 

•Conversations with a synchronization level of SYNCPT which cannot process synchronization data and perform the necessary two-phase commit processing themselves
 

•Backout and sync-point procedures
 

 
 

 
 
 
 
 

The sync_level SNALU62_M_TP_SYNC_CONFIRM is not supported for full-duplex conversations. 

 
 

security_required

A UINT32 value specifying the type of resource-access authorization verification to be performed on incoming allocation requests that designate this transaction program. Specify one of the following values:
 
 
 
 

•SNALU62_C_ACC_NONE

The interface should accept all allocation requests for this program. If conversation-level security information is supplied, the interface should verify the information. The interface should not perform any resource-access authorization verification.  If you change a transaction program definition to this option or SNALU62_C_ACC_CONVERSATION, the interface deletes any existing resource-access authorization verification list. 
 
 

•SNALU62_C_ACC_CONVERSATION

The interface should perform conversation-level security verification on all allocation requests for this program.  All allocation requests for this program must supply at least a user ID and either a password or an already-verified indication.  The interface should not perform resource-access authorization verification.  If you change a transaction program definition to this option or SNALU62_C_ACC_NONE, the interface deletes any existing resource-access authorization verification list. 
 
 

•SNALU62_C_ACC_USER
 

•SNALU62_C_ACC_PROFILE
 

•SNALU62_C_ACC_USER_PROFILE
 

•SNALU62_C_ACC_USER_REM_LU
 

•SNALU62_C_ACC_USER_PROF_REM_LU

The interface should perform conversation-level security verification on all allocation requests for this program.  All allocation requests for this program must supply at least a user ID and either a password or an already-verified indication.  The interface should also perform resource-access authorization verification based on the value supplied:
 

 
 

•SNALU62_C_ACC_USER specifies that the interface should compare only the supplied user ID against this program’s resource-access authorization list. 
 

•SNALU62_C_ACC_PROFILE specifies that the interface should compare only the supplied profile against this program’s resource-access authorization list. 
 

•SNALU62_C_ACC_USER_PROFILE specifies that the interface should compare only the supplied user ID and profile against this program’s resource-access authorization list. 
 

•SNALU62_C_ACC_USER_REM_LU specifies that the interface should compare only the supplied user ID and remote LU against this program’s resource-access authorization list. 
 

•SNALU62_C_ACC_USER_PROF_REM_LU specifies that the interface should compare the user ID, profile, and remote LU against this program’s resource-access authorization list. 
 

 
 
 
 
 

security_access

A pointer to a SECUR_ACC_INFO structure specifying the resource-access authorization information to be either added or deleted. 
 
 

pip

A pointer to a PIP_INFO structure specifying whether PIP data is required on allocation requests and, optionally, how many PIP fields should be present. 
 
 

data_mapping

This parameter is a place holder. The functionality represented by this parameter is not implemented. 
 

privilege

This parameter is a place holder. The functionality represented by this parameter is not implemented. 
 

instance_limit

A UINT32 value specifying the maximum number of instances of this transaction program that are allowed to be invoked concurrently.  Specify a value greater than zero. 
 
 

attach_mgr_info

A pointer to an ATTACH_MGR structure specifying whether the LU6.2 Server should use an Attach Manager daemon to start this transaction program. 
 
 

server_info

A pointer to a SRV_INFO structure specifying the LU6.2 Server to use.  Supply sufficient information to uniquely identify the LU6.2 Server.  If this parameter is not specified, the interface attempts to connect to a local server with the name LU62_SRV. 
 
 

 
 
 

RETURNED PARAMETER

 
 

status_vec

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

 

DESCRIPTION

 
The values specified on the parameters of this verb take effect at the next invocation of this transaction program.
 
 

RESTRICTIONS

 
Only a process having superuser privileges or a user listed in the system group in the /etc/group file can call this verb. 

If you are using this verb to manage an LU6.2 Server on a remote node, the remote server must have access to an access validation file that includes your node name. 
 
 
For a description of the LU6.2 Server access validation file, see Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator’s Guide. 
 
 

RETURN VALUES

 

SNALU62_S_OKnormal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_display_tp

Manuals: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming and IBM’s Systems Network Architecture Transaction Programmer’s Reference Manual for LU Type 6.2.