z/OS Communications Server: CMIP Services and Topology Agent Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Syntax for the subscription strings

z/OS Communications Server: CMIP Services and Topology Agent Guide
SC27-3646-00

The following strings relate to subscribing to associations:
  • ACF.Subscribe
  • ACF.UnSubscribe
  • ACF.SubscribeRsp
  • ACF.SubscribeMess
The syntax for each string is shown here. Notice that the same response string, ACF.SubscribeRsp, is used for both the ACF.Subscribe and the ACF.UnSubscribe strings. Zero on the ACF.SubscribeRsp string indicates success; nonzero response values are in C language header file (ACYAPHDH). For a distinguished name, either the full name or an abbreviated version can be used. The error code 803 indicates that the association does not exist.
Subscribe ::= CHOICE {
   ae-title     TitleType,
   association [2] IMPLICIT HandleType
   }
 
UnSubscribe ::= CHOICE {
   ae-title     TitleType,
   association [2] IMPLICIT HandleType
   }
 
TitleType ::= CHOICE {
   oi [0] IMPLICIT OBJECT IDENTIFIER
   dn [1] IMPLICIT DistinguishedName
   }
 
HandleType ::= PrintableString (SIZE(1..36))
When the state of an association changes and an application program has registered to receive notification of changes through the ACF.Subscribe string, an ACF.SubscribeMess string is sent to that application program:
SubscribeMess ::= SubscribeState

The ACF.SubscribeMess syntax does not include the handle of the association whose state has changed. That can be found in the src field of the string header.

In the list of ACF.SubscribeState values, the following values have meaning:
  • associated (means the association is established and running)
  • terminated (means the association is ended).
The idle state is a temporary initial state. The wait-a-.... states are transitional states. The wait-a-assoc-... states indicate that a new association is in the process of being established. The wait-a-rel-... states show that an existing association is in the process of being terminated.
SubscribeState ::= INTEGER {
   idle                      (0),
   wait-a-assoc-rsp          (1),
   wait-a-assoc-ind          (2),
   wait-a-assoc-cnf          (3),
   wait-a-rel-rsp            (4),
   wait-a-rel-cnf            (5),
   associated                (8),
   wait-a-rel-cnf-indicator  (9),
   wait-a-rel-rsp-responder  (10),
   terminated                (11)
   }

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014