NIB LOGMODE and BNDAREA operands

The NIB LOGMODE and BNDAREA operands are used with a number of macroinstructions to specify, directly or indirectly, a set of session parameters. The following text and Table 1 through Table 5 show how these operands are used for each macroinstruction.

Table 1. Determining session parameters for an INQUIRE macroinstruction
NIB specifies LOGMODE=	NIB specifies BNDAREA=	INQUIRE OPTCD=SESSPARM issued for an LU in the same domain	A different domain
0	Reserved	The session parameters associated with a queued CINIT are placed in the RPL's AREA field. See the INQUIRE macroinstruction (OPTCD=SESSPARM) for a description of when queued CINIT is used.	Same as same domain
C' '	Reserved	The default session parameters associated with the LU are placed in the RPL's AREA field.	Option not valid
Logon mode name	Reserved	The session parameters associated with the specified logon mode name are placed in the RPL's AREA field.	Option not valid

Table 2. Determining session parameters for an OPNDST OPTCD=ACCEPT macroinstruction
NIB specifies LOGMODE=	NIB specifies BNDAREA=	OPNDST OPTCD=ACCEPT issued for an LU in the same domain	A different domain
0	0	The session parameters associated with a queued CINIT are used. See the OPNDST OPTCD=ACCEPT macroinstruction for a description of which queued CINIT is used.	Same as same domain
C' '	0	The default session parameters associated with the LU are used.	Option not valid
Logon mode name	0	The session parameters associated with the specified logon mode name are used.	Option not valid
Reserved	ISTDBIND area address	The session parameters associated with the specified BIND area are used.	Same as same domain
Note: In all uses of OPNDST OPTCD=ACCEPT, the class-of-service parameters specified in the queued CINIT are used.

Table 3. Determining session parameters for an OPNDST OPTCD=ACQUIRE macroinstruction
NIB specifies LOGMODE=	NIB specifies BNDAREA=	OPNDST OPTCD=ACQUIRE issued for an LU in the same domain or in a different domain
0	0	The default session parameters and class-of-service name associated with the LU are used.
C' '	0	Same as specifying LOGMODE=0 and BNDAREA=0.
Logon mode name	0	The session parameters and class-of-service name associated with the specified logon mode name are used.
Any of the preceding	ISTDBIND area address	The session parameters associated with the specified BIND area are used. The class-of-service parameters used are those associated with the default logon mode name.

Table 4. Determining session parameters for a SIMLOGON or CLSDST OPTCD=PASS macroinstruction
NIB specifies LOGMODE=	NIB specifies BNDAREA=	SIMLOGON or CLSDST OPTCD=PASS issued for an LU in the same domain or in a different domain
0	Reserved	The default session parameters associated with the LU are used.
C' '	Reserved	Same as specifying LOGMODE=0 and BNDAREA=0.
Logon mode name	Reserved	The session parameters associated with the specified logon mode name are used.

Table 5. Determining session parameters for a REQSESS macroinstruction
NIB specifies LOGMODE=	NIB specifies BNDAREA=	REQSESS issued for an application program in the same domain or in a different domain
0	Reserved	The default session parameters associated with the application program issuing the REQSESS macroinstruction are used.¹
C' '	Reserved	Same as specifying LOGMODE=0 and BNDAREA=0.
Logon mode name	Reserved	The session parameters associated with the specified logon mode are used.
Note: The logon mode name and session parameters are associated with the application program that issued the REQSESS macroinstruction (the SLU) and not the LU named in the NIB (the PLU).

When used by the INQUIRE OPTCD=SESSPARM macroinstruction:

