Apple SNA•ps - Revision history

PoC: /* External links */ New link with some additional information

2025-11-14T17:44:26Z

External links: New link with some additional information

← Older revision		Revision as of 19:44, 14 November 2025
Line 346:		Line 346:
	* [https://bitsavers.org/pdf/ibm/sna/Z325-6027-0_IBM-Apple_Enterprise_Networking_Guide_for_SNA_Products_199110.pdf Z325-6027-00] IBM/Apple IBM Enterprise Networking Guide for SNA Products, IBM		* [https://bitsavers.org/pdf/ibm/sna/Z325-6027-0_IBM-Apple_Enterprise_Networking_Guide_for_SNA_Products_199110.pdf Z325-6027-00] IBM/Apple IBM Enterprise Networking Guide for SNA Products, IBM
	* [https://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=DD&subtype=SM&htmlfid=897/ENUS5733-CSR 5733-CSR IBM AS/400 Client Series End User Products], IBM		* [https://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=DD&subtype=SM&htmlfid=897/ENUS5733-CSR 5733-CSR IBM AS/400 Client Series End User Products], IBM
			* [https://www.buriedbits.org/macintosh-networking-pre-osx Macintosh networking (pre-OSX)], buriedbits.org

	== Notes ==		== Notes ==

PoC: Fixed inline wikipedia links

2025-06-04T17:37:24Z

Fixed inline wikipedia links

PoC: /* AS/400 configuration */ ALWVRTAPPN

2024-03-14T13:45:52Z

AS/400 configuration: ALWVRTAPPN

← Older revision		Revision as of 15:45, 14 March 2024
Line 81:		Line 81:
	== AS/400 configuration ==		== AS/400 configuration ==
	On the AS/400 side, autoconfiguration for controller, and device descriptions should — at least temporarily — be allowed. See the <code>WRKSYSVAL</code> command and the ''QAUTOCFG'', ''QAUTORMT'' and ''QAUTOVRT'' variables. Maybe also adjust the variables ''QLMTDEVSSN'' and ''QLMTSECOFR''. See help texts for details.		On the AS/400 side, autoconfiguration for controller, and device descriptions should — at least temporarily — be allowed. See the <code>WRKSYSVAL</code> command and the ''QAUTOCFG'', ''QAUTORMT'' and ''QAUTOVRT'' variables. Maybe also adjust the variables ''QLMTDEVSSN'' and ''QLMTSECOFR''. See help texts for details.

			The setting of the network attribute ''ALWVRTAPPN'' doesn't matter.

	A working Token Ring connection is also required. In its line description, the ''AUTOCRTCTL'' parameter should (temporarily) be set to ''YES''. It is recommended that the associated ''AUTODLTCTL'' parameter be set to ''NONE'' if <code>AUTOCRTCTL(*YES)</code> is to be retained.		A working Token Ring connection is also required. In its line description, the ''AUTOCRTCTL'' parameter should (temporarily) be set to ''YES''. It is recommended that the associated ''AUTODLTCTL'' parameter be set to ''NONE'' if <code>AUTOCRTCTL(*YES)</code> is to be retained.

PoC: /* General overview */ Exanded pros and cons

2023-05-26T21:05:14Z

General overview: Exanded pros and cons

← Older revision		Revision as of 23:05, 26 May 2023
Line 32:		Line 32:
	The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [https://en.wikipedia.org/wiki/Database_abstraction_layer DAL] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).		The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [https://en.wikipedia.org/wiki/Database_abstraction_layer DAL] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).

	In the 1990s, IBM made LocalTalk add-on cards for the AS/400, and additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded roughly to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400.		In the 1990s, IBM made LocalTalk add-on cards for the older AS/400's SPD slots, and released additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded roughly to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400. It was only meant to provide display and print functions instead of full APPC capabilities, though. This enabled Macs to function as a console device to the AS/400, but made it impossible to use APPC based services, such as DAL, over the integrated LocalTalk connection.

	The IBM document ''Using Apple Macintosh with the AS/400'', Document Number GG24-4071-00 (March 1994) provides detailed insight about SNA•ps, and AS/400 configuration. Unfortunately, this document is no longer available publicly.		The IBM document ''Using Apple Macintosh with the AS/400'', Document Number GG24-4071-00 (March 1994) provides detailed insight about SNA•ps, and AS/400 configuration. Unfortunately, this document is no longer available publicly.

PoC: /* General overview */ Not exact

2023-05-26T21:00:18Z

General overview: Not exact

← Older revision		Revision as of 23:00, 26 May 2023
Line 32:		Line 32:
	The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [https://en.wikipedia.org/wiki/Database_abstraction_layer DAL] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).		The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [https://en.wikipedia.org/wiki/Database_abstraction_layer DAL] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).

	In the 1990s, IBM made LocalTalk add-on cards for the AS/400, and additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400.		In the 1990s, IBM made LocalTalk add-on cards for the AS/400, and additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded roughly to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400.

	The IBM document ''Using Apple Macintosh with the AS/400'', Document Number GG24-4071-00 (March 1994) provides detailed insight about SNA•ps, and AS/400 configuration. Unfortunately, this document is no longer available publicly.		The IBM document ''Using Apple Macintosh with the AS/400'', Document Number GG24-4071-00 (March 1994) provides detailed insight about SNA•ps, and AS/400 configuration. Unfortunately, this document is no longer available publicly.

PoC: Memory details

2023-05-17T16:02:57Z

Memory details

← Older revision		Revision as of 18:02, 17 May 2023
Line 13:		Line 13:
	* ''Gateway'' software with a license dependent maximum count of		* ''Gateway'' software with a license dependent maximum count of
	** 8, 32, or 64 [https://en.wikipedia.org/wiki/IBM_Systems_Network_Architecture#Logical_Unit_.28LU.29 LU]-sessions for version 1.1		** 8, 32, or 64 [https://en.wikipedia.org/wiki/IBM_Systems_Network_Architecture#Logical_Unit_.28LU.29 LU]-sessions for version 1.1
	** 10, 40, or 70 ~~LU-sessions~~ for version 2.0.1		** 10, 35, or 70 users for version 2.0.1
	* ''Gateway Client''<ref>Designated ''GC'' in product descriptions.</ref> for 3270 and 5250 terminal services, as well as printing services.		* ''Gateway Client''<ref>Designated ''GC'' in product descriptions.</ref> for 3270 and 5250 terminal services, as well as printing services.

	<blockquote>'''Note:''' Further restrictions in terms of session count may apply depending on selected transport option technology, and available memory on said transport option.</blockquote>		<blockquote>'''Note:''' Further restrictions in terms of session count may apply depending on selected transport option technology, and available memory on said transport option.</blockquote>

	This article focuses on AS/400 and thus on 5250 connectivity. Since the AS/400 platform also has 3270 compatibility support, the SNA•ps 3270 client for 3270 sessions can be used when required. See below for Macintosh System Software version requirements.		This article focuses on AS/400 and thus on 5250 connectivity. Since the AS/400 platform also has 3270 compatibility support, the SNA•ps 3270 client for 3270 sessions can be used when required, and with an appropriately configured AS/400 system. See below for Macintosh System Software version requirements.

	Different versions of ''SNA•ps'' are available on Apple’s [https://macintoshgarden.org/apps/apple-cdsn-computers-connectivity-demonstration-and-support-network-reference-cd ''Computer's Connectivity Demonstration and Support Network'' Reference CD] at Macintosh Garden. Note that version 2.0.1 requires a serial number to be entered at install time.		Different versions of ''SNA•ps'' are available on Apple’s [https://macintoshgarden.org/apps/apple-cdsn-computers-connectivity-demonstration-and-support-network-reference-cd ''Computer's Connectivity Demonstration and Support Network'' Reference CD] at Macintosh Garden. Note that version 2.0.1 requires a serial number to be entered at install time.
Line 68:		Line 68:
	All of these cards feature their own 68000 CPU, and local memory. They conform to the ''Macintosh Coprocessor Platform'' specification. A more or less small process runs on the card, which exchanges data via message passing with its counterpart ''A/ROSE'' in the Mac OS.		All of these cards feature their own 68000 CPU, and local memory. They conform to the ''Macintosh Coprocessor Platform'' specification. A more or less small process runs on the card, which exchanges data via message passing with its counterpart ''A/ROSE'' in the Mac OS.

	As a novel feature, part of the ''SNA•ps'' gateway software runs on the processor of the respective MCP card. Along with the rest of the software running on the Mac’s main CPU, APPC sessions are encapsulated in AppleTalk, and available to other Macs connected to the network, including LocalTalk. The minimum amount of memory for SNA•ps use is 1 MB.		As a novel feature, part of the ''SNA•ps'' gateway software runs on the processor of the respective MCP card. Along with the rest of the software running on the Mac’s main CPU, APPC sessions are encapsulated in AppleTalk, and available to other Macs connected to the network, including LocalTalk. The minimum amount of memory for SNA•ps use is 1 MB. For the 64 LU- and 70 user license, 2.5 MB are required.

	<gallery mode="packed">		<gallery mode="packed">

PoC: More documentation

2023-05-15T21:43:01Z

PoC: Better wording

2023-05-14T21:37:20Z

Better wording

← Older revision		Revision as of 23:37, 14 May 2023
Line 260:		Line 260:
	'''Note:''' Modes aren’t shared. For each remote LU, you need to re-enter the values outlined above.		'''Note:''' Modes aren’t shared. For each remote LU, you need to re-enter the values outlined above.

	It may happen that the gateway refuses to start because it claims there ~~would~~ not enough memory (on the MCP card). Recommended action is to lower ''Maximum Sessions'', and ''Contention Winner'' settings locally, and on the AS/400 with the <code>CHGMODD</code> command.		It may happen that the gateway refuses to start because it claims there isn’t not enough memory (on the MCP card). Recommended action is to lower ''Maximum Sessions'', and ''Contention Winner'' settings locally, and on the AS/400 with the <code>CHGMODD</code> command.

	== Gateway Activation ==		== Gateway Activation ==

Mlc at 19:40, 14 May 2023

2023-05-14T19:40:35Z

Show changes

PoC: typo

2023-05-14T19:25:17Z

typo

← Older revision		Revision as of 21:25, 14 May 2023
Line 2:		Line 2:
	[[File:5250term.gif\|thumb\|right\|Active 5250 client connection]]		[[File:5250term.gif\|thumb\|right\|Active 5250 client connection]]
	[[File:Snagw-run.gif\|thumb\|right\|SNA•ps Gateway information windows]]		[[File:Snagw-run.gif\|thumb\|right\|SNA•ps Gateway information windows]]
	'''Apple SNA•ps''' is an application software package for Apple Macintosh Computers running System 7. Its purpose is to provide Macintosh users access to resources located on IBM Midrange and Mainframe computers. It is the result of a collaboration between Apple and IBM in the early 1990s and has been developed by Orion Software. SNA•ps is short for ''Systems Networking Architecture protocols ~~ans~~ services''.		'''Apple SNA•ps''' is an application software package for Apple Macintosh Computers running System 7. Its purpose is to provide Macintosh users access to resources located on IBM Midrange and Mainframe computers. It is the result of a collaboration between Apple and IBM in the early 1990s and has been developed by Orion Software. SNA•ps is short for ''Systems Networking Architecture protocols and services''.

	SNA•ps uses IBMs proprietary ''Systems Network Architecture'' family of network protocols to talk to the IBM side of affairs,<ref>Newer versions of the SNA•ps 5250 client also support IP/tn5250 as alternate network transport.</ref> and Apple's proprietary AppleTalk on the Macintosh side.		SNA•ps uses IBMs proprietary ''Systems Network Architecture'' family of network protocols to talk to the IBM side of affairs,<ref>Newer versions of the SNA•ps 5250 client also support IP/tn5250 as alternate network transport.</ref> and Apple's proprietary AppleTalk on the Macintosh side.

← Older revision		Revision as of 23:43, 15 May 2023
Line 33:		Line 33:

	In the 1990s, IBM made LocalTalk add-on cards for the AS/400, and additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400.		In the 1990s, IBM made LocalTalk add-on cards for the AS/400, and additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400.

			The IBM document ''Using Apple Macintosh with the AS/400'', Document Number GG24-4071-00 (March 1994) provides detailed insight about SNA•ps, and AS/400 configuration. Unfortunately, this document is no longer available publicly.

	== System compatibility ==		== System compatibility ==
Line 324:		Line 326:
	* Neither SNA•ps 5250, nor SNA•ps print can be used on PowerPC machines when connecting via a ''SNA•ps gateway''. As soon as the connection is to be set, the client crashes with an ''illegal instruction'' error.<ref>This is the first and so far only (productivity) 68k program I’m aware of not running on PowerPC.</ref>		* Neither SNA•ps 5250, nor SNA•ps print can be used on PowerPC machines when connecting via a ''SNA•ps gateway''. As soon as the connection is to be set, the client crashes with an ''illegal instruction'' error.<ref>This is the first and so far only (productivity) 68k program I’m aware of not running on PowerPC.</ref>
	* Using the AppleTalk diagnostic tool ''Trawl'' on the gateway Mac itself somehow messes up the AppleTalk stack on it, so that the gateway no longer appears in the manager application. Only a reboot of the gateway computer fixes that error.		* Using the AppleTalk diagnostic tool ''Trawl'' on the gateway Mac itself somehow messes up the AppleTalk stack on it, so that the gateway no longer appears in the manager application. Only a reboot of the gateway computer fixes that error.

	~~== Notes ==~~
	~~<references />~~

	== External links ==		== External links ==
Line 344:		Line 343:
	* [https://web.archive.org/web/20181229140138/http://docwiki.cisco.com/wiki/IBM_Systems_Network_Architecture_Protocols IBM Systems Network Architecture Protocols], Cisco Docwiki (aus dem Archiv)		* [https://web.archive.org/web/20181229140138/http://docwiki.cisco.com/wiki/IBM_Systems_Network_Architecture_Protocols IBM Systems Network Architecture Protocols], Cisco Docwiki (aus dem Archiv)
	* [https://bitsavers.org/pdf/ibm/sna/Z325-6027-0_IBM-Apple_Enterprise_Networking_Guide_for_SNA_Products_199110.pdf Z325-6027-00] IBM/Apple IBM Enterprise Networking Guide for SNA Products, IBM		* [https://bitsavers.org/pdf/ibm/sna/Z325-6027-0_IBM-Apple_Enterprise_Networking_Guide_for_SNA_Products_199110.pdf Z325-6027-00] IBM/Apple IBM Enterprise Networking Guide for SNA Products, IBM
			* [https://www.ibm.com/common/ssi/cgi-bin/ssialias?infotype=DD&subtype=SM&htmlfid=897/ENUS5733-CSR 5733-CSR IBM AS/400 Client Series End User Products], IBM

			== Notes ==
			<references />

	[[Category: Software Configuration Guide]]		[[Category: Software Configuration Guide]]
	[[Category: System Administration]]		[[Category: System Administration]]

← Older revision		Revision as of 19:37, 4 June 2025
Line 12:		Line 12:
	SNA•ps comprises of a client and server component. Both can run on the same Macintosh computer, though.		SNA•ps comprises of a client and server component. Both can run on the same Macintosh computer, though.
	* ''Gateway'' software with a license dependent maximum count of		* ''Gateway'' software with a license dependent maximum count of
	** 8, 32, or 64 [~~https~~:~~//en.wikipedia.org/wiki/IBM_Systems_Network_Architecture~~#~~Logical_Unit_.28LU.29~~ LU]-sessions for version 1.1		** 8, 32, or 64 [[wikipedia:IBM Systems Network Architecture#Logical Unit (LU)\|LU]]-sessions for version 1.1
	** 10, 35, or 70 users for version 2.0.1		** 10, 35, or 70 users for version 2.0.1
	* ''Gateway Client''<ref>Designated ''GC'' in product descriptions.</ref> for 3270 and 5250 terminal services, as well as printing services.		* ''Gateway Client''<ref>Designated ''GC'' in product descriptions.</ref> for 3270 and 5250 terminal services, as well as printing services.
Line 23:		Line 23:

	== General overview ==		== General overview ==
	The ''SNA•ps Gateway'' makes resources provided by the mainframe or the AS/400 via [~~https~~:~~//en.wikipedia.org/wiki/IBM_Systems_Network_Architecture~~#~~Physical_Unit_.28PU.29~~ SNA PUs]/LUs or [~~https~~:~~//en.wikipedia.org/wiki/IBM_Advanced_Peer~~-to-~~Peer_Networking~~ APPN]/[~~https~~:~~//en.wikipedia.org/wiki/IBM_Advanced_Program~~-to-~~Program_Communication~~ APPC] available to AppleTalk connected Macs. This means that an (expensive) card for connecting to the mainframe does not have to be installed in every Mac, but one can be shared by many users. Also, adding such a card is not possible in some cases: Compact Macs like the Mac Plus or Mac SE have no or only limited expansion options. In addition, the required network cabling may not exist.		The ''SNA•ps Gateway'' makes resources provided by the mainframe or the AS/400 via [[wikipedia:Systems Network Architecture#Physical Unit (PU)\|SNA PUs]]/LUs or [[wikipedia:IBM Advanced Peer-to-Peer Networking\|APPN]]/[[wikipedia:IBM Advanced Program-to-Program Communication\|APPC]] available to AppleTalk connected Macs. This means that an (expensive) card for connecting to the mainframe does not have to be installed in every Mac, but one can be shared by many users. Also, adding such a card is not possible in some cases: Compact Macs like the Mac Plus or Mac SE have no or only limited expansion options. In addition, the required network cabling may not exist.

	Examples of clients are the terminal emulations [~~https~~:~~//en.wikipedia.org/wiki/IBM_3270~~ 3270], and [~~https~~:~~//en.wikipedia.org/wiki/IBM_5250~~ 5250]). These allow Macs that are connected to the [~~https~~:~~//en.wikipedia.org/wiki/~~AppleTalk AppleTalk] network (e. g. via [~~https~~:~~//en.wikipedia.org/wiki/~~LocalTalk LocalTalk]) to establish terminal sessions to a SNA host.		Examples of clients are the terminal emulations [[wikipedia:IBM 3270\|3270]], and [[wikipedia:IBM 5250\|5250]]). These allow Macs that are connected to the [[[wikipedia:AppleTalk\|AppleTalk]] network (e. g. via [[wikipedia:LocalTalk\|LocalTalk]]) to establish terminal sessions to a SNA host.

	An example of reverse direction is printing support. The ''SNA•ps Print'' client emulates an IBM 8312 printer. Print jobs spooled into a printer queue on the AS/400 are picked up by ''SNA•ps Print'', to be printed using the default (AppleTalk) printer, set in the [~~https~~:~~//en.wikipedia.org/wiki/Chooser_~~(Mac_OS) Chooser], or saved as text in a file.<br>		An example of reverse direction is printing support. The ''SNA•ps Print'' client emulates an IBM 8312 printer. Print jobs spooled into a printer queue on the AS/400 are picked up by ''SNA•ps Print'', to be printed using the default (AppleTalk) printer, set in the [[wikipedia:Chooser (Mac_OS)\|Chooser]], or saved as text in a file.<br>
	This was a way of making the Apple [~~https~~:~~//en.wikipedia.org/wiki/~~LaserWriter LaserWriter] usable from midrange, and indirectly from mainframe computers. The LaserWriter was very expensive at its introduction time.		This was a way of making the Apple [[wikipedia:LaserWriter\|LaserWriter]] usable from midrange, and indirectly from mainframe computers. The LaserWriter was very expensive at its introduction time.

	The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [~~https~~:~~//en.wikipedia.org/wiki/Database_abstraction_layer~~ DAL] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).		The counterpart to the ''SNA•ps Gateway'' is a system extension called ''SNA•ps Access''. Client applications use API routines provided by this extension. The SNA•ps API can also be used by third parties; examples have been published by Apple through their developer CDs. An example of this is [[wikipedia:Database abstraction layer\|DAL]] for the Macintosh. It can utilize several ways to connect to the actual database; such as IP (via MacTCP) and SNA (via SNA•ps Access).

	In the 1990s, IBM made LocalTalk add-on cards for the older AS/400's SPD slots, and released additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded roughly to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400. It was only meant to provide display and print functions instead of full APPC capabilities, though. This enabled Macs to function as a console device to the AS/400, but made it impossible to use APPC based services, such as DAL, over the integrated LocalTalk connection.		In the 1990s, IBM made LocalTalk add-on cards for the older AS/400's SPD slots, and released additional software for OS/400 to implement the AppleTalk protocol stack on the AS/400 as well. The implementation on the AS/400 corresponded roughly to the SNA•ps gateway, so that no Mac was required as a gateway: the necessary software ran only on the AS/400. It was only meant to provide display and print functions instead of full APPC capabilities, though. This enabled Macs to function as a console device to the AS/400, but made it impossible to use APPC based services, such as DAL, over the integrated LocalTalk connection.