Specifying Service TP Names
- This function is only supported for Communications Server SNA API clients.
You must use special conventions when specifying a service transaction program name with the CMSTPN and CMSLTP functions. Usually, you specify standard TPs with the CPI-C functions. Service transaction programs are specialized transaction programs that provide common network and system services to other programs or users. Examples of service transaction programs include scheduler programs, directory services, and spoolers.
The conventions for specifying a service transaction program name
with the CMSTPN and CMSL transaction program functions are
- Specify the name with from two to five bytes of ASCII characters.
- Specify the first byte of the name, for example, 0x23, with two
bytes of ASCII characters.
- Split the first byte of the name into two nibbles, for example, 2 and 3, and specify them in the low- order nibble of each ASCII byte.
- Set the high-order nibble of each ASCII byte to 1, which indicates that you are specifying a service TP name. Continuing with the example, the first two bytes specified are 0x12 and 0x13.
- Specify the remaining zero to three bytes of the name as ASCII characters. For example, 007.