Restrictions
- This macro may not be used during task/address space termination.
- Only a single connection is allowed to be active for a given address
space at any given time.
- Specification of both Queue_Manager=Yes, and Server_Manager=Yes
requires that Server_Type=Queue. Specification of Server_Type=Routing
is rejected.
- Specification of both Router=Yes, and Server_Manager=Yes requires
that Server_Type=Routing. Specification of Server_Type=Queue is rejected.
- If the callers recovery routine should get control as a result
of requesting this service, the function cannot be guaranteed to be
complete. It is possible that a token has been saved in the parameter
list where the connect token would reside upon successful completion.
This token may be passed to IWMDISC to prevent the address space from
being disabled from future IWMCONN requests, but the token should
not be used for other services. IWMDISC in these circumstances may
give a warning return code indicating that no connection was established,
however.
- If the key specified on IWMCONN is a user key (8-F) or SERVER_MANAGER=YES
was specified, then the caller must be in non-cross-memory mode (P=S=H).
- While not a restriction for IWMCONN, it should be noted that when
the key specified is a user key (8-F), the Connect token may only
be passed to IWMCLSFY, IWMRPT, or IWMMNTFY services, when the current
primary matches primary at the time IWMCONN is invoked.
|