Patch Name: PHNE_17718

Patch Description: s700_800 10.20 R6.10.20 SNAplus2 API cumulative patch

Creation Date: 99/08/16

Post Date:  00/02/15

Hardware Platforms - OS Releases:
	s700: 10.20
	s800: 10.20

Products:
	SNAplus2-API R6.10.20

Filesets:
	SNAplus2-API.SNAP2-API

Automatic Reboot?: No

Status: General Release

Critical: No

Path Name: /hp-ux_patches/s700_800/10.X/PHNE_17718

Symptoms:
	PHNE_17718:
	(1) JAGab65379
	If you start a TP (non-invoked) and specify the verify
	type as AP_SAME in the CPIC side information for the TP,
	then the user ID will not be used for verification.
	(2) JAGab65375
	Updated binaries required for patching the latest
	R6 release of SNAplus2.
	(3) JAGab65310
	Issuing RUI_TERM while asynch RUI_INIT is outstanding
	should cancel the RUI_INIT.
	Instead, the customer gets the following error:
	STATE_CHECK - DUPLICATE_RUI_INIT.
	(4) JAGab65306
	tpsrv_c.h not shipped with product.
	(5) JAGab65241
	Enhancement request in CPI-C to allow a Service TP Name
	to be specified in the APPCTPN environment variable.

	PHNE_15506:
	(1) 4701386730
	CPIC CMRCV call always traces empty buffer.
	(2) 4701384511
	When using AP_SAME conversation securty (cmscst) we
	get cmscsu rejected by the library with state check.

Defect Description:
	PHNE_17718:
	(1) JAGab65379
	If you start a TP (non-invoked) and specify the verify
	type as AP_SAME in the CPIC side information for the TP
	then the user ID will not be used in verification.

	Resolution:
	Code change ensures that we correctly pick up the user ID
	from the side information.
	(2) JAGab65375
	Updated binaries provided for combined patching of
	latest R6 release, as documented in SR text.

	Resolution:
	Updated binaries for patching
	on SNAplus2 releases R6.10.20.100 and R6.11.00.100.
	(3) JAGab65310
	The problem is that in state VLV_STARTING the RUI_TERM
	verb is rejected as part of a general test.

	Resolution:
	The fix is to special case this verb in the test to
	allow it through while the RUI_INIT verb has a request
	outstanding.
	(4) JAGab65306
	Error in psf file meant header file was not included in
	the product filesets.

	Resolution:
	correct psf file, ship tpsrv_c.h for inclusion in product.
	(5) JAGab65241
	Enhancement implemented to allow a Service TP name to be
	specified in the APPCTPN Environment Variable.
	This now allows the APPCTPN variable to be set as
	'SNA_SERVICE_TP_0xqqqqqqqq' where qqqqqqqq is the ASCII
	representation of the Hex Service TP name.

	Resolution:
	The APPCTPN environment variable is used to provide the
	TP Name to the CPI-C application. The SNA architecture
	specifies that APPCTPN is an ASCII string, so this variable
	cannot specify a Service TP Name, which is coded with a
	non-ASCII string.
	This enhancement allows APPCTPN to specify a Service TP
	Name, when set as 'SNA_SERVICE_TP_0xqqqqqqqq' where
	qqqqqqqq is the ASCII representation of the Hex Service TP
	name.

	PHNE_15506:
	(1) 4701386730
	Code changed to trace out the true buffer - the buffer
	length is a LONG not a SHORT.
	(2) 4701384511
	Code changed to allow application to specify the userid for
	both R5 and R6. Further alter the APPC library in R5 only
	for this to take effect in the case where the TP is setuid
	root.

SR:
	4701386730 4701384511

Patch Files:
	/opt/sna/include/tpsrv_c.h
	/opt/sna/lib/libcpic.1
	/opt/sna/lib/liblua.1

what(1) Output:
	/opt/sna/lib/libcpic.1:
		]R6.10.20.103 SNAplus2 R6 CPI-C Library Routines
		]            (PHNE_17718 : 98/11/24 14:14:33)
		]
	/opt/sna/lib/liblua.1:
		]R6.10.20.101 SNAplus2 R6 LUA Verb Library Routines
		]            (PHNE_17718 : 99/07/20 18:46:21)
		]
	/opt/sna/include/tpsrv_c.h:
		None

cksum(1) Output:
	1970423838 311296 /opt/sna/lib/libcpic.1
	2432707248 69632 /opt/sna/lib/liblua.1
	3695577116 4622 /opt/sna/include/tpsrv_c.h

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHNE_15506

Equivalent Patches: None

Patch Package Size: 440 KBytes

Installation Instructions:
	Please review all instructions and the Hewlett-Packard
	SupportLine User Guide or your Hewlett-Packard support terms
	and conditions for precautions, scope of license,
	restrictions, and, limitation of liability and warranties,
	before installing this patch.
	------------------------------------------------------------
	1. Back up your system before installing a patch.

	2. Login as root.

	3. Copy the patch to the /tmp directory.

	4. Move to the /tmp directory and unshar the patch:

		cd /tmp
		sh PHNE_17718

	5a. For a standalone system, run swinstall to install the
	    patch:

		swinstall -x autoreboot=true -x match_target=true \
			-s /tmp/PHNE_17718.depot

	By default swinstall will archive the original software in
	/var/adm/sw/patch/PHNE_17718.  If you do not wish to retain a
	copy of the original software, you can create an empty file
	named /var/adm/sw/patch/PATCH_NOSAVE.

	WARNING: If this file exists when a patch is installed, the
	         patch cannot be deinstalled.  Please be careful
		 when using this feature.

	It is recommended that you move the PHNE_17718.text file to
	/var/adm/sw/patch for future reference.

	To put this patch on a magnetic tape and install from the
	tape drive, use the command:

		dd if=/tmp/PHNE_17718.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:
	Stop SNA daemon before installing patch (snap stop). After
	installing the patch start the SNA daemon (snap start).