z/OS Communications Server: SNA Programming
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Accepting and establishing a single pending active session

z/OS Communications Server: SNA Programming
SC27-3674-00

OPNDST OPTCD=ACCEPT is used to accept a single pending active session in which the application program acts as the PLU, and thus establishes an active session without regard to the source of the pending active session. The application program is notified of a pending active session in its LOGON exit routine, if available, or by the completion of a queued OPTCD=ACCEPT that was waiting for a pending active session to accept. If the LOGON exit routine is available, the CINIT is included with the input parameters.

The RPL and the NIB identify which pending active session to accept. If OPTCD=ANY is specified in the RPL, the oldest pending active session is accepted. If OPTCD=SPEC is specified, the NIB identifies the pending active session. If the application program supports parallel sessions (PARSESS=YES is coded on the APPL definition statement), and the NIBCID field is not 0, the pending active session identified by the CID is accepted. (The CID can be obtained from the LOGON exit parameter list.) If the NIBCID field is 0, or the application program does not support parallel sessions, the oldest pending active session between the application program and the LU named in the NIBSYM field is accepted.

If network-qualified names are used, the NETID field in the NIB (NIBNET) is used with NIBSYM to locate a network-qualified LU. If the SIMLOGON specifies a network-qualified name, the corresponding OPNDST OPTCD=ACCEPT should also specify a network-qualified name.

If the specified pending active session does not exist, action is dependent on the RPL queuing option. If OPTCD=NQ is specified, the OPNDST is rejected with (RTNCD,FDB2)=(X'00',X'09'). If OPTCD=Q is specified, OPNDST processing is suspended until a pending active session that can be accepted is created. If OPTCD=ANY is specified in the RPL, OPNDST waits for the first pending active session to be created. If OPTCD=SPEC is specified in the RPL, OPNDST waits for a pending active session with the LU identified in the NIBSYM field. In this case, the setting of the NIBCID field is ignored. Because the CID is assigned arbitrarily, it is not necessary to wait for a pending active session with a particular CID.

Once the application program identifies the pending active session to be accepted, a BIND request is sent from the application program to the SLU to establish the session. The BIND request carries the session parameters used to establish the protocols to be used for the session. See BIND request for more information. If the SLU wants to go into session, it sends a positive response to the BIND; the session is established and OPNDST is posted complete. If the session cannot be established (for example, the SLU rejects the BIND request, or the path between the application program and the SLU is lost), OPNDST is posted complete indicating this exception condition with, for example, (RTNCD,FDB2)=(X'10',X'01').

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014