Set session limits to zero for one logon mode: >>-MODIFY-- --procname--,--CNOS--,--ID--=--appl_name------------> >--,--LIMITS--=--(--0--,--0--,--0--)----------------------------> >--,--LOGMODE--=--logon_mode_name--,--LUNAME--=--lu_name--------> .-,--DRAINL--=--NO------. .-,--DRAINR--=--NO------. >--+-----------------------+--+-----------------------+---------> '-,--DRAINL--=--+-NO--+-' '-,--DRAINR--=--+-NO--+-' '-YES-' '-YES-' .-,--NBRMODE--=--ONE-. .-,--RESP--=--LOCAL------. >--+--------------------+--+------------------------+-----------> '-,--RESP--=--+-LOCAL--+-' '-REMOTE-' .-,--SNGSESLU--=--NO------. >--+-------------------------+--------------------------------->< '-,--SNGSESLU--=--+-NO--+-' '-YES-'
Abbreviations
| Operand | Abbreviation |
|---|---|
| MODIFY | F |
| CONVSECL=ALREADYV | CONVSECL=A or CSECL=ALREADYV or CSECL=A |
| CONVSECL=AVPV | CONVSECL=V or CSECL=AVPV or CSECL=V |
| CONVSECL=CONV | CONVSECL=C or CSECL=CONV or CSECL=C |
| CONVSECL=NONE | CONVSECL=N or CSECL=NONE or CSECL=N |
| CONVSECL=PERSISTV | CONVSECL=P or CSECL=PERSISTV or CSECL=P |
| DRAINL=NO | DRAINL=N or DRL=NO or DRL=N |
| DRAINL=YES | DRAINL=Y or DRL=YES or DRL=Y |
| DRAINR=NO | DRAINR=N or DRR=NO or DRR=N |
| DRAINR=YES | DRAINR=Y or DRR=YES or DRR=Y |
| LOGMODE | LOG |
| LUNAME | LU |
| NBRMODE=ALL | NBRMODE=A or NBM=ALL or NBM=A |
| NBRMODE=ONE | NBRMODE=O or NBM=ONE or NBM=O |
| RESP=LOCAL | RESP=L or RSP=LOCAL or RSP=L |
| RESP=REMOTE | RESP=R or RSP=REMOTE or RSP=R |
| SNGSESLU=NO | SNGSESLU=N or SNG=NO or SNG=N |
| SNGSESLU=YES | SNGSESLU=Y or SNG=YES or SNG=Y |
Purpose
The MODIFY CNOS (change number of sessions) command initiates a CNOS transaction with a partner LU for the specified application program.
Using this command, you can modify session limits, request a partner LU to drain its queue of allocation requests, or request a partner LU to be responsible for deactivating the session. The MODIFY CNOS command does the same thing as the APPCCMD CONTROL=OPRCNTL,QUALIFY=CNOS macro, which is described in the z/OS Communications Server: SNA Programmer's LU 6.2 Reference.
Note: For operands that are optional
and that do not have a default value, the default values used are
obtained from a value already established for the specified LU-mode
pair or from the APPL definition of the application specified.
Operands
- procname
- The procedure name for the command. If procname in
the START command was specified as startname.ident,
where startname is the VTAM® start procedure and ident is
the optional identifier, either startname.ident or ident
can be specified for procname.
If procname in the START command was startname, startname must be specified for procname.
- CONVSECL
- Specifies the conversation security level that the local LU accepts.
The CONVSECL field is used only for a CNOS request that initializes session limits to a non-zero value for a partner LU. Subsequent CNOS requests for the same partner LU ignore this setting.
There are four sources for CONVSECL:- Security manager profile
- CNOS
- User BIND
- SECACPT operand on APPL definition statement
The order of this list indicates the selection hierarchy if no security manager profile is provided. If a security manager profile exists, the value in that profile sets the upper limit of conversation-level security that can be specified by the other three sources. If no security manager profile exists, the value in the CNOS takes precedence over any other sources of conversation security level. If no value was specified in the CNOS, and a user BIND is provided, then the value from the BIND is used.
If no conversation-level security value is available in either the CNOS or user BIND, then the default that is used is derived from the SECACPT parameter on the APPL statement.- CONVSECL=NONE
- Indicates that the LU does not accept conversation-level security (FMH-5s that include security subfields).
- CONVSECL=CONV
- Indicates that the LU accepts conversation-level security (FMH-5s that include security subfields).
- CONVSECL=ALREADYV
- Indicates that the LU accepts conversation-level security (FMH-5s that include security subfields) and that the application program accepts the "already verified" indicator on conversation requests it receives from the partner LU.
- CONVSECL=PERSISTV
- Indicates that the LU supports conversation-level security (FMH-5s that include security subfields) and accepts the "persistent verification" indicators on conversation requests it receives from the partner LU.
- CONVSECL=AVPV
- Indicates that the LU supports conversation-level security (FMH-5s that include security subfields) and accepts both the "persistent verification" indicators and the "already verified" indicator on conversation requests it receives from the partner LU.
- DRAINL
- Specifies whether the source side can drain its allocation requests. This
operand is valid only if the session limits are being reset to zero.
- DRAINL=YES
- Specifies that the source side can drain its allocation requests.
- DRAINL=NO
- Specifies that the source side cannot drain its allocation requests.
- DRAINR
- Specifies whether the target side can drain its allocation requests. This
operand is valid only if the session limits are being reset to zero.
- DRAINR=YES
- Specifies that the target side can drain its allocation requests.
- DRAINR=NO
- Specifies that the target side cannot drain its allocation requests.
- ID=appl_name
- Specifies the name of the LU 6.2 application program to which the change in the session limit and contention-winner polarity values apply. This value cannot be a network-qualified name.
- LIMITS=(sesslim,minwinl,minwinr)
- Overrides all other sources of session limits. VTAM performs negotiation if necessary.
- sesslim
- Specifies the maximum number of parallel sessions between the source side and the target side. It uses the logon mode name specified in the LOGMODE operand. The valid range is 0–32767.
- minwinl
- Specifies the minimum number of parallel sessions for which the source side is guaranteed to be the contention winner. It uses the logon mode name specified in the LOGMODE operand. The valid range is 0–32767.
- minwinr
- Specifies the minimum number of parallel sessions for which the partner LU is guaranteed to be the contention winner. It uses the logon mode name specified in the LOGMODE operand. The valid range is 0–32767.
- LOGMODE=logon_mode_name
- Specifies the name of the logon mode entry for which session limit and polarity values are to be changed. When NBRMODE=ONE is specified or assumed by default, LOGMODE is required. When NBRMODE=ALL is specified, LOGMODE is not needed, and it is ignored if you specify it.
- LUNAME=lu_name
- Specifies the name of the partner LU to which the change in the
session limit and contention-winner polarity values apply. The
name can be a network-qualified name in the form of netid.luname.
If lu_name is an ACB name, and the ACB name matches the name on the APPL definition statement, then you can use a network-qualified ACB name.
If PARMS=(NQNAMES=NO) is coded on the ACB macro, and a network-qualified name is specified, the network identifier is ignored.
If PARMS=(NQNAMES=YES) is coded on the ACB macro, luname must be a network-qualified name.
- NBRMODE
- Specifies whether the setting of the session limit and the contention-winner
polarity values applies only for the specified logon mode name or
for all logon mode names that apply to the partner LU.
- NBRMODE=ONE
- Specifies that the session limit and contention-winner polarity values for only the logon mode name specified in the LOGMODE operand are to be set.
- NBRMODE=ALL
- Specifies that the session limit and contention-winner polarity values for all logon mode names that apply to the partner LU are to be reset to zero, except for SNASVCMG, which remains unchanged. NBRMODE=ALL is valid only when LIMITS=(0,0,0) is specified.
- RESP
- Specifies which LU is responsible for deactivating the sessions
as a result of resetting the session limit or for changing the contention-winner
polarity values for parallel session connections.
- RESP=LOCAL
- Specifies the local LU is responsible for deactivating the sessions as a result of resetting the session limit or changing the contention-winner polarity values for parallel session connections.
- RESP=REMOTE
- Specifies the remote LU is responsible for deactivating the sessions as a result of resetting the session limit or changing the contention-winner polarity values for parallel session connections.
- SNGSESLU
- Specifies whether the partner LU is a single-session LU, which
does not support parallel sessions. VTAM uses
the value specified on this operand to determine the indication of
parallel-session support and CNOS support it specifies in the BIND
requests. This operand is examined by VTAM only
when the partner LU parallel-session capability has not been established.
- SNGSESLU=YES
- Specifies that the partner LU is a single-session LU which does not support parallel sessions.
- SNGSESLU=NO
- Specifies that the partner LU supports parallel sessions.