pimlu62.h

界面程序

#ifndef _PIMLU62_H_
#define _PIMLU62_H_

#ifdef HEADERVERSIONS
static char *_pimlu62_h_ = "@(#)pimLU62.h	1.4 !R2";
#endif

/*************************************************************************

    NAME:
	pimLU62.h

    DESCRIPTION:
	Header file for LU62 Programmer's Interface Module. Contains all
	of the constants Pnd structure needed to use the PIM.

	The majority fo these constants are based on definitions in
	IBM document "Transaction Programmer's Reference Manual for
	LU Type 6.2"

    Copyright 1985, 1986, 1987, 1988, 1990 by Rabbit Software Corporation

*************************************************************************/

/*
   Include "rabbit.h" to obtain various port-specific types and constants.
*/
#include "rabbit.h"

#define NULLRES			-1	/* a Null resource id.		 */
#define NCONVTP	     		10	/* Number of conversations per TP*/

/*************************************************************************/
/***************************  Return Codes *******************************/
/*								         */
/* Most LU 6.2 PIM verbs return a successful/unsuccessful status in the  */
/* Return Code.  All return codes are IBM defined (see Chapter 4, Return */
/* Codes, of the SNA Transaction Programmer's Reference Manual for LU    */
/* Type 6.2).							 	 */
/*								         */
/*************************************************************************/

#define rOK			0       /* OK				*/
#define rALLOC_ERR		1	/* ALLOCATION_ERROR		*/

#define rP_DEALLOC_ABEND	2	/* DEALLOCATE_ABEND_PROG	*/
#define rS_DEALLOC_ABEND	3 	/* DEALLOCATE_ABEND_SVC		*/
#define rT_DEALLOC_ABEND	4 	/* DEALLOCATE_ABEND_TIMER	*/
#define rN_DEALLOC		5 	/* DEALLOCATE_NORMAL		*/
#define rPARM_ERR		6 	/* PARAMETER_ERROR		*/
#define rNT_PROG_ERR		7 	/* PROG_ERROR_NO_TRUNC		*/
#define rP_PROG_ERR		8 	/* PROG_ERROR_PURGING		*/
#define rT_PROG_ERR		9 	/* PROG_ERROR_TRUNC		*/
#define rNR_RES_FAIL		10	/* RESOURCE_FAILURE_NO_RETRY	*/
#define rR_RES_FAIL		11	/* RESOURCE_FAILURE_RETRY	*/
#define rNT_SVC_ERR		12	/* SVC_ERROR_NO_TRUNC		*/
#define rP_SVC_ERR		13	/* SVC_ERROR_PURGING		*/
#define rT_SVC_ERR		14	/* SVC_ERROR_TRUNC		*/
#define rUNSUCCESSFUL           15      /* UNSUCCESSFUL                 */
#define rPOST_NOT_ACT		16	/* POSTING_NOT_ACTIVE		*/

/*  Return codes specific to Mapped Conversations verbs 		*/
#define rDEALLOC_ABEND		2	/* DEALLOCATE_ABEND		*/
#define rFMH_NOT_SUP		50	/* FMH_DATA_NOT_SUPPORTED	*/
#define rMAP_EXEC_FAIL		51	/* MAP_EXECUTAION_FAILURE	*/
#define rMAP_FOUND_FAIL		52	/* MAP_NOT_FOUND		*/
#define rMAP_NOT_SUP		53	/* MAPPING_NOT_SUPPORTED	*/

/*  Abend Return Codes - These are return codes returned to		*/
/*  the caller instead of abending as specified by LU6.2 		*/
/*  The decision as to whether or not to abend is up to the application.*/
#define rINV_RESOURCE		100	/* Invalid resource id.		*/
#define rINV_SYNCLEV		101	/* Invalid sync level for verb. */
#define rINV_STATE		102	/* Invalid state for verb.	*/
#define rINV_LL			103	/* Invalid logical record length*/
#define rINV_VERB		104     /* Invalid verb or not supported*/
#define rINV_TPNLEN		105	/* Invalid TPN Len of 0         */
#define rINV_SNASVCMG	        106	/* Invalid ModeName 'SNASVCMG'  */
#define rINV_SECURITY		107	/* Invalid Security		*/

/* Implementation specific return code 					*/
#define rNORES			150    /* LU62Mgr does not have enough */
					/* resource to process the verb.*/
#define rTPNOTACT		151    /* The TP is not active.        */
					/* Did not issue AttachLU62().  */
#define rTPACTIVE		152    /* TP already active.		*/
#define rTPLIM			153	/* Conv per TP limit exceeded   */
#define rSYSERR			154	/* Internal System Error - see  */
					/* System Administrator.	*/
#define rCONVSACT	        155    /* Cannot DETACH, have active   */
					/* conversations.		*/
#define rNULLCB			156    /* A NULL control block was     */
					/* passed into ATTACHLU62().	*/
#define rNOATTACH		157	/* Not allowed to Attach and    */
					/* Detach more than once.	*/
#define rINVALLU		158	/* Invalid LU name specified in */
					/* AttachLU62() call.		*/
#define rBADFORMAT		159    /* Bad format parameter in      */
					/* AttachLU62() call.		*/
#define rINV_NBRCONV		160	/* Invalid Number Of Conversation*/
					/* specified in Wait_Proc() call.*/
#define rINV_PIP_RCVD		161	/* Invalid PIP GDS received.	*/
					/* AttachLU62() call.		*/
#define r62INACTIVE		162	/* LU62Mgr is not installed.    */
					/* AttachLU62() call.		*/

/* NMVT */
#define rINVPUNAME		163	/* Invalid PU Name Specified	*/
#define rPUNOTACTIVE		164	/* SSCP-PU Session not active	*/
#define rINV_NMVT_TYPE		165	/* Invalid NMVT Type		*/
#define rNMVT_EXCEEDS_RU_SIZE	166	/* NMVT Message exceeds RU size */
#define rINV_PROD_SET_ID_TYPE	167	/* Invalid Product Set ID	*/

/*************************************************************************/
/***************************  Return SubCodes  ***************************/
/*									 */
/* When the Return Code field indicates unsuccessful verb exection, more */
/* detailed error information may be returned in the Return SubCode      */
/* field. All return subcodes are IBM defined (see Chapter 4, Return 	 */
/* Codes, ofthe SNA Transaction Programmer's Reference Manual for LU     */
/* Type 6.2).								 */
/*									 */
/*************************************************************************/

#define rsNULL			0	/* No return subcode.		*/

/*  rALLOC_ERR   --   ALLOCATION_ERROR */
#define rsNR_ALLOCFAIL		1	/* ALLOCATION_FAILURE_NORETRY   */
#define rsR_ALLOCFAIL		2	/* ALLOCATION_FAILURE_RETRY	*/
#define rsCONVMISMATCH   	3	/* CONVERSATION_TYPE_MISMATCH   */
#define rsP_SYNCLNOTSUP  	4       /* SYNC_LEVEL_NOT_SUPPORTED_BY_PGM*/
#define rsL_SYNCLNOTSUP  	5	/* SYNC_LEVEL_NOT_SUPPORTED_BY_LU*/
#define rsTPNNOTREC		6	/* TPN_NOT_RECOGNIZED		*/
#define rsNR_TP_NOTAVAIL 	7	/* TRANS_PGM_NOT_AVAIL_NO_RETRY */
#define rsR_TP_NOTAVAIL  	8	/* TRANS_PGM_NOT_AVAIL_RETRY    */
#define rsPIPNAL		9	/* PIP_NOT_ALLOWED		*/
#define rsPIPNSPCOR	       10	/* PIP_NOT_SPECIFIED_CORRECTLY  */
#define rsSECURNOTVAL	       11	/* SECURITY_NOT_VALID           */

/*  rPARM_ERR    --   PARAMETER_ERROR */
/* ALLOCATE */
#define rsINV_LLUNAME		9	/* Invalid local LU name.	*/
#define rsINV_RLUNAME		10	/* Invalid remote LU name.	*/
#define rsINV_MODENAME		11	/* Invalid Mode name.		*/
#define rsINV_RETCNTL		12	/* Invalid return control param.*/
#define rsINV_CONVTYPE		13	/* Invalid conversation type.   */
#define rsINV_SYNCLEV		14	/* Invalid sync level.		*/
#define rsINV_TPN		15	/* Invalid TPN.			*/
#define rsINV_LUPAIR		16	/* Invalid LU Pair.		*/

/* DEALLOCATE */
#define rsINV_DEALL_TYPE	20	/* Invalid deallocation type.	*/

/* TEST */
#define rsDATA			25	/* OK with Data 		*/
#define rsNODATA		26	/* OK with no data		*/

/* non-architected PARAMETER_ERROR Return Subcode */

/* ALLOCATE */
#define rsINVTPTYPE		50	/* Invalid TP type.		*/
#define rsINV_NAMELEN		51	/* Invalid Length of Name.	*/
#define rsINVLUNTYPE            52      /* Invalid LU Name Type		*/

/* PREPARE_TO_RECEIVE */
#define rsINV_PREPTYPE	        55	/* Invalid Prepare_To_Receive Type*/
#define rsINVLOCKS		56	/* Invalid Locks		*/

/* RECEIVE_AND_WAIT */
#define rsINV_FILL		60	/* Invalid Fill Type.		*/
#define rsINV_LEN		61	/* Length field too long.	*/

/* MC_SEND_DATA */
#define rsINV_MAPNAME		65	/* Invalid Mapname.		*/

/* SEND_ERROR */
#define rsINV_ERRTYPE		66	/* Invalid Error Type.		*/
#define rsINV_ERRDIR		67	/* Invalid Error Direction	*/

/* SEND_ERROR & DEALLOCATE(ABEND) LOG_DATA */
#define rsINVLENLOG		70	/* Invalid Log Len.	        */
#define rsINVLGDATA		71	/* Invalid Log Data.		*/

/* TEST */
#define rsINV_TEST_TYPE		75	/* Invalid Test type		*/

/* SET SECURITY  */
#define rsINVUSERID		80	/* Invalid User Identifier	*/
#define rsINVPASSWD		81	/* Invalid User Password	*/
#define rsINVPROFILE		82	/* Invalid Security Profile	*/

/*************************************************************************/
/**************************  What Received Codes *************************/
/*									 */
/* These codes are returned on the Receive_And_Wait verb call.		 */
/*									 */
/*************************************************************************/

#define wNULL			0	/* Nothing.			 */
#define wCONFIRM		1	/* CONFIRM			 */
#define wCONF_DEALLOC		2	/* CONFIRM_DEALLOCATE		 */
#define wCONF_SEND		3	/* CONFIRM_SEND			 */
#define wDATA			4	/* DATA				 */
#define wDATA_COMPLETE		5	/* DATA_COMPLETE		 */
#define wDATA_INCOMPLETE	6	/* DATA_INCOMPLETE		 */
#define wLL_TRUNCATED		7	/* LL_TRUNCATED			 */
#define wSEND			8	/* SEND				 */
#define wDATA_TRUNCATED		9       /* DATA_TRUNCATED		 */
#define wFMH_COMPLETE		10	/* FMH_DATA_COMPLETE		 */
#define wFMH_INCOMPLETE		11	/* FMH_DATA_INCOMPLETE		 */
#define wFMH_TRUNCATED		12	/* FMH_DATA_TRUNCATED		 */

/*************************************************************************/