LOGMODE=0 indicates that VTAM® is to take the session parameters associated with a queued CINIT (including any user data field, if present) and place them in the field pointed to by the AREA field of the RPL. The AREALEN field of the RPL must specify the length of AREA. If CINIT is not queued, (RTNCD,FDB2)=(X'14',X'4C') is set.
LOGMODE=C' ' indicates to VTAM that the default session parameters for the LU are to be returned in the field pointed to by the AREA field. The AREALEN field of the RPL must specify the length of AREA. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.
LOGMODE=logon mode name indicates to VTAM the logon mode name with which it is to search the logon mode table defined for the LU named in the NIB. If a match is found, the session parameters are returned in the field pointed by the AREA field of the RPL. The AREALEN field of the RPL must specify the length of AREA. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.

Note: For details on the use of the NIBSYM and NIBCID fields, see the OPTCD=SESSPARM parameter in the INQUIRE macroinstruction description in INQUIRE—Obtain logical unit information or application program status.

When used by the OPNDST OPTCD=ACCEPT macroinstruction:

LOGMODE=0 and BNDAREA=0 indicate that VTAM is to take the session parameters from a queued CINIT and construct a BIND request that is sent to the LU. If CINIT is not queued, (RTNCD,FDB2)=(X'14',X'4C') is set.
LOGMODE=C' ' and BNDAREA=0 indicate that VTAM is to take the default session parameters for the LU named in the NIB and construct a BIND request that is sent to the LU. If CINIT is not queued, (RTNCD,FDB2)=(X'14',X'4C') is set.
LOGMODE=logon mode name and BNDAREA=0 indicate to VTAM the logon mode name with which it is to search the logon mode table defined for the LU named in the NIB. The LU must be in the same domain as the application program that issued the OPNDST macroinstruction. If a match is found, the session parameters associated with that logon mode name are used to construct a BIND request that is sent to the LU. If a match is not found, or if the LU is in another domain, (RTNCD,FDB2)=(X'14',X'4B') is set, or if CINIT is not queued, (RTNCD,FDB2)=(X'14',X'4C') is set.
LOGMODE=0 or C' ' or logon mode name and BNDAREA=BIND area address indicate that the session parameters in the specified BIND area are to be used to construct the BIND request. If CINIT is not queued, (RTNCD,FDB2)=(X'14',X'4C') is set.
In all cases, the class-of-service parameters used are those specified in the queued CINIT.

When used by the OPNDST OPTCD=ACQUIRE macroinstruction:

LOGMODE=0 or C' ' and BNDAREA=0 indicate to VTAM that default session parameters and the associated class-of-service parameters (defined for the LU named in the NIB) are to be used to construct the BIND, which is sent to the LU.
LOGMODE=logon mode name and BNDAREA=0 indicate to VTAM the logon mode name with which it is to search the logon mode table defined for the LU named in the NIB. If a match is found, the session parameters and class-of-service parameters associated with that logon mode name are used to construct a BIND, which is sent to the LU. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.
LOGMODE=0 or C' ' or logon mode name and BNDAREA=BIND area address indicate that the session parameters in the specified BIND area are to be used to construct the BIND. The class-of-service parameters used are those associated with the default logon mode name.

When used by the SIMLOGON or CLSDST OPTCD=PASS macroinstruction:

LOGMODE=0 or C' ' indicates to VTAM that the default session parameters and associated class-of-service parameters for the LU are to be used as part of the CINIT that eventually results from the request. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.
LOGMODE=logon mode name indicates to VTAM the logon mode name with which it is to search the logon mode table for the LU named in the NIB. If a match is found, the session parameters and class-of-service parameters associated with that logon mode name are to be used as part of the resulting CINIT. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.

When used by a REQSESS macroinstruction:

LOGMODE=0 or C' ' indicates to VTAM that the default session parameters and associated class-of-service parameters for the application program issuing REQSESS are to be used as a part of the CINIT that eventually results from the REQSESS macroinstruction. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.
LOGMODE=logon mode name indicates to VTAM the logon mode name with which it is to search the logon mode table for the application program that issued the REQSESS macroinstruction. If a match is found, the session parameters and class-of-service parameters associated with that logon mode name are to be used as part of the resulting CINIT. If a match is not found, (RTNCD,FDB2)=(X'14',X'4B') is set.