(Page 5 of 35 in this chapter)
TxX25FileFacility
Description
- Sets up certain optional Facilities parameters of a file definition packet.
Prototype
- short TxX25FileFacility (TXMNGPKT *req,
unsigned long facilities,
char *nui )
- req Pointer to packet to be set.
- facilities Facility bit definitions (long with
#define statements logically OR'ed together).
- nui Pointer to Network User ID (null term ASCII string used with certain Facility options).
Return Values
- TX API completion code.
Details
- TxX25FileFacility only affects options in the Define file packet. TxX25FileFacility assumes that the packet is already a properly initialized Define File packet. Applications should call TxX25FileDefault and TxX25FileDefine some time prior to calling TxX25FileFacility to assure that the packet contains all the proper default and required values. The fields set up by TxX25FileFacility call are part of a future file create request to be issued by the application.
- Applications should call TxX25FileFacility any time these parameters are to be adjusted for the File being defined.
- To easily set the facilities parameter, literals (
#define statements) are present in x25type.h in the form TXX25_FAC_xxxx where xxxx is the abbreviation for the facility. These usually should be OR'ed together with one of the literals for the default Facilities bits. Three aggregate literals define various defaults for the Facilities parameter: TXX25_FAC_UNSPECIFED, TXX25_FAC_SPECIFY, and TXX25_FAC_DEFAULT. TXX25_FAC_UNSPECIFED sets TRUE all (SVCI) type facilities that we support but are not configurable in some other user interfaces.
- Facilities #
#define statements are commented 1- in the header file. This allows changing those interfaces to allow/disallow them without changing the task or the generic API functions. TXX25_FAC_SPECIFY sets TRUE all facilities that we fully support and normally default TRUE. These two sets are combined in the literal TXX25_FAC_DEFAULT, which defines the bits defaulted by TxX25FileDefault.
- The application can modify Facilities without affecting them by OR'ing into one of these default facility literals, or it can turn these off selectively.
See Also
- TxX25FileDefault
(Page 5 of 35 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.