Name

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

FORMAT

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
     );
 
 
 
 

Arguments

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

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.
 
 

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
 
 

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

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. 

•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. 

•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 an Attach Manager daemon can start this transaction program. 
 
 

server_info
 
A pointer to a SRV_INFO structure specifying the LU6.2 Server to utilize.  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. 
 
 
 

Description

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

 
If the conversation_type parameter is not defined, both mapped and basic conversations are allowed. 
 

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.
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully