NAME

snalu62_display_tp − Displays a transaction program’s parameters. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_display_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_LIST ∗security_access,
       PIP_INFO ∗pip,
       UINT32 ∗data_mapping,
       UINT32 ∗privilege,
       UINT32 ∗instance_limit,
       UINT32 ∗instance_count,
       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. 
 
 

tpn

A pointer to a TP_NAME structure specifying the name of the transaction program to display. The translate field of the TP_NAME structure specifies whether the interface needs to translate the transaction program name. 
 
 

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 PARAMETERS

 
 

status_vec

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

status

A pointer to a UINT32 location to receive a value indicating the status that the interface returns to a remote transaction program when it requests a conversation with this transaction program.  It can have one of the following values:
 
 
 
 

•SNALU62_C_ENABLE

Indicates 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

Indicates 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

Indicates 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 pointer to a UINT32 location to receive a value indicating the type of conversation allowed on allocation requests.  This value is formed 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
 
 
 
 
 

sync_level

A pointer to a UINT32 location to receive a value indicating the type of synchronization level allowed on allocation requests.  This value is formed from zero or more of the following mask values:
 
 
 
 

•SNALU62_M_TP_SYNC_NONE

Indicates that this program supports conversations with no synchronization. 
 

•SNALU62_M_TP_SYNC_CONFIRM

Indicates that this program supports conversations with confirmation synchronization. 
 

•SNALU62_M_TP_SYNC_SYNCPT

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

security_required

A pointer to a UINT32 location to receive a value indicating the type of resource-access security verification to be performed on incoming allocation requests that designate this transaction program.  It can have one of the following values:
 
 
 
 

•SNALU62_C_ACC_NONE

The interface accepts all allocation requests for this program. If conversation-level security information is supplied, the interface verifies the information. The interface does not perform any resource-access verification. 
 

•SNALU62_C_ACC_CONVERSATION

The interface performs 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 does not perform resource-access security 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 performs 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 also performs resource-access security verification based on the value supplied:
 

 
 

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

•SNALU62_C_ACC_PROFILE indicates that the interface compares only the supplied profile against this program’s resource-access authorization list. 
 

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

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

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

 
 
 
 
 

security_access

A pointer to a SECUR_ACC_LIST structure to receive the resource-access authorization list currently defined for this transaction program. 
 

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

 
 

pip

A pointer to a PIP_INFO structure to receive an indication of whether PIP data is required on allocation requests and, if so, how many PIP fields should be present. 
 

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

 
 

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 pointer to a UINT32 location to receive a value indicating the maximum number of instances of this transaction program that the interface can invoke concurrently. 
 
 

instance_count

A pointer to a UINT32 location to receive a value indicating the number of instances of this transaction program that are currently running. 
 
 

attach_mgr_info

A pointer to an ATTACH_MGR structure to receive information indicating whether an Attach Manager daemon can start this transaction program. 
 

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

 
 
 

 

DESCRIPTION

 
Use this verb to retrieve current values of parameters that control the operation of the local LU in conjunction with the specified transaction program.

This verb returns operating parameters that the snalu62_define_tp verb establishes. 
 
 

RESTRICTIONS

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

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