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


TERMSESS macroinstruction

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

The TERMSESS macroinstruction terminates sessions in which the application program acts as the SLU.

The RPL OPTCD operand specifies the type of session termination desired by the application program:
  • OPTCD=COND causes a Terminate Orderly request to be sent to the SSCP.
  • OPTCD=UNCOND causes a Terminate Forced request to be sent to the SSCP.
  • OPTCD=UNBIND causes an UNBIND to be sent to the PLU.
  • OPTCD=TERMQ causes a Terminate Forced request to be sent to the SSCP for a queued or pending active session.

When it receives an UNBIND in its SCIP exit routine or a CLEANUP in its NSEXIT exit routine, VTAM® notifies the application program that the session ends. Otherwise, if you specify OPTCD=UNBIND, VTAM directly ends the session by sending an UNBIND to the PLU.

The scope of a TERMSESS is the set of sessions terminated. The TERMSESS macroinstruction uses the RPL, and optionally, an NIB to identify the scope of the TERMSESS. If no NIB is supplied, then the RPLARG field contains a CID which uniquely identifies the session to be terminated. If there is an NIB, then the NIBCID field is checked. The NIBCID field is used only if PARSESS=YES is coded on the APPL definition statement. If the NIBCID field is not 0, it uniquely identifies the session to be terminated. If the NIBCID field is 0, the scope of the TERMSESS is all the sessions in which the application program issuing TERMSESS is the SLU, and the network-qualified name of the PLU named in NIBSYM and the NIBNET field if PARMS=(NQNAMES=YES) is specified on the ACB macroinstruction. If PARMS=(NQNAMES=NO) is specified on the ACB macroinstruction or if PARMS=(NQNAMES) is not specified, all sessions to the PLU or PLUs specified in NIBSYM are to be terminated. In other words, if this application program is in session with multiple LUs with the same name in separate networks, all sessions are terminated.

Note:
  1. OPTCD=COND has no effect if the PLU is an independent LU.
  2. Under some network outage conditions, the SSCP cannot cause the sending of a CTERM Forced to the PLU; under these conditions, the SSCP treats the Terminate Forced as if it had been Terminate Cleanup. See Stages of session termination for a description of the actions that result from these types of terminations.
  3. LU 6.2 sessions maintained by VTAM LU 6.2 support (APPC=YES on the APPL definition statement) are unaffected by this macroinstruction.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014