Set session limits to zero:
>>-MODIFY-- --procname--,--DEFINE--,--ID--=--appl_name---------->
>--,--DLIMITS--=--(--0--,--0--,--0--)--------------------------->
>--,--LOGMODE--=--logon_mode_name--,--LUNAME--=--lu_name-------->
>--+------------------------------------------+----------------->
'-,--AUTOSES--=--number_of_winner_sessions-'
.-,--DELETE--=--NALLOW-----.
>--+--------------------------+--------------------------------->
'-,--DELETE--=--+-ALLOW--+-'
'-NALLOW-'
>--+---------------------------+-------------------------------->
'-,--DDRAINL--=--+-ALLOW--+-'
'-NALLOW-'
>--+--------------------------+--------------------------------><
'-,--DRESPL--=--+-ALLOW--+-'
'-NALLOW-'
Set session limits to nonzero:
>>-MODIFY-- --procname--,--DEFINE--,--ID--=--appl_name---------->
>--,--DLIMITS--=--(--dseslim--,--dminwinl--,--dminwinr--)------->
>--,--LOGMODE--=--logon_mode_name--,--LUNAME--=--lu_name-------->
>--+------------------------------------------+----------------->
'-,--AUTOSES--=--number_of_winner_sessions-'
.-,--DELETE--=--NALLOW-----.
>--+--------------------------+--+--------------------------+--><
'-,--DELETE--=--+-ALLOW--+-' '-,--DRESPL--=--+-ALLOW--+-'
'-NALLOW-' '-NALLOW-'
Use existing session limits:
>>-MODIFY-- --procname--,--DEFINE--,--ID--=--appl_name---------->
>--,--LOGMODE--=--logon_mode_name--,--LUNAME--=--lu_name-------->
>--+------------------------------------------+----------------->
'-,--AUTOSES--=--number_of_winner_sessions-'
.-,--DELETE--=--NALLOW-----.
>--+--------------------------+--+--------------------------+--><
'-,--DELETE--=--+-ALLOW--+-' '-,--DRESPL--=--+-ALLOW--+-'
'-NALLOW-' '-NALLOW-'
Delete an unusable LU-mode entry:
>>-MODIFY-- --procname--,--DEFINE--,--ID--=--appl_name---------->
>--,--LUNAME--=--lu_name--,--DELETE--=--UNUSE------------------><
Abbreviations
Operand |
Abbreviation |
MODIFY |
F |
AUTOSES |
AUTO |
DELETE=ALLOW |
DELETE=A or DEL=ALLOW or DEL=A |
DELETE=NALLOW |
DELETE=N or DEL=NALLOW or DEL=N |
DELETE=UNUSE |
DELETE=U or DEL=UNUSE or DEL=U |
DDRAINL=ALLOW |
DDRAINL=A or DDRL=ALLOW or DDRL=A |
DDRAINL=NALLOW |
DDRAINL=N or DDRL=NALLOW or DDRL=N |
DRESPL=ALLOW |
DRESPL=A or DRSP=ALLOW or DRSP=A |
DRESPL=NALLOW |
DRESPL=N or DRSP=NALLOW or DRSP=N |
LOGMODE |
LOG |
LUNAME |
LU |
Purpose
The MODIFY DEFINE
command establishes new entries, modifies existing entries, or deletes
unusable entries in the LU-mode table for the specified application
program. The
DEFINE values stored in the LU-mode table are used when VTAM® processes a CNOS transaction originated
by the partner LU or when a CNOS request is issued from the application
program (local LU) without a CNOS structure.
When VTAM receives the MODIFY DEFINE command, it
overlays the existing entry with the values specified.
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 statement
of the application program 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.
- AUTOSES=number_of_winner_sessions
- Specifies the number of contention-winner sessions to activate
automatically, rather than by allocation requests from the application
program. The
valid range is 0–32767. If AUTOSES is not coded on the APPL
statement, the default is zero.
- DDRAINL
- Specifies whether the source side can drain its allocation requests
when the application program is a target of a CNOS request that resets
the session limits to zero. This operand is valid only
if the session limits are being reset to zero.
- DDRAINL=ALLOW
- Specifies that the application program is allowed to drain its
allocation requests when the application program is the target of
a CNOS request that resets the session limits to zero.
- DDRAINL=NALLOW
- Specifies that the application program is not allowed to drain
its allocation requests.
- DELETE
- Specifies whether a mode name entry can be deleted from the LU-mode
table.
- DELETE=ALLOW
- Specifies that a mode name entry can be deleted from the LU-mode
table.
- DELETE=NALLOW
- Specifies that a mode name entry cannot be deleted from the LU-mode
table.
- DELETE=UNUSE
- Specifies that an unusable mode name entry is to be deleted from
the LU-mode table.
Note: DELETE=UNUSE is valid only for applications
programs defined with OPERCNOS=ALLOW and APPC=YES on the APPL definition
statement in the application program major node.
- DLIMITS=(dseslim,dminwinl,dminwinr)
- Specifies the negotiation limits that are allowed between the
source side and target side. If DLIMITS is not coded on the APPL statement,
the default is (2,1,1).
- dseslim
- Specifies the maximum number of sessions between the source side
and the target side. This number applies uniquely to each logon mode
name for which sessions can be established with a partner LU. The
valid range is 0–32767.
- dminwinl
- Specifies the minimum number of parallel sessions for which the
source side is guaranteed to be the contention winner. This number
applies uniquely to each logon mode name for which sessions can be
established with a partner LU. The valid range is 0–32767.
- dminwinr
- Specifies the minimum number of parallel sessions for which the
partner LU is guaranteed to be the contention winner. This number
applies uniquely to each logon mode name for which sessions might
be established with a partner LU. The valid range is 0–32767.
- DRESPL
- Specifies whether the LU is allowed to assume responsibility for
deactivating sessions if a CNOS request is received identifying the
LU as the responsible LU.
- DRESPL=ALLOW
- Specifies that VTAM accepts
a CNOS request specifying that the LU is responsible for deactivating
sessions.
- DRESPL=NALLOW
- Specifies that VTAM does
not accept a CNOS request specifying that the LU is responsible for
deactivating sessions.
- ID=appl_name
- Specifies the name of the LU 6.2 application program to which
the command applies. appl_name cannot
be a network-qualified name.
- LOGMODE=logon_mode_name
- Specifies the name of the logon mode entry for which session limit
and contention-winner polarity values are to be changed. The
SNASVCMG LOGMODE name is not allowed in the operand. The SNASVCMG
LOGMODE is managed internally by VTAM.
- 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.